Seravo / docs

Documentation for Seravo.com customers and developers
https://seravo.com/docs/
15 stars 15 forks source link

Convert _posts to pages #59

Closed ottok closed 3 years ago

ottok commented 3 years ago

E.g. _posts/<date>_<pagename> to eg. category/something/feature.md

This would be a cleaner structure. Current date based blog stucture is useless in the seravo.com/docs documentation reference.

sjaks commented 3 years ago

So we would like to move from Jekyll posts to pages because posts have an unnecessary date attributes and messy filenames.

I have taken a deep look into a Jekyll "page" and whether it supports everything we currently have. They seem to but there are some things to take into consideration; docs currently rely on "post category" attribute and because pages cannot be assigned into a category, it's not possible to query for all pages in certain category. Also, more notably, URLs to pages are generated based with permalink: /:categories/:title/ and we want to keep this after the move to pages.

Jekyll collections promises to provide some level of collection of similar data into same place. This might work for this.