language and parsing
The Bumble site uses some bash and sed scripts to generate the html pages from the text documents. certain formats in the text files trigger certain types of html output in the usual style of a wiki →W system. Detailed below are some of the text formats and their resulting html. The system described is not a wiki because there is no mechanism for the page visitor to edit the files. It may be asked "why wasnt an existing text (or wiki) markup system used instead of inventing a new one?". Firstly, for capriciousness, and also because the system created allows the text files to be "cleaner", that is, the markup language →W is simpler and (hopefully) less intrusive for the editor of the text file. Files of the form "name.txt.html" are being generated by the sed script from the text file "name.txt" (that is, the file "name.txt.html" does not exist as such on the server)
** headingproduces a page section heading as below
= page title =produces a page heading. Look at the top of the current page to see what this looks like.
:>prevents text on the line being formatted which may be useful for displaying fragments of code ...
-text-makes the text emphasized like this: text
(-faq-) * a question? an answer (-/faq-)produces an faq type of document. actually the tags above must be the first thing on their lines. a star starts a question and a ? ends it. (a table of contents is not produced)
"term" [->wikipedia] or (wikipedia)produces a link to the wikipedia site like this: term →W
"term" (googlemap)creates a link to the http://maps.google.com site like this: san francisco
"term" (google)produces a link to a google search for the term like this: term
"document;"makes a link to one of the documents in the machine/doc directory like this "workspace;"
file://index.txt or link://index.txt or doc:index.txtproduces a link to a local file on the server like this: index.txt
"display" file://index.txt or link://index.txtproduces a link to a local file on the server like this: display
"text" www.google.com or "text" http://google.comproduce links with the text as display like this: text
--> and --<prevent a block of text being marked up. These patterns must begin the line (excepting whitespace). No other transformations on the text between the tags will be carried out and html <pre> tags will surround the block in order to assure that the text appears as it is written
u- one - second item in the list which spans more that one line - three o- un - deux - troiswith a blank line terminating the list. the "dash" character must be the first thing on the line and will appear like this
D- silence: an absence of noise - noise: compression waves in air -hearing: a way of listeningand should appear as below:
If for some strange reason you wish to use the page generation system then you need to put the following files in your cgi-bin directory
RewriteRule ^(.*)\.txt\.html$ /cgi-bin/text2html.cgi?$1 RewriteRule ^(.*/)$ /cgi-bin/text2html.cgi?$1 RewriteRule ^(.*doc/.*)\.txt$ /cgi-bin/text2html.cgi?$1 RewriteRule ^$ /cgi-bin/text2html.cgi?$1
Thats all. If you have problems please consult the relevant user manuals.
All this assumes that your are running apache on a unix →W style operating system. If not then then you cant really use these scripts without large amounts of annoying installations and configurations.