CLAUDE

The GeoDMS wiki — instructions for Claude

Where you are

This is the GitHub wiki of ObjectVision/GeoDMS. It is not only a wiki: every page here is published as a page on www.geodms.nl, by the converter in ObjectVision/GeoDmsWikiToStaticHtml, which runs nightly and whenever a wiki page changes. So a change here is a change to a public website, and it is the only place to make that change: geodms.nl itself is generated and cannot be edited.

Four sibling wikis are published the same way, as subsites: GeoDMS_Academy at geodms.nl/academy/, RSopen at /rsopen/, NetworkModel_PBL at /networkmodel_pbl/ and CRISP at /crisp/.

What belongs here, and what does not

This wiki documents the software: what GeoDMS is, how to install and configure it, the operators and functions, how to model with it.

It does not carry the project list, the client list or the publication list. Those live on objectvision.nl/projects and objectvision.nl/publications, and this wiki links to them. That was a deliberate decision: the same list used to exist in three places, two of them on geodms.nl, and two pages on two domains competing for one search do both of them harm. A record of who commissioned what is evidence about the company, not documentation of the software. If you are asked to add such a list here, link instead.

How page names work

A GitHub wiki derives the page name from the file name, and a dash means a space. So How-To-Model.md is the page "How To Model". A name that really contains a hyphen uses the Unicode hyphen U+2010 (‐) instead, which is why some files look odd in a directory listing.

Consequences worth knowing before renaming anything:

• Renaming a file renames the page and changes its url on geodms.nl. Existing links break.
• Home.md has to be called that. On the website it is republished under the site's own name, so "Home" does not appear as a page title or in the menu there.
• Links between pages are [[Page-Name]] or [[label|Page-Name]]. Without a label the website shows the target page's own title, so [[Modelstructuur-op-hoofdlijnen]] reads as "Modelstructuur op hoofdlijnen" and not as its slug.
• A page that opens with its own # heading keeps it; otherwise the converter adds the page title as the heading.

The menu on geodms.nl is not _Sidebar.md

_Sidebar.md is what GitHub shows next to the wiki. The left column on geodms.nl comes from nav/geodms.md in the converter repository, so the website can group pages the way a website reader needs them while this wiki keeps the sidebar its authors wrote.

A new page therefore does not appear in the website menu on its own. It is built, it has a url and it is in the search index, but to put it in the left column someone has to add it to nav/geodms.md. Say so when you add a page.

Things the converter does that markdown alone does not

• Images pasted into the GitHub editor land on GitHub's CDN. They are downloaded and served from geodms.nl itself, so the site stays self-contained. Nothing to do, just be aware the first build after pasting an image is slower.
• A table directly under a paragraph without a blank line renders on GitHub and not in Jekyll. The converter inserts the missing blank line, so both work.
• Inline math between single dollars is rendered by MathJax.
• The first real paragraph of a page becomes its meta description, the snippet in search results. A page that opens with a table or an image falls back to the site description, so opening with a sentence is worth it.

Git

This is a wiki repository; it has no pull requests and no review. Commit in separate commits per subject. Never push; the owner pushes.

Commit messages state what changed and why. They do not name colleagues and do not review anyone's input.

This file is excluded from the published site, so it is not a page on geodms.nl.