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

[2.x] Clean up the navigation and sidebar documentation #1838

Merged

Conversation

caendesilva
Copy link
Member

Part of #1818

@caendesilva caendesilva mentioned this pull request Jul 12, 2024
4 tasks
Copy link

codecov bot commented Jul 12, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Please upload report for BASE (unify-the-navigation-api@d44d2a3). Learn more about missing BASE report.

Additional details and impacted files
@@                     Coverage Diff                      @@
##             unify-the-navigation-api     #1838   +/-   ##
============================================================
  Coverage                            ?   100.00%           
  Complexity                          ?      1855           
============================================================
  Files                               ?       190           
  Lines                               ?      4909           
  Branches                            ?         0           
============================================================
  Hits                                ?      4909           
  Misses                              ?         0           
  Partials                            ?         0           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.


```yaml
navigation:
priority: 5
```

You can also change the order in the Docs configuration file. See [the chapter in the customization page](customization#navigation-menu--sidebar) for more details. <br>
_I personally think the config route is easier as it gives an instant overview, however the first way is nice as well._
You can also change the order in the `config/docs.php` configuration file, which may be easier to manage for larger sites. See [the chapter in the customization page](customization#navigation-menu--sidebar) for more details.
Copy link
Member Author

Choose a reason for hiding this comment

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

This chapter does no longer have this information:

Navigation Menu & Sidebar

A great time-saving feature of HydePHP is the automatic navigation menu and documentation sidebar generation.
Hyde is designed to automatically configure these menus for you based on the content you have in your project.

Still, you will likely want to customize some parts of these menus, and thankfully, Hyde makes it easy to do so.

Customizing the navigation menu

  • To customize the navigation menu, use the setting navigation.order in the hyde.php config.
  • When customizing the navigation menu, you should use the route key of the page.

Learn more in the Navigation Menu documentation.

Customizing the documentation sidebar

  • To customize the sidebar, use the setting sidebar.order in the docs.php config.
  • When customizing the sidebar, can use the route key, or just the page identifier of the page.

Learn more in the Documentation Pages documentation.

@caendesilva caendesilva marked this pull request as ready for review July 12, 2024 15:10
@caendesilva caendesilva merged commit 51edfbe into unify-the-navigation-api Jul 12, 2024
8 checks passed
@caendesilva caendesilva deleted the clean-up-the-navigation-documentation branch July 12, 2024 15:11
@caendesilva caendesilva changed the title Clean up the navigation and sidebar documentation [2.x] Clean up the navigation and sidebar documentation Jul 12, 2024
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.

1 participant