Creating a Shackweb Document

Introduction

This document describes how to add new documents to this 'shackweb' collection.

Location, Location, Location

Ourshack web pages are located under the home directory of the shackweb user on Pig, that is /home/shackweb or ~shackweb for short.

The ~shackweb/websrc directory contains everything needed for building web pages.

• ~shackweb/websrc/src: source templates for web pages
• ~shackweb/websrc/lib: additional template components
• ~shackweb/websrc/html: output directory for generated HTML pages. This is Apache's DocumentDir, allowing you to access these web pages via the URL http://www.ourshack.com/
• ~shackweb/websrc/etc: contains a ttree.cfg config file which ttree uses to build the web pages through the Template Toolkit
• ~shackweb/websrc/xml: currently contains a faq.xml file containing an XML representation of the FAQ. This is used by ~websrc/src/faq.html to build the HTML version of the FAQ.

Adding a Page

$ sudo su - shackweb
$ cd websrc/src
$ vi mynewpage.html      # tap, tap, tap
$ ci -u mynewpage.html
$ ttree

Updating a Page

$ sudo su - shackweb
$ cd websrc/src
$ co -l oldpage.html
$ vi oldpage.html        # tap, tap, tap
$ ci -u oldpage.html
$ ttree