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.

Home Page:http://idratherbewriting.com/documentation-theme-jekyll/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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

rykr opened this issue · comments

commented

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?

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.

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

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`