created:2021-05-14
author:Foobär
top:README:Installation:Setting Up A New Web Site
sort:030
title:Setting up a new web site from the example template

<p>
The 'example' directory included in this package contains the complete source for a web site with a couple of pages, blog, a gallery and some other files. All of
the following steps are technically optional. Omitting one will simply mean that whatever you didn't set/change will stay as it was set for the example web site.
 
<li>Copy the 'example' directory to a suitable location, e.g. ~/my_website</li>
<li>Edit the 'settings' file to change your website's title, url/domain name, style template choice, default output directory, etc.</li>
<li>If you have not changed the default output directory, create a symlink called 'html' to point to your web root.</li>
<li>Edit the 'footer' file to include any HTML code that you want to be included at the bottom of every generated HTML page.</li>
<li>Edit or replace the logo.svg file with you web site's logo.</li>
<li>Place any other miscellaneous files needed by your web site in the 'files' directory.</li>
<li>Create or edit CSS files in the 'styles' directory according to your wishes. Which files are used is determined by the 'style=' setting in the settings file.</li>
<li>Create and/or edit files in the 'pages' directory for "static" web pages not related to a weblog.</li>
<li>Create blog entries in the 'entries' directory. You can use the 'genentry' script, write files from scratch or use a template file that you have filled with header lines that you regularly use.</li>
<li>Add galleries in the 'galleries' directory, one directory per gallery. Simplyt place JPEG and PNG files in these directories.</li>
<li>Run 'sbwg --complete' or 'sbwg -c' to create the HTML website in the default output directory with its default settings. Use the '-o'/'--output' option to specify a different output directory, e.g. for testing/a non-public preview.</li>
</p>
