This is a simple wiki-style static site generator using Ema. It pulls in an external directory of Pandoc-flavored Markdown files for the contents of the wiki.
To develop with full IDE support in Visual Studio Code, follow these steps:
- Install Nix & enable Flakes
- Run
nix-shell --run haskell-language-serverto sanity check your environment - Open the repository as single-folder workspace in Visual Studio Code
- Install the recommended extensions
- Ctrl+Shift+P to run command "Nix-Env: Select Environment" and select
shell.nix. The extension will ask you to reload VSCode at the end.
- Press Ctrl+Shift+B in VSCode, or run
bin/run(bin/run-via-tmuxif you have tmux installed) in terminal, to launch the Ema dev server, and navigate to http://localhost:9001/
All but the final step need to be done only once. Check the Ema tutorial next.
- This project uses relude as its prelude, as well as Tailwind+Blaze as CSS utility and HTML DSL. Even though the author highly recommends them, you are of course free to swap them out for the library of your choice.
- Configuration:
- To change the port, see file bin/run
- To change the CLI arguments used by bin/run, see file .ghcid
- To update Ema to latest Git revision, run
nix flake lock --update-input ema - To add/remove Haskell dependencies, see the .cabal file. If a dependency is unavailable in nixpkgs, you can override it (to point to say a Git repo) in the
overridesattribute of flake.nix. You can imitate the manner in which theema(orlvar) package itself is overriden.
- To generate static site, run:
nix build; mkdir ./output && (cd ./content && ../result/bin/ema-wiki gen $(pwd)/output)- You might want to change or remove the
<base>tag inMain.hsdepending where you will be deploying the site.
- You might want to change or remove the
Search for this example is provided by Algolia’s DocSearch product,