wmkAdmin

wmkAdmin is a simple admin system for websites built with wmk. It requires wmk v1.3.0 or later.

Getting started

1. Go to a wmk project directory

2. Clone this repository as a suitable subdirectory, e.g. admin.

3. Create a file called wmk_admin.yaml in the project directory. It must contain an admin_password value. (The password should preferably be hashed with SHA-256 but can be written as plaintext if desired).

4. Run wmk admin . (with wmk version 1.3.0 or greater). Alternatively, run python admin/admin.py after having loaded the wmk venv (or otherwise made all required python modules available).

5. Access the admin system on http://localhost:7077/_/admin/ (or with the host and port configured in the wmk_admin.yaml file) and log in.

Settings in wmk_admin.yaml

The following settings are currently supported:

• admin_password: The SHA-256 sum of the password to the admin pages, in hexadecimal form. (There is no distinction between different users, so only a password is needed.)

• host: The host or IP for the admin server. Default: localhost.

• port: The port for the admin server: Default: 7077.

• server: The wsgi server to use. The default is wsgiref, but something else is recommended for any kind of heavy use. Good options are bjoern, cheroot and paste.

• deploy: A shell command to run from the base directory of the project. The intention if for this to deploy any changes to the webserver where the published site is running, but obviously it can be used for other purposes as well. The command will be passed to subprocess.run(), so if it has arguments, it should be specified as a list rather than as a string.

• auto_metadata: Which metadata fields to add automatically to the YAML frontmatter when saving files with a given extension. Example: auto_metadata: {'md': ['modified_date', 'created_date']}. The field modified_date will be updated on each save, while other fields will only be added if missing. Supported fields: date, created_date, modified_date. Take care that you only specify the extensions for file formats that support YAML frontmatter.

• preview_css: CSS source (not URL) to use for the Quick preview function on the Edit page.

• img_to_editor_template and attachment_to_editor_template: Content for javascript string templates for adding images or links to attachments into markdown text when clicking on the appropriate links in the file list below the editor. The string {src} indicates the placement of the image src or link href value.

• show_admin_overlay: By default, the preview of the website includes a prominent overlay in the bottom-right corner of each page, with a link to the admin frontpage as well as to an editing form for the current page (if applicable). This can be turned off by setting show_admin_overlay to false. The overlay can also be set to be visible only to a logged-in user by setting the value of this key to either logged-in or admin.

• recently_changed: A dictionary with settings for the "Recently changed files" component, which is an optional part of the admin front page. The dictionary should have at least the key type (which must have a value of either git or find). It can optionally have the keys days_back (default: 30), dirs (default ['content', 'data', 'templates', 'static']), extensions (default: all editatble extensions), and limit (default: 20).

All wmk_admin.yaml settings except admin_password are optional.

TODO

Potential features and improvements in the future:

• Improved Git interaction.
• Validate yaml and json before saving.
• Catch more errors and notify sensibly about them.
• View build logs.
• Manage assets directory in addition to the other three (?)

License

The license is MIT.