This is the skeleton of the blog that I use with emem. Change it as it suits you.
There is a top-level
Makefile that handles the files that reside in the root directory. There is
Makefile that lives inside the
en/ directory. The key variables to modify there are:
ANALYTICS. The other parts of the Makefiles that must be modified are the values
The URL in the file
index.html must also be updated accordingly.
The contents of the file
en/src/index.md will be rendered as the index file for the
To write posts, write Markdown files in
en/src/. The first line will serve as the page title and
the value of
OG_TITLE in the Makefile. The rest is free form. In addition to the source Markdown
files, write the equivalent
.md.dat files, per
.md files. The contents of this file will be used
for the site keywords.
en/src/footer.md is appended to every file in
en/src/ during the build phase. The file
src/404.md serves as the 404 page.
Inside the root directory, run:
If you use Nixpkgs, instead run:
nix-shell --pure --run make
If we have the file
en/src/foo.md, this command creates the equivalent
To see how the site will look like, run a local web server:
python -m SimpleHTTPServer
Then, go to http://localhost:8000/en to preview it.
If you want GitHub to host your pages, go to https://pages.github.com/. You may then push this directory to that repository.
GNU Parallel is not a hard requirement but it makes building much faster. Also, don’t forget to update the README and LICENSE files.