path: root/TODOs.md

# Tasks

## TODO Hand pick trackers for the generated torrents {#td-5cab66be-9f82-4d25-de87-fc6392c3b26f}
- TODO in 2022-06-04

## TODO Consider using `.DEFAULT` to move all of `Makefile` into `dynamic.mk` {#td-330c7f45-2c2d-6066-b1a0-4357f7b09259}
- TODO in 2022-06-01

---

As in:

```
.DEFAULT:
	$(MAKE) -f dynamic.mk $<
```

## TODO Use Opus over Ogg for podcasts {#td-2de2f57c-0773-530f-f6cf-70836080f46f}
- TODO in 2022-06-01

## TODO Remove absolute path with `/`?  Use `base-url`? {#td-c409cad6-6660-81d8-b7ad-a0d61329ef3c}
- TODO in 2022-06-01

## TODO When doing a deploy, cleanup public/ to ensure there is a rebuild {#td-f1ee23c0-b10a-a044-8351-e3cef4cb9d8c}
- TODO in 2022-05-02

## TODO Remove torrent files {#td-61f75b7a-aeab-91bf-d927-7766253faec7}
- TODO in 2022-04-20

---

Require less software: both `mktorrent` and online TURN/STUN servers.

## TODO Assert code blocks stick to atmost 80 columns {#td-75506021-884a-af77-ffbe-448816f70cc5}
- TODO in 2022-04-20

## TODO Detect linkrot {#td-dba2ff82-59b3-dd17-06a9-edbc9cffb264}
- TODO in 2022-04-13

## TODO Revisit favicon references without links in articles {#td-3996432b-c5b8-a003-db82-c684035f58d5}
- TODO in 2022-04-12

## TODO Add link to public inbox in homepage {#td-a81fc81f-9d58-101f-fa4f-2ce4cab63173}
- TODO in 2022-04-11

## TODO Revisit `README.md` {#td-181014da-abbd-fbc3-ed42-a2c2d89f12a7}
- TODO in 2022-03-25

## TODO Rename pkgs.{nologin => shadow} {#td-db77b6f1-3044-e457-1672-5cf4314b47b2}
- TODO in 2022-03-14

## TODO Decouble title from URL {#td-233e5dde-b13e-a795-cc73-c031bd56c03c}
- TODO in 2022-03-06

## DOING Add `security.txt` {#td-a84b65c4-686c-c098-aa4b-cfba06a84825}
- DOING in 2022-04-12

  Add the `.well-known/security.txt` file, with a `security.txt` symlink.

  Done in
  [`764b6f4d312ed6a68d8591447bbcc1ba1e13f272`](https://euandre.org/git/euandre.org/commit/?id=764b6f4d312ed6a68d8591447bbcc1ba1e13f272).
- TODO in 2022-03-06

---

Add check to ensure that its `Expires` field is in sync with the refreshed GPG
key, and that this file in `euandre.org` is also in sync with `euandreh.xyz` and
other domains.

Probably just:
```
Contact: mailto:eu@euandre.org
Expires: 2022-07-12T03:00:00.000Z
Encryption: https://euandre.org/public-key.txt
Preferred-Languages: en, pt, fr, eo, es
```

## TODO Replace Jekyll with a Makefile {#td-e795e852-a836-edae-0f95-48b28096ea9a}
- TODO in 2022-03-06

---

Consider using [m4] for templating.

[m4]: http://mbreen.com/m4.html

## TODO Test robustness and responsiveness of HTML/CSS {#td-c76a7c83-20d2-a2cc-b48a-8499c6ca5b69}
- TODO in 2022-03-06

---

As described in <https://news.ycombinator.com/item?id=29519391>.

## TODO Serve over Gemini and/or Gopher too {#td-2fde23a6-1389-30fa-34ac-7d6750abf08a}
- TODO in 2022-03-06

## TODO Recover `mktorrent` flags, in `Makefile.dynamic` {#td-d5370885-16f3-acf8-7e7a-a65d794242ee}
- TODO in 2022-01-16

## TODO FIXME {#td-ca1035f1-dadf-1f10-c371-d4f2bca682cb}
- TODO in 2022-01-16

---

The repository itself is about to be embedded under
`resources/attachments/`.

## TODO Cleanup `.gitignore` {#td-f52abfa9-1fbc-bcc6-048b-d4d770f571fc}
- TODO in 2022-01-16

## TODO Consider removing PNG and ICO favicons {#td-8876fc14-7f24-ebb1-4e60-adad79442005}
- TODO in 2022-01-10

## TODO Send patch to upstream `bmake` for bug on `$*` macro {#td-ca621da2-2e94-ae6f-0e3d-db744c00a656}
- TODO in 2021-11-21

---

From the standard:

```txt
$*      The $* macro shall evaluate to the current target name with its suf‐
        fix deleted. It shall be evaluated at least for inference rules.

        For example, in the .c.a inference rule, $*.o represents the out-of-
        date .o file that corresponds to the prerequisite .c file.
```

Given the Makefile:

```makefile
.POSIX:

.SUFFIXES: .x .y

.x.y:
        cp $< $*.y

all: a/b.y
```

`bmake` works correctly without flags, but behaves incorrectly with `-j1`:

```shell
$ mkdir a && touch a/b.x
$ make -j1
cp a/b.x b.y
$ make
cp a/b.x a/b.y
```

This impacts the upcoming `lilypond -o $name` command in the Makefile.


## TODO Move content into `src/content/`, `bin/` into `src/bin/` {#td-f9b510c0-c2c5-638e-e00f-3bbd35de31d9}
- TODO in 2022-01-10

## TODO `resources/` -> `artifacts/` {#td-d985f05d-3ecb-fc43-986b-b7089d17515d}
- TODO in 2021-10-12

---

`assets/`?

## TODO `locale/` -> `po/` {#td-d282e753-9b2c-cd86-e64b-9148c5e84baf}
- TODO in 2021-10-12

## TODO Verify SVG now with size render better {#td-324de4da-0385-e832-0e4e-9f757efc9795}
- TODO in 2021-10-12

## TODO Use PostScript instead of Reveal.js {#td-6449803d-5774-b345-fde8-ad734af43e36}
- TODO in 2021-10-12

---

<i>À la</i> <https://github.com/jroimartin/ssg/>.

## TODO Remove `alt` from some icons {#td-d01a98aa-ef1e-cb21-8cba-7325d98b3db0}
- TODO in 2021-10-12

## TODO Use CSS validator {#td-bedfe310-4308-6160-0c63-78fa216b6ee1}
- TODO in 2021-10-12

---

<https://jigsaw.w3.org/css-validator/>

## TODO Reduce size of container image {#td-826dd92f-ba91-b7b4-1fcc-e5240f920e99}
- TODO in 2021-10-12

## TODO Enable directory listing on the server {#td-5a13db85-6ff1-ddde-b9cc-a0ddd2de5333}
- TODO in 2021-10-12

## TODO Setup CSS dark mode {#td-d85f64b1-24c2-efe5-f214-c4e5a0b9ea31}
- TODO in 2021-10-12

---

```css
:root {
  --color: black;
  --background-color: white;
}

@media(prefers-color-scheme: dark) {
  :root {
    --color: white;
    --background-color: black;
  }
}
```

## TODO Remove dependency on Jekyll {#td-94511264-e301-be51-23e2-cf960dcd603d}
- TODO in 2021-10-02

---

Possibly also remove usage of markdown.
Either stick to CommonMark, or switch to plain HTML, or maybe asciidoc (once it
gets its specification).

## TODO Add JID alongside email {#task-089dca19-14e2-e1c1-6a47-9af6ab8eb42a}
- TODO in 2021-09-05

## TODO Use `<time>` tag for dates? {#task-a5ea943a-24f0-ac01-85b6-83490fe0e868}
- TODO in 2021-08-14

## TODO Manage translations in `_config.yml` and `_includes/public-inbox.html` with gettext {#task-041e3208-a497-f29c-23cd-9068b2c1d86e}
- TODO in 2021-07-20

## TODO Use `POSIX` over `C.UTF-8` in `$LANG` {#task-a98cd8d2-8376-0f4c-7cc1-6cb26434ac54}
- TODO in 2021-06-22

## TODO Always add assets generated by plugins to `site.static_files` {#task-3cf42559-3713-02c6-bba3-af5bac5512a7}
- TODO in 2021-06-13

## TODO Publish site on CI instead of my local machine {#task-6a3a99ec-dd86-b8b3-b1eb-f9b9a4298f3a}
- TODO in 2021-06-07

## TODO Generate Opus for podcast {#task-93510453-111f-9b1f-575f-ca8c7c05883c}
- TODO in 2021-06-07

## TODO Generate PDFs for slides {#task-d2ef646f-6232-d82f-dd77-507c6981ee80}
- TODO in 2021-06-07

## TODO Podcast metadata: copy GNU World Order {#task-7b0aeb8d-282b-7ebf-4c5f-65c6cac1f0a1}
- TODO in 2021-06-07

## TODO Publish over Gemini {#task-319021df-ebdb-40cd-8330-329e8d01b747}
- TODO in 2021-02-22

## TODO Improve CSS of navigation bar {#task-ddd3795b-fd89-4d68-a78b-6adcb4702f92}
- TODO in 2021-02-21

---

It doesn't resize well for small screens, and links are too small and close to each other.

## TODO Screnncasts: Use scriptreplay and asciinema {#task-98a68a93-1294-4283-a78f-9b7f1150c729}
- TODO in 2021-02-11

## TODO Add hunspell dictionaries {#task-67783646-ef33-488b-a1d2-3ecd0b12dbb3}
- TODO in 2021-02-11

## TODO Shrink size of links at the end of slides {#task-7a53af07-57bf-4684-97c5-af43279848c0}
- TODO in 2021-02-11

## TODO Improve workflow when adding media/breaking build with Git Annex symlink {#task-d3300610-6c8e-4681-8ccb-a516b0f57d2a}
- TODO in 2021-02-07

## TODO Add "view source" link to pages {#task-335bf01c-5549-4a5a-9ad1-7e5b68f12cb6}
- TODO in 2021-02-05

---

Point to the source code on the Git repository.

## TODO Update "remembering" link {#task-b60b2559-e1e1-4f60-8e20-b919ebf1da43}
- TODO in 2021-01-26

## TODO Move to LilyPond 2.22.0 {#task-34d239aa-8984-4b34-9c6e-1cc2ca8d49fc}
- TODO in 2021-01-12

## DONE `dengoso.ly` [9/9] {#task-95ac1eec-1a56-47cb-b7ad-8cadf5737323}
- DONE in 2021-01-03
- TODO in 2021-01-01

---

- [X] use "<quarter> = 100" over "Andante moderato for `meter`
- [X] turn `cWithSlash` into a function
- [X] move `pestana=` into shared `pestana.ly`
- [X] ~~use fret-number over roman string on `pestana #"II" { }`~~
- [X] `6 to D` on beginning of the song
- [X] share notes between voices
- [X] add string markers
- [X] pestana over rests (measure 42)
- [X] handle optional sharp on measure 77

## TODO `choro-da-saudade.ly` [0/2] {#task-04afbdc0-4e2c-4176-b7c3-0c04087c09a8}
- TODO in 2021-01-03

---

- [ ] Make `D.S. al Coda` appear in MIDI

  ```lilypond
  bar ".."^markup { D.S. al Coda }
  cadenzaOn
  stopStaff
  once override TextScript.extra-offset = #'(0 . -3)
  <>^markup { D.S. al Coda }
  repeat unfold 3 {
    s1
    bar ""
  }
  cadenzaOff
  startStaff
  ```

## TODO `marcha-dos-marinheiros.ly` {#task-bbc19f19-ca4f-4cbf-bc4d-e119ad06deef}
- TODO in 2021-01-03

## DONE Embed LilyPond source code in PDF and audio {#task-340da973-622c-45d6-8d3c-7db839586517}
- DONE in 2021-01-03

  Done in 
  [`bff2b07922272fd4c8f9ee0a7129d0a7c134dd38`](https://euandre.org/git/euandre.org/commit/?id=bff2b07922272fd4c8f9ee0a7129d0a7c134dd38).
- TODO in 2021-01-03

---

Use the `embed-source-code` options:

```scheme
#(ly:set-option 'embed-source-code #t)
```

## TODO Add torrent for audio in `music-listing.html` {#task-aa314475-6a19-48fe-a752-7c479ad26be2}
- TODO in 2021-01-03

---

Torrent for PDF, too?

## TODO Investigate the ICE STUN/TURN servers used by WebTorrent {#task-c7e75b41-d86e-423b-b4a1-7d193c3a6ef1}
- TODO in 2021-01-07

---

Depending on the provider, maybe host my own, like
[coturn](https://github.com/coturn/coturn).

## DONE Generate `favicon.ico` from `favicon.svg` {#task-720e79b4-9e38-41c6-9958-cdadd67d2298}
- DONE in 2021-01-03

  Done in 
  [`433428cf6b4ef8a653f349e0a0d1fa0d10aab1e7`](https://euandre.org/git/euandre.org/commit/?id=bff2b07922272fd4c8f9ee0a7129d0a7c134dd38).
- TODO in 2021-01-01

## DONE Move `assert-content.sh` to Ruby {#task-a7b6b371-100c-48f4-a448-bfa39f88efce}
- DONE in 2020-12-24
- TODO in 2020-12-23

---

Asserts will be faster since things will be already in memory.

Should the generator for the torrents put the torrent files in the
source tree? Are torrents source files or build artifacts?

## DONE Add page to listen an watch files with WebTorrent {#task-e5d2be9d-6471-40ba-a2d3-c7bc482bfaba}
- DONE in 2020-12-24
- TODO in 2020-12-23

## DONE Add "web" Git Annex remote support {#task-c41d11b0-4235-4e8c-8e2b-bbbec7ee5c0b}
- DONE in 2020-12-27

  Done in 
  [`56da1a73ac0c211fbb14447b9175660d6757e795`](https://euandre.org/git/euandre.org/commit/?id=56da1a73ac0c211fbb14447b9175660d6757e795).
- TODO in 2020-12-23

## DONE Use SVG favicon {#task-29f1bded-3a56-410b-933d-e6a11f47656a}
- DONE in 2020-12-27

  Link (with `<link />` tag) to SVG favicon inside of `<head>` isntead
  of converting from SVG to ICO.
- TODO in 2020-12-24

---

Taken from <https://news.ycombinator.com/item?id=25520655>:

```shell
$ inkscape -o icon-48x48.png -w 48 -h 48 icon.svg
$ convert icon-48x48.png favicon.ico
```

## DONE Create screencasts collection {#task-fb8e4ad8-7c8b-4b62-a4f2-5f16f84ec7e6}
- DONE in 2020-12-24
- TODO in 2020-12-24

## DONE Add webtorrent-hybrid daemon {#task-1a2f5619-5d55-449f-a401-8c87afd5bea9}
- DONE in 2020-12-28

  Instead of a daemon, added ~/archive/torrent/ as a watch directory
  to Transmission. It doesn't work with WebRTC (yet), so Transmission
  will only upload to other TCP nodes.
- TODO in 2020-12-24

## DONE Simplify `link-listing.html` by not requiring `entries` {#task-28dd5b16-1e32-42d4-960e-27a8725fe0b9}
- DONE in 2020-12-24
- TODO in 2020-12-24

## DONE Use `.mkv` over `.webm` for embedding subtitles {#task-6587304c-ee0d-4f40-b046-48de94d00629}
- DONE in 2020-12-28

  I didn't find the issues with web browsers easier to deal with
  using WebM files. I'll keep MKV and investigate further later.

  See also 
  [`#task-9d75fe3a-b7e5-4cc5-9300-1054c7e981c0`](#task-9d75fe3a-b7e5-4cc5-9300-1054c7e981c0).

- CANCELLED in 2020-12-28

  WebM is more web friendly than MKV. Right now there is no support
  for subtitles, only translated screencasts.

- DONE in 2020-12-24
- TODO in 2020-12-24

## DONE Make media path the same as the show notes path {#task-7535169e-715e-409b-88c3-78c4bb482d95}
- DONE in 2020-12-28

  Done in
  [`4d7a8207ee0931a157904cc58255d1950fa46178`](https://euandre.org/git/euandre.org/commit/?id=4d7a8207ee0931a157904cc58255d1950fa46178).
- TODO in 2020-12-27

## DONE Assert media files have metadata {#task-8d8a9202-97d4-4c43-b042-15fd5c95da65}
- DONE in 2020-12-28

  Audio done in
  [`e07ff2a1928be00bb7f7eb7fc82c8447a581c58f`](https://euandre.org/git/euandre.org/commit/?id=e07ff2a1928be00bb7f7eb7fc82c8447a581c58f),
  and video done in
  [`9bd53de5a956c34f9ef41695e878bdd4b3df1697`](https://euandre.org/git/euandre.org/commit/?id=9bd53de5a956c34f9ef41695e878bdd4b3df1697).

- TODO in 2020-12-27

## DONE Fix play of videos with WebTorrent {#task-9d75fe3a-b7e5-4cc5-9300-1054c7e981c0}
- DONE in 2020-12-28

  Done when moved to WebM. Firefox gives an error when loading the
  file directly, and a different error when loading with WebTorrent.
  I'll call this a Firefox error, since Chromium was able to play the
  video on both, since both the file creation and serving are pretty
  straighforward.

  When loading the file directly, Firefox says with `console.warn()`:

  ```
  Media resource https://euandre.org/screencast/2020/12/24/sample-screencast.webm could not be decoded, error: Error Code: NS_ERROR_DOM_MEDIA_DECODE_ERR (0x806e0004)
  Details: virtual mozilla::MediaResult mozilla::FFmpegVideoDecoder<46465650>::DoDecode(mozilla::MediaRawData*, uint8_t*, int, bool*, mozilla::MediaDataDecoder::DecodedData&): avcodec_send_packet error: -1
  ```

  When loading with WebTorrent, Firefox says with `console.error()`:

  ```
  Uncaught Error: XDR encoding failure
  ```

- TODO in 2020-12-28

---

Ressurect the WebM file when experimenting with:

```shell
$ git revert 2beab5441b4fcddc849cfc44b99547d49593691d
```

# Bugs

# Improvements

## TODO `dengoso.ly` [0/1] {#improvement-fd989cc2-b638-4943-8109-b8e3cac0aae1}
- TODO in 2021-01-03

---

- [ ] measures 21~24: map previous notes, removing fingering notation instead of repeating notes

## TODO Music sources {#improvement-610ed926-cc5e-418a-b046-27f4c4862d0d}
- TODO in 2021-01-04

[Barrios](https://imslp.org/wiki/Category:Barrios_Mangor%C3%A9,_Agust%C3%ADn)
(public domain),
[Villa-Lobos](https://imslp.org/wiki/Category:Villa-Lobos,_Heitor)
(public domain in 2030) and Garoto (public domain in 2026)

# Questions

## DONE Why insist on having `.ogg` files, but not the same for video? {#question-8203fbce-be76-4cc3-a62a-15f91bf22051}
- DONE in 2020-12-24
- TODO in 2020-12-24

---

Because of subtitle embedding.

# Resources

## For bitmat images compression:

- <https://github.com/hbldh/hitherdither>

# Scratch


Test editing files with ":set wm=80"
Update static/attachments/autoqemu.tar.gz and other files
mktorrent

Future-proof wesite (and also later software):
- remove Jekyll
- remove markdown, or embed markdown process, and write in HTML directly (and maybe commit the HTML)
- commit directly most derived data, such as torrent files, ogg media, SVG from graphviz input, etc., so that the absence of those tools don't impede the generation of existing pages of the website.
Move brinquedoteca out of jekyll?



FIXMEs:
- DIY:
  - CommonMark parser
  - envsubst, with errors on undefined variables
  - `date -d` isn't POSIX: simple replacement
- translation not coming from english (like pt -> fr)
- add linkchecker
- how to use tmp fd over tmpfile?
- po4a for markdown...
- render slides
- shrink CSS
- build makemake output in parallel
- remove the need for makemake: it is the slowest step, and sometimes breaks the
  Makefile graph