Build your own site

Copy the content of the ssg/docs/site directory to where you would like to locate your homepage and rename it to myhomepage or whatever directory name you fancy.

I would start git in this directory to achieve a flexible backup on the site with git init. A suitable .gitignore is already in the copied directory and may required adaptation.

Adapt the file ssg/docs/site/settings3.yaml minimallyFor more details

with a editor for program text files (i.e. not office) for:

• the location of folders, at least for

  • dough: the folder with the source of your site
  • baked: the foler where you expect the generated site (could be, for example, /var/web/ or ~/bakedhomepage)

• the port the server is using, when run ssgbake -s (default is 3001)The possible switches are - -s to start a server, - -q for quick, meaning not to produce pdf files, - -w to watch files changing and re-bake them automatically.
  
  

• menuitems: the first levell of subdirectories for the web page files.

After adaptation restart with ssgbake in the directory of your homepage and the homepage will be produced, adapted to your needs.

Customization is

• in the settings file, and in
• web page files in the subdirectories to the dough directory.

The example site in ssg/docs/site/dough contains examples for the settings file and for web pages with solutions for different uses, e.g. references to images, literature.

All easily customizable aspects are in files and no new compilation of ssg is neededRecompilation may be needed for new versions of ssg or new versions of compilers; it is recommended, but probably not required, to delete the baked website and rebuild it completely.

.

Under the dough directory you can include content, typically organized in subdirectories. Each web page corresponds to one file, including the files linking other files in subdirectories.