rec/multi

📚 Manage my repositories 📚

📚 multi: Manage my repositories 📚

What to run if I...

Change the resumé

multi resume

Change the code or template for multi

multi mkdocs -f tag:production-ready --push

Change documentation for a project

multi mkdocs --push -p <project>

Add or change blog post

multi publish --push

Any project or tag changes

multi dashboard --push

Update a project's version

multi bump_version

multi's Issues

Make a new minor release for each project

There were enough changes, including adding typing, to justify this.

Tune up settings, themes

This guy https://jackdewinter.github.io/ has a complete set of instructions.

https://jackdewinter.github.io/2019/10/27/fine-tuning-pelican-connecting-with-readers/

Fix front page documentation (.md, .rst)

• 🎴: dek: The decorator-decorator 🎴
• 🗂: datacls: Take the edge off dataclass 🗂
• 🗜: gitz: Tiny useful git commands, some dangerous 🗜
• 🛎: impall: Test-import all modules below a given root 🛎
• 🧿: safer: A safer writer for files and streams 🧿
• ⛏: sproc: Subprocesseses for subhumanses ⛏
• 🌊: wavemap: Memory map WAVE or raw audio files 🌊
• 🌱: xmod: Turn any object into a module 🌱
• 🐜: abbrev: Tiny full-featured abbreviation expander 🐜
• 🖋: editor: Open the default text editor 🖋
• 🗃: tdir: Create and fill a temporary directory 🗃
• 🗝: dtyper: Make typer commands callable, or dataclasses 🗝

Change pelican settings

• organize into categories
• timestamp format
• consider times in the future as drafts
• more...

Finalize style settings

The red is a bit too much

Write rec/rec/README.md automatically

The top of the text is free form, but then there are four tables containing project descriptions and links to them:

production, beta, experimental and mothballed

which are generated automatically by multi.

Final tweak of resume

Unable to find https://rec.github.io/nc/assets/_mkdocstrings.css

And yet this file exists: https://github.com/rec/nc/blob/gh-pages/assets/_mkdocstrings.css

Fix anchor pointing to API documentation

Why can I not link to it?

Fix nc/README.md's generation

• Check all the other READMEs

Productionize `nc`

• Finish API documentation
• Edit test documentation
• Write color swath page and add to docs
• Proof whole page
• Push to rec.github.io
• Mark as production
• Build and push a new dashboard

Write a dozen articles

For each article

• write and preview in a branch
• use automatic dates and times
• replace the time with a future time
• pull into the main branch

Add badges for all projects

1. Come up with a comprehensive list
2. Add them automatically to each project

Set up some sort of blogging system on rec/rec

Requirements:

• development of articles in separate branches
• comments from users
• some reasonable preview workflow

Nice to have:

• markdown/uses mkdocs
• embedded execution of Python examples
• automatic publication of stories on a calendar or timetable

Final proofread

Automate and document a bit more what to do for each change.

• Change resume: multi resume
• Change code or template for multi: multi mkdocs -ftag:production-ready --push
• Change README for project: multi mkdocs --push -p <project>
• Change blog post: multi publish --push
• Any project changes multi dashboard --push
• Update a project's version: multi dump_version

Fix favico on rec.github.io

Add attribution links to color swatches

So people can answer the question, "Where did this come from?"

Fix favicons for safer and nc

Add `utterances` to the blog for comments

Found in proofreading

README.md needs a title:

• abbrev
• datacls
• impall
• xmod
• sproc
• editor
• safer
• dtyper (needs more)
• nc (needs more)

rec.github.io:

• datacls (remove API)
• impall (API Documentation header missing)

Fix nc/swatches directory or come up with a better link

`multi publish` command for pelican blog

• Correctly detects if there are any changes in the blog, or if anything has been published
• Builds
• Pushes

The first part is the hard part, because I know it creates deltas even if none of the source has changed. :-/

Finish generated documentation

• 🌊: https://rec.github.io/wavemap: Memory map WAVE or raw audio files 🌊
• 🌱: https://rec.github.io/xmod: Turn any object into a module 🌱
• 🗜: https://rec.github.io/gitz: Tiny useful git commands, some dangerous 🗜
• ⛏: https://rec.github.io/sproc: Subprocesseses for subhumanses ⛏
• 🧿: https://rec.github.io/safer: A safer writer for files and streams 🧿
• 🗃: https://rec.github.io/tdir: Create and fill a temporary directory 🗃
• 🗝: https://rec.github.io/dtyper: Make typer commands callable, or dataclasses 🗝
• 🖋: https://rec.github.io/editor: Open the default text editor 🖋
• 🗂: https://rec.github.io/datacls: Take the edge off dataclass 🗂
• 🛎: https://rec.github.io/impall: Test-import all modules below a given root 🛎
• 🐜: https://rec.github.io/abbrev: Tiny full-featured abbreviation expander 🐜
• 🎴: https://rec.github.io/dek: The decorator-decorator 🎴

Fix errors in resume