_____________ ____ ____ ____ ____ ____ ____ ____ ____ ______________
|| |||a |||s |||c |||i |||i |||w |||e |||b ||| ||
||____________|||__|||__|||__|||__|||__|||__|||__|||__|||_____________||
|/____________\|/__\|/__\|/__\|/__\|/__\|/__\|/__\|/__\|/_____________\|
::::::::::::::::::::::::::::::Times-Tribune:::::::::::::::::::::::::::::
.------------------------------------------------------------------------.
| ASCIIweb Times-Tribune Vol. I Issue I. |
| -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- |
| ASCIIweb... bringing you tomorrow's custom conf files today! |
'------------------------------------------------------------------------'
.------------. . |. . .|_____
| Welcome to | ,-. ,-. ,-. ," ," . | ,-. ,-. '-contents--'
| ASCIIweb! | | | | | | |- |- | | |-' `-. intro |
'------------' `-' `-' ' ' | | ' `' `-' `-' installing |
.------------. --------------'----'---------------- configuring|
| intro | conf files |
'------------' ASCIIweb has what at first may appear to be a editing |
.------------. strange customization system. security |
| manual | tricks |
'------------' Any page that requires a configuration different staticmode |
.------------. from the site defaults has a special conf file RFKML |
| license | in the directory "confs". credits |
'------------' COPYING |
.------------. For example, if you have a main page index.rfk .-----------|
| directory | for which the defaults are acceptable, but a | .-----'
'------------' special page wacky.rfk which should have |. . .|
.------------. radically different l_menu, r_menu, filler, | . . |
| changelog | footer, and header pages, you need to specify |. . .|
'------------' that information in a custom conf file. | . . |
.------------. |. . .|
| bugs | If the file in question is wacky.rfk, the conf | . . |
'------------' file that affects it would be: |. . .|
.------------. | . . |
| wishlist | confs/wacky.rfk.conf |. . .|
'------------' | . . |
.------------. ...and would look something like this: |. . .|
| website | | . . |
'------------' title= !!! this page is wacky !!! |. . .|
.------------. leftmenu=src/l_menu-wacky.rfk | . . |
| beta v0.90 | rightmenu=src/r_menu-wacky.rfk |. . .|
'------------' foot=src/wackyfoot.rfk | . . |
\...... . | head=src/wackyhead.rfk |. . .|
|. .| | . . |
| . | ...etc. Any option available to aw.conf can be |. . .|
|. .| set in a custom config file. | . . |
| . | |. . .|
|. .| This allows for cool animations, where clicking | . . |
| . | on a link causes the link to change, or appear |. . .|
|. .| depressed, or open another set of options in a | . . |
| . | custom l_menu, etc. |. . .|
|. .| | . . |
| . | That said, clever users will realize that |. . .|
|. .| these pages can also be defined by query string, | . . |
| . | sending links such as: |. . .|
|. .| | . . |
| . | aw.cgi?leftmenu=l_wacky.rfk&rightmenu=r_wacky.rfk |. . .|
|. .| | . . |
| . | ...etc. |. . .|
|. .| | . . |
| . | This is perfectly acceptable, but is less |. . .|
|. .| flexible than using the conf file system. | . . |
| . | |. . .|
|. .| ...or at least, is a much greater PITA than | . . |
| . | using the conf system. |. . .|
|. .| | . . |
| . | ADDITIONALLY, if you intend to switch between |. . .|
|. .| dynamic or static page generation (or use both | . . |
| . | in one site), you must not use such query |. . .|
|. .| string hackery, as static mode ONLY examines the | . . |
| . | main parameter and conf files. This issue is |. . .|
|. .| discussed further in the section on static mode. | . . |
| . | |. . .|
|. .| Finally, ASCIIweb's live directory feature | . . |
| . | presents a further complication. Should you want |. . .|
|. .| to have a live, "in-line" display of the | . . |
| . | directory "foo/", you might also want the header |. . .|
|. .| or menus to reflect the contents of the | . . |
| . | directory. |. . .|
|. .| | . . |
| . | This is accomplished with special conf files. |. . .|
|. .| | . . |
| . | For the directory foo/ the file would be: |. . .|
|. .| | . . |
| . | confs/foo.conf |. . .|
|. .| | . . |
| . | For a further subdirectory: |. . .|
|. .| | . . |
| . | foo/bar/baz/ |. . .|
|. .| | . . |
| . | ...the conf file would be: |. . .|
|. .| | . . |
| . | confs/foo_bar_baz.conf |. . .|
|. .| | . . |
| . | Relatedly, sometimes you just want a *single* |. . .|
|. .| conf file to cover an entire directory tree. | . . |
| . | This is accomplished by creating a top-level |. . .|
|. .| conf file, and setting the aw.conf parameter: | . . |
| . | |. . .|
|. .| persistdirconf=1 | . . |
| . | |. . .|
|. .| ...the conf file will be loaded for all sub- | . . |
| . | directories. |. . .|
|. .| | . . |
| . | That's it! |. . .|
|. .| | . . |
| . | Back: Next: |. . .|
|. .| Configuring Editing .rfk Files | . . |
| . | <-- --> |. . .|
.------------------------------------------------------------------------.
| The ASCIIweb Times-Tribune is a Tastytronic Industries newspaper. |
'------------------------------------------------------------------------'
Generated at: Wed Oct 29 14:17:44 CDT 2025