aboutsummaryrefslogtreecommitdiff
path: root/doc (follow)
Commit message (Collapse)AuthorAgeFilesLines
* Replace left-over usage of git.euandreh.xyzEuAndreh2022-01-164-4/+4
|
* Update translationsEuAndreh2022-01-153-3/+3
|
* doc/manpages.sh: Quote variables inside variable expansion (ShellCheck offense)EuAndreh2022-01-151-3/+3
|
* Replace git.euandreh.xyz/xxx with euandreh.xyz/xxx.gitEuAndreh2021-10-114-8/+8
|
* TODOs.md: Rename ids to #td-... over #(task|bug|...)-...EuAndreh2021-10-034-10/+10
| | | | | The goal is to make a TODO entry be able to move category, say from a question to a decision, without chaging its id.
* Enable darkmode for ci.html and manpages HTMLEuAndreh2021-09-201-1/+9
|
* mv aux/workflow/manpages.sh doc/manpages.shEuAndreh2021-08-061-0/+68
|
* Add trailing /en/ to all default URLs, and the equivalent for translationsEuAndreh2021-07-154-4/+4
|
* git mv doc/spelling/ po/EuAndreh2021-07-085-149/+0
|
* Put pofiles under po/, use one folder for each translated file.EuAndreh2021-07-073-1526/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | This is an improvement over 67f7c956239a7bc811a1d655d389666048e45fc3, and a final step for #task-7c5cd2aa-6d92-0423-bfa7-81f2e8436586. Now instead of trying to convince po4a and mdpo to work together, each tools gets it own folder and a pofile for each language. This means that if I want to translate files FOO.md and a-dir/BAR.txt to pt and fr, the directory structure of po/ will be: po/ FOO.md/ pt.po fr.po a-dir/ BAR.txt/ pt.po fr.po The po/ folder mirrors the directory structure of the input files, also nesting down directories. This way mdpo can do extration and update on its own way, and po4a can do extraction and update on its on way. The downside is that some translations will be duplicated, because they can appear on more than one file.
* TODOs.md: spellcheckEuAndreh2021-06-261-2/+4
|
* git mv po/ doc/po/EuAndreh2021-06-253-0/+1526
|
* aux/workflow/assert-spelling.sh: Add; init dictionaries; fix spellingEuAndreh2021-06-258-22/+169
| | | | | | - aux/workflow/l10n.sh: fix handling of $@; - Makefile: remove circular dependency between dev-check and public by adding the "l10n-gen" target.
* aux/workflow/manpages.sh: Refactor how manpages and translations are madeEuAndreh2021-06-234-0/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | I didn't like the previous version of aux/workflow/manpages.sh mainly for 2 reasons: 1. its CLI was terrible, ugly and fragile; 2. it mixed handling manpages and handling *translations*. The first step was to split the translations part to a different file: aux/workflow/l10n.sh. Now it has the base logic for running po4a, and can apply it to manpages. It is useful for updating translated files in other scenarios, such as catgets() message catalogs, markdown files, etc. After I used the venerable getopts to handle the command line arguments, and give aux/workflow/manpages.sh a saner interface. I disliked the fact that aux/workflow/manpages.sh still is being used for the "install" and "uninstall" targets. Before this file, the canonical workflow of "make && make install/uninstall" was 100% embedded within the Makefile itself. But now the Makefile calls to an external script for that. This isn't a real cost, other than how obvious the behaviour is for someone looking at the Makefile for the first time. I still chose to do it anyway, because there was already too many things in the Makefile itself, and it was getting worse with time. I made sure to never cross the line of relying on an external tool for the canonical "make && make install/uninstall", and even for "make check". Those all work without requiring any extra tool outside what POSIX defines, such as "sed", "awk", etc. Despite the cost of adding this detour from the liner Makefile flow, I found it to be worth it to call to the external script, as this script can now also be shared across projects, and the customized Makefile be made simpler. In other to remove the "-- $(do_subst)" horrendous hack, I chose to use an inference rule for ".in" files, and remove the "$(do_subst)" variable altogether. Now all the files that need to go through sed should end in ".in", and the Makefile will take care of producing it. The upside is that this model is much better integrater into make itself. Addresses #task-9ee2bbc8-295f-52b7-4104-483869bad017.
* git mv doc/*.po po/EuAndreh2021-06-233-1526/+0
|
* doc/: s/SYNOPSYS/SYNOPSIS/EuAndreh2021-06-224-10/+10
|
* Add small example of using -- on manpageEuAndreh2021-06-227-62/+135
|
* doc/git-permalink.*.1: Mark SUPPORTED REMOTES and OVERRIDES as .SSEuAndreh2021-06-217-520/+542
| | | | | | | Make SUPPORTED REMOTES and OVERRIDES subsections (.SS) of a new parent section: CONFIGURATIONS. Also put SUPPORTED REMOTES before OVERRIDES on the order.
* doc/git-permalink.*.1: Mark OPTIONS as to be replacedEuAndreh2021-06-217-16/+16
| | | | Also improve french translation: s/FICHIERS/FICHIER/.
* doc/git-permalink.*.1: Add `EXIT STATUS` section; mention `STDOUT` in `-p` ↵EuAndreh2021-06-217-56/+256
| | | | option
* doc/pt.po: Fix typo s/OPÇÔES/OPÇÕES/EuAndreh2021-06-202-3/+3
|
* doc/: Add new supported forges to the manpagesEuAndreh2021-06-197-75/+196
|
* Leverage po4a to translate manpagesEuAndreh2021-06-197-9/+1783
|
* doc/git-permalink.1: Add period at the end of NAMEEuAndreh2021-06-161-1/+1
|
* aux/workflow/assert-manpages.sh: Fix link to mailing listEuAndreh2021-06-161-1/+1
|
* Show -h and -V flags on usage textEuAndreh2021-06-161-1/+1
|
* s/Home page/Homepage/EuAndreh2021-06-161-1/+1
|
* doc/git-permalink.1: Stop using ".P", use empty lines insteadEuAndreh2021-06-161-82/+78
|
* doc/git-permalink.1: Fix links at the bottomEuAndreh2021-06-141-10/+12
|
* doc/git-permalink.1: Write initial versionEuAndreh2021-06-121-0/+157
|
* doc/git-permalink.1: Add empty fileEuAndreh2021-06-121-0/+0