[Cryptech-Commits] [wiki] branch production updated: README
git at cryptech.is
git at cryptech.is
Fri Oct 8 19:25:05 UTC 2021
This is an automated email from the git hooks/post-receive script.
sra at hactrn.net pushed a commit to branch production
in repository wiki.
The following commit(s) were added to refs/heads/production by this push:
new 8d61bd5 README
8d61bd5 is described below
Author: Rob Austein <sra at hactrn.net>
AuthorDate: Fri Oct 8 15:20:07 2021 -0400
GNUmakefile => Makefile | 3 +--
README.md | 36 ++++++++++++++++++++++++++++++++++++
2 files changed, 37 insertions(+), 2 deletions(-)
diff --git a/GNUmakefile b/Makefile
similarity index 80%
rename from GNUmakefile
rename to Makefile
index 36b12d7..575f235 100644
@@ -1,4 +1,3 @@
HTTP_HOST := $(shell hostname -f)
HTTP_PORT := 8000
@@ -17,7 +16,7 @@ check:
-TAGS: GNUmakefile pelicanconf.py $(shell git ls-tree -r --name-only HEAD | egrep '[.]md$$')
+TAGS: Makefile pelicanconf.py $(shell git ls-tree -r --name-only HEAD | egrep '[.]md$$')
.PHONY: all clean server check tags
diff --git a/README.md b/README.md
new file mode 100644
@@ -0,0 +1,36 @@
+# Trac Wiki converted to Pelican Markdown
+The Trac Wiki that used to hold this site has been converted to a
+wiki-like setup using git, Markdown, Pelican, and m.css.
+* [git repository behind this Wiki](https://git.cryptech.is/wiki).
+* [Pelican documentation](https://docs.getpelican.com/en/stable/).
+* [m.css documentation](https://mcss.mosra.cz/themes/pelican/).
+The git repository is configured to generate the web content from the
+Markdown automatically upon receiving a `git push`.
+[linkchecker](https://linkcheck.github.io/linkchecker/) may also be
+useful in validating the generated content.
+The `Makefile` in this directory makes it easy to test out changes to
+the content before pushing them, eg:
+make all check server
+will generate the content, run the result through `linkchecker`, then
+start up a web server on the name and port specified in the Makefile
+(which you can override with the `HTTP_HOST` and `HTTP_PORT`
+variables) to let you browse the result. Feel free to experiment on
+your own copy: there are almost certainly things we could do better
+within the Pelican framework, maybe you'll figure them out for us.
+The upstream repository is configured to run Pelican automatically on
+push and install the result, and to refuse the push if something fails
+to compile. It is of course possible to mess things up in ways that
+won't cause compilation to fail, so don't do that. :)
+As with all Cryptech git repositories, all commits to this repository
+must be signed by a known key.
To stop receiving notification emails like this one, please contact
the administrator of this repository.
More information about the Commits