in-toto / in-toto.github.io

In-toto's website.
https://in-toto.io
MIT License
0 stars 8 forks source link

Cannot load `*.md` files, except for `index.md` #5

Closed vladimir-v-diaz closed 6 years ago

vladimir-v-diaz commented 6 years ago

The README states, "Adding content is as simple as creating .html, or .md files and filling them with content."

A index.md page can be loaded successfully, however, any other pages with a .md extension fail.

Interestingly, if a file contains Markdown content and you append a .html extension to its filename, it works.

vladimir-v-diaz commented 6 years ago

Interestingly, if a file contains Markdown content and you append a .html extension to its filename, it works.

Never mind, the Markdown content doesn't always render correctly by simply appending the .html extension.

What does seem to work consistently is having example.md and visiting http://127.0.0.1:4000/example.html.

lukpueh commented 6 years ago

Jekylls converts markdown files to html and stores the result with an .html file extension to the _site directory. Processing is performed as soon as you add yaml front matter to a file's header.

---
...
---

If there is no such header, the markdown file is just copied over to _site as is, without converting to html or changing the extension.

I can clarify they relevant section in the README (which btw. doesn't get copied to _site because it's excluded in _config.yml).