Main Secretchronicles website
This repository contains the main website of the Secretchronicles project, which is available under https://www.secretchronicles.org.
The site is completey static HTML, utilising the nanoc site generator. It is based on Ruby, so make sure you have Ruby (including RubyGems, if you are on a Debian-based Linux) installed.
First, install all necessary dependencies via RubyGems and Bundler. On a Debian system, install bundler via the repositories, then use it to install the gems for this project.
# apt install ruby-bundler $ cd /to/the/website/dir $ bundle install --path .gems
--path option to
bundler ensures that the gems are kept
logically separate from any system gems.
nanoc to compile and serve the site:
$ bundle exec nanoc compile $ bundle exec nanoc view
Browse to http://localhost:3000/en to view the main page in English. There is no language redirect functionality on the local site, this can only be added on an actual server.
Adding new content
On website, English pages are at /content/en and Finnish /content/fi. To create new news page, copy old to new name with correct date in filename. Ruby code lists files automatically, so newest news is first at website. All page design is at layouts dir for most pages. Images are at content/assets and CSS at content/stylesheets/default.css . nanoc generates static pages to output directory, that can be sent to webserver for test viewing at webtest subdomain with rsync. Rsync uses compression, deletes from server old files that are not at new version of website, and excludes robots.txt so it stays at server.
cd main-website/output rsync -avz --delete --exclude=robots.txt -e "ssh -p SSH-PORTNUMBER-HERE" . username@alexandria.DOMAIN-HERE.DOMAIN-SUFFIX-HERE-LIKE-ORG-ETC:/home/username/webtest/
Actual updating as official webpages alexandria server official webpages is with git, remember to also add other directories if you changed elsewhere than on content directory:
# Change to git repo directory cd main-website # Get latest changes from geite repo git pull # View local changed files git status # If you want to view source code changes git diff # Add new and modified files git add content/* # Commit locally git commit -a -m "News article about..." # Push to official repo git push
The changes will be installed to official server every midnight automatically by cron script at server. nanoc generates static content at webserver, output is visible at the official website.
For translating the site, simply translate all the pages below the
content/en directory into a new directoy
the 2-letter code for your target language. Note that when translating
news posts, you have to keep the file name exactly as it is in
English, only translate the file content. If you add your name to the
translator: header, it will be shown on the translated page.
Adding new avatars
The mailinglist web interface
pulls avatar images from the main website below the
path. This directory is not part of this repository; it is aliased to
the upload-avatar CGI service on
alexandria. Use that
service to upload avatars. It is entirely independant from this
Note: This license applies only to the sourcecode of the website. The content on the website itself is subject to different licensing.
Copyright (c) 2014-2019, TSC Team
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.