Commit graph

110 commits

Author SHA1 Message Date
Valentin Gagarin dcb6afa492 add devmode for live preview 2024-11-13 15:24:41 +01:00
Valentin Gagarin 3edcca2815 fix semantics: wrap content body into section 2024-11-13 15:24:41 +01:00
Valentin Gagarin 9c2b543e47 make template overrides chainable 2024-11-13 15:24:41 +01:00
Valentin Gagarin c11da792d7 remove old template garbage 2024-11-13 15:24:41 +01:00
Valentin Gagarin 99d4b7c2e8 override page template for articles 2024-11-13 15:24:41 +01:00
Valentin Gagarin 4762618956 make page templates granularly overridable 2024-11-13 15:24:41 +01:00
Valentin Gagarin 648227d1b6 add resulting Nix value to default.nix outputs
this is practical for debugging and demonstration purposes
2024-11-13 15:24:41 +01:00
Valentin Gagarin 7b2ded053b move things to more appropriate places 2024-11-13 15:24:41 +01:00
Valentin Gagarin 166a48f8cd unify template parameters 2024-11-13 15:24:41 +01:00
Valentin Gagarin e6459f26e2 further prettify output 2024-11-13 15:24:41 +01:00
Valentin Gagarin 8704b45b23 fix indentation in output 2024-11-13 15:24:41 +01:00
Valentin Gagarin 1e81d83ffb reiterate on mandatory headings in sections 2024-11-13 15:24:41 +01:00
Valentin Gagarin 179482d043 ensure the section hierarchy is spec-compliant
- automatically assign heading levels
- check that the maximum nesting depth is not exceeded
2024-11-13 15:24:41 +01:00
Valentin Gagarin 4160b6e976 separate DOM mapping and generic templating
the templates collection will soon only be there for reusable snippets,
while the HTML representation of document types will be attached to
those types directly.
2024-11-13 15:24:41 +01:00
Valentin Gagarin 2eeb7e5bcc implement sectioning semantics
this was quite a beast to tame, but it now allows putting sections anywhere
in the tree without having to redundantly specify heading levels, which
will be computed automatically from the nesting depth.

the whole thing will also blow up if the maximum section nesting depth
is exceeded, just as the spec requires - albeit with an absolutely
impenetrable error message. this could in principle be improved with
lots of additional machinery, but this is by far not low-hanging fruit.

just don't nest your sections too much.
2024-11-13 15:24:41 +01:00
Valentin Gagarin 260ce84c55 fix module for <link> and <base> 2024-11-13 15:24:41 +01:00
Valentin Gagarin 069c758dd5 fix attrs printing 2024-11-13 15:24:41 +01:00
Valentin Gagarin c9bdbfcb15 add README 2024-11-13 15:24:41 +01:00
Valentin Gagarin 73c3262d74 render content via structured DOM representation 2024-11-13 15:24:41 +01:00
Valentin Gagarin 01be60f9c6 formatting 2024-11-13 15:24:41 +01:00
Valentin Gagarin 62f5e16f38 implement a slice of the DOM spec as modules
this is roughly sufficient to recreate the website as it currently is

- elements:
  - document
  - html
  - head
  - title
  - base
  - link (variants that must be unique nested under `head` directly)
    - canonical
  - meta (same as for link):
    - charset
    - viewport
    - author (can be multiple, but still unique in aggregate for a document)
    - description

- global attributes:
  - class
  - hidden
  - id
  - lang
  - style
  - title

- element-specific attributes:
  - href
  - target

there's still a lot to do for a reasonably complete implementation, most
importantly everything concerning
- navigation
- top-level flow content (`div`, `article`, headings, `p`, ...)
- stylesheets

there's also some infrastructure to be arranged for easy but somewhat
safe switching between literal HTML and structured representations.
2024-11-13 15:24:41 +01:00
Valentin Gagarin 5b99ef52f5 add more string processing helpers 2024-11-13 15:24:41 +01:00
Valentin Gagarin 07ba9d70c4 add type for list of unique elements 2024-11-13 15:24:41 +01:00
Valentin Gagarin 92b2f0ba58 don't use outPath any more
- links are constructed explicitly, relative to the current page's
location
- templates are called explicitly by output type
2024-11-13 15:24:41 +01:00
Valentin Gagarin c5966cd4cb let navigation have its own template 2024-11-13 15:24:41 +01:00
Valentin Gagarin e3578b0440 make a proper link 2024-11-13 15:24:41 +01:00
Valentin Gagarin a340863781 move more content 2024-11-13 15:24:41 +01:00
Valentin Gagarin ad1e193067 set a default location for documents
it turns out that setting a value appends to that.
the default only needs to be overridden when the symbolic name of the
document changes. while there's a chance people will inadvertently break
links that way, it's requires less up-front knowledge to work with.
2024-11-13 15:24:41 +01:00
Valentin Gagarin c2fe5da469 allow prefixing output paths of collection items 2024-11-13 15:24:41 +01:00
Valentin Gagarin c3774eb1f6 delete obsolete page 2024-11-13 15:24:41 +01:00
Valentin Gagarin d2265cb2b7 allow menu entries to be subtypes of page
with an example
2024-11-13 15:24:41 +01:00
Valentin Gagarin 8397a2641d split content types into separate files 2024-11-13 15:24:41 +01:00
Valentin Gagarin c76bc2cbad extract importing Nix files 2024-11-13 15:24:41 +01:00
Valentin Gagarin fbebdbb7a1 implement correct-by-construction relative links 2024-11-13 15:24:41 +01:00
Valentin Gagarin dde36364b4 smarter indent
this allows writing the beginning of the indented string at the desired
indentation
2024-11-13 15:24:41 +01:00
Valentin Gagarin 48bb34ccfe stricter type for articles 2024-11-13 15:24:41 +01:00
Valentin Gagarin c8caf09ebf separate templating from file system outputs 2024-11-13 15:24:41 +01:00
Valentin Gagarin 24bd786896 extract generic document type 2024-11-13 15:24:41 +01:00
Valentin Gagarin 7eb147a5a0 add note 2024-11-13 15:24:41 +01:00
Valentin Gagarin ebec1d8e25 implement navigation 2024-11-13 15:24:41 +01:00
Valentin Gagarin 6a22b197ac split out template library 2024-11-13 15:24:41 +01:00
Valentin Gagarin 8634df5833 add TODO 2024-11-13 15:24:41 +01:00
Valentin Gagarin 0708801f6a extract presentation module 2024-11-13 15:24:41 +01:00
Valentin Gagarin a483b7e5fa add some documentation 2024-11-13 15:24:41 +01:00
Valentin Gagarin 6991bc9c0e split content types into module 2024-11-13 15:24:41 +01:00
Valentin Gagarin ea0319c60e move custom type into custom lib 2024-11-13 15:24:41 +01:00
Valentin Gagarin c9abe13377 more scalable imports
that directory will only grow
2024-11-13 15:24:41 +01:00
Valentin Gagarin 68168db215 add TODOs 2024-11-13 15:24:41 +01:00
Valentin Gagarin 94744a6241 clean up artefacts 2024-11-13 15:24:41 +01:00
Valentin Gagarin 128dceb32c sort news by date 2024-11-13 15:24:41 +01:00