The general frame provides supporting tool pages
The general frame includes the tools that AWF's dark web
generator builds to support editing and reading the dark web
such as the: Checklists, Glossary, Name list, References;
The general frame includes pages which can be used with the dark web generator is a Perl script, typically launched as a child process within the configuration editor, by clicking 'generate web', which executes frame configuration file instructions merging the configuration variables with an HTML template file to generate target web pages. The configuration instructions can be tailored by filters from the configuration file specified filter file.
to provide support tools for your core dark web is a web site that is not open to the Internet. It is a set of deployed HTML files in a directory which refer to each other via file based references relative to the directory. pages:
- Checklists are signals which remind the reader of highly significant aspects of a process. They are designed to be consulted at a point in the process where forgetting about the aspect will have a significantly detrimental effect. Often the processes are being used to respond to failures in the regular operation. Atul Gawande argues that effective use of checklists is vital to coping with situations that are complex.
deploy into this frame.
- The glossary deploys into this frame. Any glossary text
conforming to the AWF is the adaptive web framework. glossary
list structure and described in the filter file contains filter statements that alter the merge process executed by the dark web generator. In particular it describes:
commands: addglkey is a filter file command which specifies that an item with the key specified from an additional included glossary stream (addglstream) should be merged into the target glossary stream.
- Dontunload filters statement (dontunload 'filters' = 't'). By default the statements are unloaded.
- Map statements which replace a link found in the active source stream with the mapped equivalent (mapf '../web/awfbur01.html' = 'awfbur01.html').
- Purge statements which remove the HTML link structure from the active source stream (purge 'http://www.reinventures.com' = 't'). The purge will only be executed if the right hand side of the command equates to true in Perl.
- Region dominance statements, which request the dark web generator to replace the regular stream source tagged with the identified start and end stream tag names with a replacement with the same name in the merge stream (region '<stream name>' = 'dom') from a source file with a 'dom' suffix to the file name. For example:
- The source file awffwbusitdom.html would be dominant to AWF provided source file awffwbusit.html.
- The file awffwbusit.htm includes the sub-stream tagged with start tag 'anhp1' and end tag 'anhp1'.
- If the file awffwbusitdom.htm is created and includes an HTML stream identified by 'anhp1' its source will be included instead of the recessive source once the filter file includes the statement:
- Region co-dominance statements, which request the dark web generator to prepend an additional stream identified in the statements to the regular stream being deployed at the html name specified. For example:
- The source file awffwbusitext.html would be co-dominant with the AWF provided source file awffwbusit.html.
- The file awffwbusit.htm includes the sub-stream tagged with start tag 'sgen132' and end tag 'sgen132'. Within this stream is HTML named 'Impact_of_socio-cultural_complexity'.
- If the file awffwbusitext.htm is created and includes an HTML stream identified by 'dsgen132Impact_of_socio-cultural_complexity' start and end tags its source will be included immediately before the HTML source named 'Impact_of_socio-cultural_complexity', once the filter file includes the ordered pair of statements:
- regionexttnlist 'sgen132' = 't'
- regionexthnlist 'sgen132' = 'Impact_of_socio-cultural_complexity'
- Glossary HTML tag start string statement (addgltag 'id' = 'gl').
- Glossary target file statement (glfile 'name' = '<target glossary page name>').
- Glossary source file (addglstream 'file0' = '<path to>/<glossary source file>')
- Glossary element (addglkey 'gl_Hoshin' = '1') with key gl_Hoshin will be included from addglstream file1.
- Checklist HTML tag start string statement (addcltag 'id' = 'cl').
- Checklist target file statement (clfile 'name' = 'awfhcl.htm').
- State link generation statements (addstatelink 'awffwpwcxprad.htm' = 'http://localhost:3000/openstage/randd/randmgr/awffwpwcxprad.htm') which link one dark web to another via an execution link.
- Summary item text source file statement (addsumtext 'hover' = 'html/awfhelphomeplan.html'). On mouse over items specified in sumfile descriptions will display the summary information, which occurs after the summary heading and before the next heading, from the source file.
- Statements of each summary source file to include in summary mouse over (sumfile 'pwhp' = 'awfhpwhp.htm').
- Name list statement (namelist 'name' = 'nam').
- Statefile commands which allow a dark web execution plan to include a strategy status description, and for the dark web to be associated via an execution link with the dark web containing the delegates implementation actions.
- Strategy contents list statement (lablist 'name' = 'cxp').
- Strategy label priority statement (labpr '126.96.36.199' = '1').
- Link error report suppression statement (linkerror 'usetext' = 't').
- Setup shared source developer Git status web report generation with (gitstateweb '<web file name>' = 't')
- Setup shared source maintainer Git status web report generation with (gitsourcestateweb 'web file name>' = 't')
- Setup indicator of names of Git status web pages with (addgitst 'id' = '<Git status page file name prefix>')
addglstream is a filter file command which specifies a path and file name of a source file containing glossary items delineated by the AWF tag that marks the start and end of the glossary definition source stream. A number of streams can be included. The first should have a key 'file0', the second 'file1' etc. If an addglstream statement is used in a filter file:
, addgltag is a filter file command which specifies the AWF tag that marks the start and end of the glossary definition source stream. It is also the identifier that must be prepended to glossary entry names in the source documents and hence the target dark web glossary page. For example:
- No glossary items should be declared in the source file containing the basic glossary source within start and end tags.
- The basic glossary page should include the target <gltarget> which the merged and sorted glossary items will be deployed into.
The command triple addgltag 'id' = 'gl' tells the generator to include items from the glossary page (identified to the dark web generator by the filter file command addgltext) that have names starting with 'gl_'. , addgltext is a filter file command which describes to the dark web generator the source file from which the glossary description is loaded. If this command is not present in the filter file no hover substitution will be performed. , and glfile is a filter file command which specifies path and file of glossary HTML references that will be augmented with hover data. ; will be merged,
sorted and deployed into the glossary
- If set up by your AWF administrator the name list is a filter file command which initiates generation of the dark web internal HTML reference list.
list of correctly structured links existing within the dark
web, which can be copy and pasted into your web source text.
Each link is followed by a hot link to allow quick review of
the target text details.
- A set of references can be gathered together in the reference page.