Documentation

This section of the website collects guides to editing and managing the site content. Access to this content is not restricted, but is not promoted either.

Site content is written using markdown syntax supplemented by a significant number of WordPress shortcodes.

• Markdown
  Content for our website is produced in Markdown. Markdown is a lightweight markup language which is directly convertible to HTML, yet eminently readable in its raw form. Indeed: The overriding design goal for Markdown’s formatting syntax is to make it as readable as possible. The idea is that a Markdown-formatted document should be publishable as-is,…
• Shortcodes
  This site implements a large number of shortcodes providing advanced formatting capabilities or allowing you to embed advanced functionality directly within pages. WordPress shortcodes provide us with a mechanism to expand on the formatting capabilities of Markdown in a controlled and well-defined manner. A WordPress shortcode is enclosed in tags using square brackets, and looks…
• Library management
  The purpose of the library feature of the website allows us to embed the contents of a folder directly in a page, making the files in that folder available to view or download. Any file present or added to the folder (with some exceptions) is automatically and immediately displayed in the corresponding library "instance" on…
• Inident syntax
  Inident is an intuitive, human readable, hierarchical configuration syntax based on a subset of YAML. Inident is used extensively by the site for plugin configurtion, metadata, and shortcode configuration purposes (notably for gn:contact and gn:library). Many of the examples on this page show an Inident document followed by the equivalent JSON representation of the same…