From f29b392c6b68b7db98f5d6921ea588b559435f35 Mon Sep 17 00:00:00 2001 From: Ruben Beltran del Rio Date: Mon, 22 Dec 2025 11:29:53 +0100 Subject: Initial implementation --- README.md | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..0ce126e --- /dev/null +++ b/README.md @@ -0,0 +1,39 @@ +# Federated Wiki - Wmap Plugin + +This plugin, type: wmap, extends the markup of the federated wiki. + +It allows for the rendering of inline wardley maps using the wmap syntax. + +## Development workflow + +This project has a `Makefile` that encapsulates some of the common development +tasks. + +To help with development, you can to run the plugin in a local instance of +wiki. You need to set the path of that using the `WIKIDIR` environment variable. + +The `Makefile` assumes the wiki is in `../../vendor/wiki`. + +``` +# If your wiki directory is elsehwere. +WIKIDIR=$HOME/workspace/wiki make link +``` + +The source needs to be built before it can be used. `make build` builds it. + +### Linking the project. + +`make link` will create a link from this project to the local fedwiki instance, +so it can load the latest version of your code. + +### Running the local Wiki. + +`make` will run the wiki. +`make watch` will rebuild the client on any change. + +### Code quality. + +- Run tests with `make test` +- Format the code with `make format` +- Lint the code with `make lint` +- Generate typescript types with `make types` -- cgit