Useful resources to introduce free software to beginners
2024-02-18 13:06:41 +08:00
content corrected wrong reference 2024-02-18 13:06:41 +08:00
template no need for markdown="1" 2024-02-05 14:10:50 +08:00
generate.sh init 2024-01-25 11:38:35 +08:00
README.md init 2024-01-25 11:38:35 +08:00

Notes for Webmasters

This site uses peaksol-org-ssg as its static site generator. User guide is available here.

Here is a quick reference for you to perform common operations to the site.

Creating a page

Create a .md file in contents/ and write whatever you want.

To use a custom title rather than the one automatically generated, start the file with:

---
{"title": "Lorem Ipsum"}
---

To add a licenses notice, end the file with:

---

This page is licensed under [CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/).

Editing navbar items

If you want a new directory to show up on the navbar, edit the JSON in content/index.md.

Static files

Static files can be placed in content/. If they are especially for web styling rather than the content, place them in template/assets/.

Generating the site

Edit generate.sh to choose the target directory. After that:

./generate.sh

Please note that running the script will remove all files in the out directory. Make sure you set the path correctly before you run the script. If you don't want to clean the directory before generation, just remove the --clean option.