tomjoht / documentation-theme-jekyll

A Jekyll-based theme designed for documentation and help systems. See the link for detailed instructions on setting up and configuring everything.
http://idratherbewriting.com/documentation-theme-jekyll/
Other
1.17k stars 1.18k forks source link

how do I have a path for my side bar items? #137

Open rykr opened 6 years ago

rykr commented 6 years ago

Your sidebar.html seems to be removing "/" from my urls. I'm generating my content into a directory structure like /collections/overview/into.html and I want my sidebar menu to have lins like /overview/intro.html. Instead I get /overviewintro.html.

I can remove the "remove: "/"" lines from sidebar.html but is that the best way?

amzn-tomjoht commented 6 years ago

The remove logic is in the sidebar.html file. I initially implemented it like that to avoid path availability issues. Try removing that filter and see if you can get things working as you want.

tomjoht commented 5 years ago

In an upcoming version of the theme I will get rid of this logic.

laurlaurland commented 4 years ago

I am also trying to futz with the nav logic and have attempted to generate nav subfolders using in-page content anchors. Can't get it to work but I suspect it that messes with the Navgoco jquery for the nav state?

Am trying to publish a paper as a website without giving up some of the affordances of a paper format. Is it possible with just html and markdown?

` - title: 1. Introduction url: /introduction.html output: web, pdf folderitems:

     - title: 1.1  Outcomes
        url: /introduction.html#what_this_paper_will_help_you_achieve
        output: web, pdf
     - title: 1.2  Structure
       url: /introduction.html#how_this_paper_is_structured
       output: web, pdf`