Fediversity/Fediversity
11
2
Fork 6
Code Issues136 Pull requests5 Projects1 Activity Actions

WIP:hans/matrix #43

Closed
hans wants to merge 138 commits from hans/matrix into main
Conversation 3 Commits 138 Files changed 29 +1801 -26
hans commented 2024-11-28 15:00:27 +01:00
Owner

Documentation for creating a Matrix server.

Documentation for creating a Matrix server.
hans added 138 commits 2024-11-28 15:00:28 +01:00 
git-subtree-dir: matrix
git-subtree-mainline: 79b663f6d0
git-subtree-split: 0a991a5140
that directory will only grow
this allows writing the beginning of the indented string at the desired
indentation
with an example
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.
- links are constructed explicitly, relative to the current page's
location
- templates are called explicitly by output type
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.
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.
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.
- automatically assign heading levels
- check that the maximum nesting depth is not exceeded
this is practical for debugging and demonstration purposes
this allows adding files to the output as they are
this allows for more customised styling
it also features a dark mode
hans commented 2024-11-28 15:03:10 +01:00
Author
Owner

The workflow seems to expect Nix code, but this isn't. It's mostly README.md files and some example/template configuration files.

The workflow seems to expect Nix code, but this isn't. It's mostly README.md files and some example/template configuration files.
hans changed title from hans/matrix to WIP:hans/matrix 2024-11-28 15:05:16 +01:00
hans commented 2024-11-28 15:06:52 +01:00
Author
Owner

Bad PR, I'll try again.

Bad PR, I'll try again.
hans closed this pull request 2024-11-28 15:06:52 +01:00
Niols commented 2024-11-28 15:28:18 +01:00
Owner

The workflow seems to expect Nix code, but this isn't. It's mostly README.md files and some example/template configuration files.

The workflow uses Nix to run but only checks Nix files, so it shouldn't affect you. In this case you've just been unlucky; the error is due to Kevin and I tinkering with the CI runners!

> The workflow seems to expect Nix code, but this isn't. It's mostly README.md files and some example/template configuration files. The workflow uses Nix to run but only checks Nix files, so it shouldn't affect you. In this case you've just been unlucky; the error is due to Kevin and I tinkering with the CI runners!
Some checks are pending
/ check-pre-commit (pull_request) Failing after 10s
Required
Details
/ check-website (pull_request)
Required
/ check-peertube (pull_request)
Required

Pull request closed

This pull request cannot be reopened because the branch was deleted.
Sign in to join this conversation.
No reviewers
No labels
blocked
bug
component: fediversity panel
component: nixops4
contributor experience
documentation
estimation high: >3d
estimation low: <2h
estimation mid: <8h
goal: devops
project-management
question
role: sysadmin
security
technical debt
testing
user experience
user story
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: Fediversity/Fediversity#43
No description provided.
Delete branch "hans/matrix"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?