,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
kettek website
````````````````````````````````
This document describes the kettek site's aesthetic, organization, and setup.
,,,,,,,,,,,,,,,,,,,,,,,,
Aesthetic
````````````````````````
* KISS
* Clean
* Modern
* Whitespace
,,,,,,,,,,,,,,,,,,,,,,,,
Organization
````````````````````````
Pages are organized fairly freely, but generally fall into these categories:
* Aphorism
* Some short amount of philosophical text. These are used for the [[#Header]].href(#Header).
* Article
* Some longer article, usually pertaining to technical things, but not technical documentation
* Dox
* Technical-specific documentation, how-tos, etc.
* Projects
* Fully-formed projects that have:
* code repositories
* releases
* Lab
* Test stuff, usually incomplete
* Probably should have a code repository
,,,,,,,,,,,,,,,,,,,,,,,,
Appearance
````````````````````````
Top:
* large white area
* off-grey text with daily-selected(modulo) aphorism
Left:
* content area, (black?)
* top-left has name of area/page/breadcrumbs in faded background
Right:
* menu area, (gray?)
* has sections with links
* bottom has twitter/youtube/etc. links
,,,,,,,,,,,,,,,,,,,,,,,,
Setup
````````````````````````
The content of kettek is built using kettext files, some css, some javascript, a serving script, and a "build to live" script.
* build.sh -- bash script that creates a live instance of kettek
* index.php -- web-server script to serve kettek
* style.css -- our style
* javascript/ -- our javascript directory
* *.js
* source/
front.ktx -- front page
* aphorism/
* *.ktx
* dox/
* *.ktx
* notes/
* *.ktx
* plans/
* *.ktx
build.sh produces the following file structure/layout for use by a web server:
* live/
* index.php
* style.css
* javascript/
* *.js
* aphorism/
* *.html
* dox/
* *.html
* notes/
* *.html
* plans/
* *.html