syndamiadotcom

Repository for my website.

The pages of the website are (mostly) written in Markdown. Using ssg and lowdown they are generated into a static website.

Contents of this repository

The src folder contains all of the website files, i.e. the pages, fonts, styles, images, etc.

install-ssg6-lowdown.sh is a shell script that installs both ssg and lowdown.

generate.sh is a shell script that automatically generates the website into a folder named "website".

About index.md files

In a lot of folder, the index.md files are just hard links of other files! For example, src/about/index.md is a hard link to src/about.html. Why? Because this way, web links are a lot shorter:

Old style link -> New style link

syndamia.com/about.html -> syndamia.com/about
syndamia.com/tutorials/how-to-use-jira/introduction.html -> syndamia.com/tutorials/how-to-use-jira/

Of course, the old style links are still available, but the website itself won't be using them during navigation.

List of hard links

In all multi-page articles (be it blog article or tutorial or etc.), introduction.md is the first page and index.md is a hard link to it. Single page articles are just titled index.md (it's not a hard link).

All links are relative to the src folder!