Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Category Pages #202

Draft
wants to merge 4 commits into
base: main
Choose a base branch
from
Draft

Add Category Pages #202

wants to merge 4 commits into from

Conversation

tordona
Copy link
Contributor

@tordona tordona commented Jan 20, 2025

This is a draft to represent adding category pages to the site.

Issues

  • config.yml is getting large and increasingly difficult to edit properly
  • rendered page is becoming constrained with a few categories and very long to scroll / browse

Proposal

  • Break out services categories into separate yaml files
  • Add navbar items for each category
  • Limit changes to CSS, HTML, and Yaml files only

Proof of concept
This draft PR has a working PoC that breaks out the Web browser and Media categories. The categories were removed from config.yml and placed into respective web-browsers.yml and media.yml files.

Two links were added to represent the categories in the config.yml file. These can remain stationary in config.yml and don't need to be duplicated to each category yaml file. The added links are forced to a new line, to keep the top 4 links as Home FAQ Contribute and Resources

A few changes where added to the CSS to have flex wrapping. The forced new line after Resources is a little hacky, but it's keeping within the limitation of minimal changes.

Risks

  • caching of CSS file - Initial load of page with updated CSS may not take affect due to caching of CSS file and present improper rendering of menubar. This presented itself during local testing and may not be an issue with deployment

Screenshots
navbar-wrapping
category-only-view
category-only-view-columns

Homepage
The homepage could be updated to have a news feed, recently updated / added items, a "Popular" category or other. TBD

To-Do

  • Add links to each category
  • Move categories to separate files
  • Update how single column layouts look?
  • Update readme.md (How to add a new application to the list)
  • Re-minimize CSS file after dev complete
  • Determine what to serve on Homepage
  • low priority, fix hamburger menu layout of search bar in tablet width screens

@arminask
Copy link
Owner

I've also thought about changing the default column layout to reduce space. The separation of categories to different yml files is also a good idea. Though I doubt the search function in the main page will still work? All the PR suggestions are great, I'll have to think how to proceed with this PR.

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