summaryrefslogtreecommitdiff
path: root/repo
AgeCommit message (Collapse)Author
2020-10-06Handle link abbreviationsKévin Le Gouguec
2020-10-06Bang on Org export some moreKévin Le Gouguec
2020-10-01DAMMITKévin Le Gouguec
ox-md does not syntax-highlight source blocks, and trips over definition lists.
2020-10-01Move branches aroundKévin Le Gouguec
The no-readme case is more straightforward, thus more digestible as an extra-indented special-case.
2020-10-01Factor some code outKévin Le Gouguec
To make it easier to add a pre-processing step for Org files.
2020-09-28Merge branch 'crumbs'Kévin Le Gouguec
2020-09-28Pick some nits before mergingKévin Le Gouguec
2020-09-07Lay down rationale for not using ox-htmlKévin Le Gouguec
2020-09-04Draft conversion process for Org filesKévin Le Gouguec
2020-08-28Move site title after page titleKévin Le Gouguec
Plenty of websites do this; on GNU/Linux most applications do this; I guess the goal is to make the most specific information go first, so that tabs remain identifiable as they become narrower.
2020-08-28Make sure titles are not redundant with breadcrumbsKévin Le Gouguec
The logic for the various titles on any given page is: ∃README ∃title block <title> ⇒ title block <header> <h1> ⇒ title block TOC <h1> ⇒ "Index for {target}" ∄title block <title> ⇒ "{target}" or "README" <header> <h1> ⇒ ∅ TOC <h1> ⇒ "Index for {target}" ∄README <title> ⇒ "Index for {target}" <header> <h1> ⇒ "Index" TOC <h1> ⇒ ∅
2020-08-28Add breadcrumbsKévin Le Gouguec
Likewise, use relative links so that things work when just browsing files locally without a server. Next: tweak or remove redundant titles.
2020-08-25Include stylesheetsKévin Le Gouguec
With relative links, so that I can just view HTML files on my disk without spawning a webserver.
2020-08-20Use pandoc's --include-after flagKévin Le Gouguec
Thereby allowing non-markdown READMEs. This needs refactoring; I need sleep.
2020-08-19Put extensions in Lua module instead of sneaking them in environmentKévin Le Gouguec
Note that neither .cache/config.lua nor .cache/site-tree.json get updated when EXTENSIONS changes. This could be hacked as follows: config = EXTENSIONS="$(EXTENSIONS)" ifneq "$(shell test -f $(config_token) && cat $(config_token))" \ "$(shell ./generate-config-token.py $(config))" .PHONY: $(lua_config) $(site_tree) $(config_token) endif Plus a recipe for config_token, and some dependencies on it.
2020-08-18Rename some variablesKévin Le Gouguec
2020-08-18Pass filters to generation scripts explicitlyKévin Le Gouguec
2020-08-18Mutualize pandoc invocationsKévin Le Gouguec
Will be useful to avoid duplicating changes to Lua filters.
2020-08-18Pass HTML template to scripts explicitlyKévin Le Gouguec
2020-08-18Move page generation to a scriptKévin Le Gouguec
Will reduce friction to code things cleanly.
2020-08-18Make "make clean" more thoroughKévin Le Gouguec
2020-08-13Remove workaround for IE versions older than 9Kévin Le Gouguec
They seem to be basically nonexistent now, as well as unsupported. Sources: https://netmarketshare.com/browser-market-share.aspx?id=browsersDesktopVersions https://analytics.wikimedia.org/dashboards/browsers/#desktop-site-by-browser/browser-family-and-major-tabular-view
2020-08-08Add default pandoc template for HTMLKévin Le Gouguec
2020-05-06Add verbose variable to MakefileKévin Le Gouguec
To make output more intelligible.
2020-04-29Fix links to internal pagesKévin Le Gouguec
Replace .md/.org extension with .html. The output of "make" is now ugly as sin.
2020-04-25Remove redundant title prefix on top-level indexKévin Le Gouguec
2020-04-20Parse site title from top-level READMEKévin Le Gouguec
Maybe not the best idea, since the dependency chain will trigger a site-wide rebuild everytime the README is edited. Ah well.
2020-04-19Stuff all temporary files in a "cache" folderKévin Le Gouguec
2020-04-16Touch up web page titlesKévin Le Gouguec
Still a few wrinkles to iron out, e.g. the toplevel page's <title>.
2020-04-12Refactor index generation slightlyKévin Le Gouguec
2020-04-12Add intermediate step to cache site treeKévin Le Gouguec
Seems kind of wasteful to recompute it every time. Also, now subsequent scripts don't have to care about file extensions anymore.
2020-04-12Finish fixing some files being inaccessibleKévin Le Gouguec
Make generate-deps.py compute the list of indices instead of relying on the list of source folders that contain text files, otherwise we will miss intermediate folders that do not contain any file. Remove TODO entry to maintain Makefile dependencies to scripts: that sounds too tedious. Let's assume that at some point the Makefile and these scripts will be bundled together into a proper package.
2020-04-12Start fixing some files being inaccessibleKévin Le Gouguec
If an intermediate folder contains no leaf page, the previous code does not add it to the parent directory's subfolders. Still needs support from generate-deps.py.
2020-03-29Unify recipe for regular and automated indicesKévin Le Gouguec
Also don't run pandoc in a pipeline within a Makefile recipe: pipefail is not set, so generate-index.py failures will not be bubbled up.
2020-03-25Complete READMEs with a page indexKévin Le Gouguec
2020-03-25Split index generation and HTML conversionKévin Le Gouguec
So that I can re-use generate-index.py for READMEs.
2020-03-24Produce auto-generated indices on stdoutKévin Le Gouguec
This way I can concatenate the output with regular indices.
2020-03-24Distinguish indices from regular pagesKévin Le Gouguec
So that I can add a special recipe for them, where I'll concatenate the directory index.
2020-03-15Note down need for custom HTML templateKévin Le Gouguec
2020-03-15Generate indices for folders without READMEsKévin Le Gouguec
2020-03-15Use git-ls-files(1) to compute list of source filesKévin Le Gouguec
It's not clear whether or not Python supports '\0' for null: the reference[1] says nothing about this specific escape sequence, but Python 3.7 seems to recognize it… repr('\0') says "'\\x00'", so let's use that. [1]: https://docs.python.org/3/reference/lexical_analysis.html#string-and-bytes-literals
2020-03-15Stop duplicating list of text file extensionsKévin Le Gouguec
2020-03-15Refactor dependency writer to make it easier to reason about indicesKévin Le Gouguec
2020-03-15Note down next improvements for website generationKévin Le Gouguec
2020-03-14Make path concatenation more to my likingKévin Le Gouguec
I prefer thinking of slashes as concatenation operators, always accompanied by operands on both sides. I don't like them hanging there at the end of my variables, which is what $(dir …) causes.
2020-03-14Establish a convention for makefile variablesKévin Le Gouguec
"Uppercase = public API, lowercase = internal plumbing".
2020-03-14Move dependency file to a variable and clean itKévin Le Gouguec
2020-03-14Let Makefile compute page foldersKévin Le Gouguec
Since it already computes the list of pages. I'm not comfortable with the pattern substitution, the implicit "slash management" is not obvious.
2020-03-14Update page list whenever folders changedKévin Le Gouguec
2020-03-14Note down improvement for dependency generatorKévin Le Gouguec
generated by cgit v1.2.3 (git 2.39.1) at 2025-12-06 14:11:53 +0000