[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

commit 8d61bd5e5c6131b027050ce2b9832aa7d6108bdd
Author: Rob Austein <sra at hactrn.net>
AuthorDate: Fri Oct 8 15:20:07 2021 -0400

    README
---
 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
--- a/GNUmakefile
+++ b/Makefile
@@ -1,4 +1,3 @@
-
 HTTP_HOST := $(shell hostname -f)
 HTTP_PORT := 8000
 
@@ -17,7 +16,7 @@ check:
 
 tags: TAGS
 
-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$$')
 	etags $^
 
 .PHONY: all clean server check tags
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9b29ee6
--- /dev/null
+++ b/README.md
@@ -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 mailing list