From d716ffb05f086061d9a5302f67f3695457fcff02 Mon Sep 17 00:00:00 2001 From: gennyble Date: Sat, 24 Feb 2024 02:24:50 -0600 Subject: Implement basic markup system this also has the redirection from non-trailing-slash-directories to their slashy counterparts --- readme.md | 30 +++++++++++++++++++++++++++++- 1 file changed, 29 insertions(+), 1 deletion(-) (limited to 'readme.md') diff --git a/readme.md b/readme.md index b7a3651..e870276 100644 --- a/readme.md +++ b/readme.md @@ -20,6 +20,11 @@ What do you name the root file, then? You shouldn't have to match the webroot's directory name. Perhaps it should be configurable. I think for now we'll hard-code in `home.html`, though. +**TODO:** +we need to redirect directories to themselves with slashes. The browser thinks +that anything not ending in a slash is a file. It couldvery well be right, but +this causes chaos when we try to relative link to a directories resources. + ## Page-content uses templates Because writing the same outer-html for everything poses a few problems. I'll enumerate them for fun! @@ -64,4 +69,27 @@ a one or two sentence description of the page. -``` \ No newline at end of file +``` + +## Page content uses a weird kind of markup language +It's mostly just HTML, but I'm tired of writing `

` so damn much. + +A block of text, a textblock, are consecutive lines that contain text. A double +linebreak separates blocks. If a block starts with a `<` it's assumed to be raw +HTML and will not be wrapped in a paragraph. + +You can escape any commands or annotations, both of which are described below, +with a `\`. Like this: `\[`. You can also escape the slash itself, `\\`, or an +opening greater-than, `\<`. + +### commands + +**[@paragraphs off]** - stop wrapping text-blocks in paragrapha and just pass +them through as is. this is useful for HTML. + +**[@paragraphs on]** - start wrapping text-blocks in paragraphs starting at +the next line. + +### annotations + +**[#element-id]** - give the paragraph for this text block an ID of `element-id` \ No newline at end of file -- cgit 1.4.1-3-g733a5