Project Sidebar Layout DemoLink to section
This page demonstrates the MarkdownLayout with the project sidebar enabled. Look to the left to see the project navigation!
About the SidebarLink to section
The project sidebar provides quick access to all git-pull projects, organized by category. It includes:
- VCS Python projects (vcspull, libvcs, g)
- tmux Python projects (tmuxp, libtmux)
- cihai projects (unihan-etl, cihai)
- Django utilities
- Documentation & testing tools
- Web projects
ConfigurationLink to section
Enable the project sidebar by adding to your frontmatter:
---showSidebar: true---Sidebar FeaturesLink to section
Project OrganizationLink to section
Projects are grouped by category with clear visual hierarchy. Parent projects can have child projects shown with a ”+” connector.
Interactive ElementsLink to section
Each project link:
- Opens in a new tab
- Shows the project favicon
- Has hover effects with scaling animation
- Includes proper accessibility attributes
Trigram LinkLink to section
Notice the “Why the 3 lines? ☰” link above the projects. This provides context about the site’s branding.
Use CasesLink to section
The sidebar is perfect for:
- Project documentation hubs
- Portfolio showcases
- Multi-project overviews
- Cross-project navigation
Responsive DesignLink to section
The sidebar is hidden on smaller screens (below lg breakpoint) to ensure content remains readable on mobile devices.
Combining with ToCLink to section
You can combine the project sidebar with a table of contents for maximum navigation options. This creates a three-column layout:
- Left: Project sidebar
- Center: Main content
- Right: Table of contents
This provides comprehensive navigation while keeping the content front and center.