proto-wayic/web/doc.task - Documentation in rough
────────────────────────────────────────────────────────────────────────────────────────────────────
Configuration of a waycast`
( Web specific configuration of a waycast
< see also: `proto-wayic.cast` § Configuration of a waycast
( http://reluk.ca/project/proto-wayic/cast/doc.task
* waycast root directory
- the root directory of each waycast holds the following files
which configure the Web view of its way declaration documents
- both the view shown to the waycaster, and the default view shown to others
+ personal style sheet
- `way_declaration_document.css` -
- summoned by a `link` element in each way declaration document of the waycast,
this style sheet works on the client side — in the waycast reader's Web browser —
where it formats the presentation of the way declaration
( see § way declaration document
- form: CSS
( https://www.w3.org/TR/CSS/
- working example
< http://reluk.ca/project/proto-waycast/way_declaration_document.css
+ personal presentation program
- `way_declaration_document.js` -
- summoned by a `script` element in each way declaration document of the waycast,
this program runs on the client side - in the waycast reader's Web browser -
where it manipulates the DOM of the way declaration
- form: JavaScript
( https://github.com/tc39/ecma262#ecmascript
- working example
< http://reluk.ca/project/proto-waycast/way_declaration_document.js
+ way declaration document
- `*.xht` -
- each way declaration document summons its Web view configuration via relative-path references
to the configuration files of the waycast root directory
( relative-path reference, https://tools.ietf.org/html/rfc3986#section-4.2, -3.3
- working example of a suitably formed way declaration document
< source: https://github.com/Michael-Allan/proto-waycast/blob/master/normative_ethic.xht
< live: http://reluk.ca/project/proto-waycast/normative_ethic.xht
- form
· · ·
· · ·
· · ·
────────────────────────────────────────────────────────────────────────────────────────────────────
Testing and troubleshooting`
* avoiding 'file' scheme
- problem
- a 'file' scheme is inapt for test purposes
- Web documents loaded on a 'file' scheme URI tend to misbehave in browsers
( http://reluk.ca/project/proto-waycast/_/waycast_configuration_file.xslt.txt
( http://reluk.ca/project/proto-wayic/lex/_/term_document.js § testing § limitations under 'file' scheme
( http://reluk.ca/project/proto-wayic/read/manual.task § basic use §§ limitations under 'file' scheme
( https://stackoverflow.com/q/52372080/2402790
( https://stackoverflow.com/q/52697798/2402790
- general solution
- a convenient, flexible method to test any type of Web document
without round tripping through a remote server
= list
| Jetty on Nashorn
- if feasible
| Python `http.server` -
( https://docs.python.org/3/library/http.server.html
- for extensionless files one would map MIME type '' to whatever is appropriate
in the context
( https://docs.python.org/3/library/http.server.html#http.server.SimpleHTTPRequestHandler.extensions_map
| Jetty on Java
- clumsy to share
= task further
Copyright © 2018-2019 Michael Allan and contributors. Licence MIT.