Relatively new with Jekyll and have been searching all over the web for an answer to this, but have struck out.
I’m building software documentation, a manual and tutorials. I’ve structured the site so there’s one collection directory
_doc at site root. Within that dir are two dirs:
tutorial-1. Looks like this:
_docs/ product-manual/ 001-intro.md 002-first-section.md tutorial-1/ 001-intro.md 002-first-section.md
These will share almost all the same front matter, so in order to be DRY, I wanted to store that info in
_config.yml. I’ve tried 30 different ways, quadruple checked my YAML indentation (I have a love/hate relationship with YAML), tried values with and without quotes. Every time I edit the
config.yml I stop and restart the server. I don’t see any build errors post-restart.
I know the front matter settings work, as when I place them in the docs, I see all the styling from the theme. When I leave the docs with the double
--- at the top, the pages must be processed, as the markdown content is output as unstyled HTML output—but it is converted to HTML.
Could someone take a look and see what I might be doing wrong? (Unfortunately, this isn’t in a public repo.)
# Collections collections_dir: docs collections: product-manual: permalink: "/:collection/:path/" output: "true" tutorial-1: permalink: "/:collection/:path/" output: "true" # Defaults defaults: - scope: path: "" type: "posts" values: layout: "single" author_profile: false read_time: true comments: true share: true related: true - scope: path: "docs" type: "" values: layout: "single" author_profile: false read_time: true comments: # true share: false related: false sidebar: nav: "manual" toc: true
Thanks so much for having a look.