Skip to content

Conversation

@cwhite911
Copy link
Contributor

@cwhite911 cwhite911 commented Jan 21, 2025

Synchronizing GRASS brand with Quarto

Updated PR Details

I've added a style guide partially as a way to check edge cases. Set it up locally you need to add an _environment.local file to the root of the project.

The file should include the following

PYTHONDEVMODE=1
QUARTO_PROFILE=local

Now when you run quarto preview the content in content/tests will render with the project.

quarto preview

Then navigate to local site at content/tests/styling.html

http://localhost:5753/content/tests/styling.html

Remember to update your port number

GRASS Quarto Design Guide

Orginial Info

I've added the _brand.yml file for us to use once we update Quarto to >=1.7

The formatting is close but still requires some additional tweaks.

@wenzeslaus wenzeslaus marked this pull request as draft March 18, 2025 20:13
@cwhite911
Copy link
Contributor Author

image

@cwhite911 cwhite911 marked this pull request as ready for review April 11, 2025 04:33
@cwhite911
Copy link
Contributor Author

cwhite911 commented Apr 11, 2025

image

@veroandreo
Copy link
Contributor

I liked the previous font better or something similar to that sort of simpler letters (I do not know how they are called); this one does not seem to align with GRASS website style nor with the font in our logo.

@cwhite911
Copy link
Contributor Author

I liked the previous font better or something similar to that sort of simpler letters (I do not know how they are called); this one does not seem to align with GRASS website style nor with the font in our logo.

The font issues was a bug in the config should be fixed now. Will post an update screenshot when I'm at my computer.

@cwhite911
Copy link
Contributor Author

I've added the start to a style guide partially as a way to check edge cases. Set it up locally you need to add an _environment.local file to the root of the project.

The file should include the following

PYTHONDEVMODE=1
QUARTO_PROFILE=local

Now when you run quarto preview the content in content/tests will render with the project.

quarto preview

Then navigate to local site at content/tests/styling.html

http://localhost:5753/content/tests/styling.html

Remember to update your port number

GRASS Quarto Design Guide

Screenshot 2025-05-06 at 22-16-27 GRASS Quarto Design Guide

@cwhite911
Copy link
Contributor Author

cwhite911 commented May 7, 2025

Here are some more screenshots.

Please ignore Team Documents and GRASS Quarto Design Guide in the All Tutorials section. They are only there because of the local environmental variables from _environment.local.

index

image

Getting started with GRASS

image

@cwhite911 cwhite911 changed the title Added brand file Brand synchronization May 7, 2025
Copy link
Contributor

@petrasovaa petrasovaa left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good! I am not sure I understand the plan with the Team Documents and the guide.

Also, I thought we decided on sentence case for headings, no?

Copy link
Contributor Author

@cwhite911 cwhite911 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@petrasovaa thanks for the feedback. I've addressed your comments. My todo is to remove the _freeze files, and I'll add a section to show the language selection tabs.

Copy link
Contributor

@veroandreo veroandreo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I didn´t test locally as I need to update quarto and all. So, I marked typos mostly. Indeed, I also thought we agreed on sentence case for titles.

Fixed typos.

Co-authored-by: Anna Petrasova <[email protected]>
Co-authored-by: Veronica Andreo <[email protected]>
Copy link
Contributor Author

@cwhite911 cwhite911 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I didn't know about the decision about title being sentence case. I will update the materials to reflect this.

@cwhite911
Copy link
Contributor Author

@veroandreo and @petrasovaa I've addressed your comments please take another look when you are able.

Design Guide Page

Screenshot 2025-05-12 at 12-38-22 GRASS Quarto Design Guide – (Local) Learn GRASS

Home Page

image

Tutorial Page

image

@petrasovaa
Copy link
Contributor

It looks nice! I would hide the guide from the front page, it's not really a guide, it shows qmd syntax. Maybe we could make it into a contributing guide, or link it from README.

@petrasovaa
Copy link
Contributor

BTW, there is some incosistency in headings - some of the headings (h2) are not bold in the screenshot, but they are bold when I render it locally. I like the bold ones. This needs to be corrected in the grass doc as well, they are not bold.

@cwhite911
Copy link
Contributor Author

It looks nice! I would hide the guide from the front page, it's not really a guide, it shows qmd syntax. Maybe we could make it into a contributing guide, or link it from README.

The guide isn't visible at the moment when running in production (aka built by gh-actions)

@petrasovaa petrasovaa merged commit 0235b2e into OSGeo:main May 13, 2025
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants