Molk.ch Project
These are the sources from which molk.ch is built using the custom molk.ch build.
This page explains the "how" of the design. For the "why", read About molk.ch.
Sources
The source repository is here: molk.ch repository.
A couple of entry points into the source tree:
- src/overview.html
- Provides an overview (with links) of examples and other bits and pieces.
- root ("src/")
- This is the base directory, under which all files necessary to generate the site are located. The contents of each subdirectory is described below.
- content
-
This is where the core content is located. The source pages are valid XHTML, but pure content - only the body is included in the final page. You only get to see the final layout after running the build, which encourages 1) focusing on the content when creating/updating pages, and 2) structuring the content flexibly. You have no control over the size of the reader's screen/browser window anyway, so this restriction does not make much of a difference, once you get used to it.
The subdirectories of content each represent a section of the site, and define the first level of navigation (tabs at the top of the page). The next level of subdirectories define the second level of navigation (Listed on the right above the icons). There are only two explicit levels of navigation - after that, pages just link to each other, and the breadcrumbs indicate where in the hierarchy a page is located.
Files directly under root are "utilities", pages that contain information about the site.
Images used in all pages are in content/images, e.g. the xhtml, css, and atom standard conformance certificate images.
- fragments
- This directory contains:
- .html-files, which are valid XHTML documents whose content will be included in all the content HTML files in the site. Usually, the contents of the body-element will be extracted, the exception being head.html, where the head-element is used.
- .tag-files, which are parts of XHTML documents, and hence, not always neither valid nor wellformed.
- style
- Each subdirectory represents a style for the site: Currently, a Firefox, Simple and a Print style exist.
Licence and copying permission
The molk.ch project is Copyright 2009, 2010 Morten Lauritsen Khodabocus, info@molk.ch.
It is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
See also the molk.ch Licence page. Kudos to the GNU Project and the Free Software Foundation for doing the heavy lifting, legalese-wise.