83 lines
2.0 KiB
Plaintext
83 lines
2.0 KiB
Plaintext
,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
|
|
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
|