Initial commitHEADmaster

1 files changed, 78 insertions, 0 deletions

diff --git a/custom/README.md b/custom/README.md
new file mode 100644
index 0000000..a22aa38
--- /dev/null
+++ b/custom/README.md
@@ -0,0 +1,78 @@
+# My git repositories
+
+In this page you can find all my public git repositories. It is a collection
+of programs, tutorials, configuration files and more. All my repositories
+are also mirrored on [my GitHub page](https://github.com/sebastianotronto).
+
+Here are some highlights; for a full list, see [the index](../).
+
+## Programs
+
+* [ancient-projects](../ancient-projects) is a collection of my early coding
+  projects (2006-2010), mostly written in Java.
+* [nissy-core](../nissy-core) is my biggest hobby project. It is a Rubik's
+  cube solver focused on finding optimal solutions. It uses a standard A*
+  search method supported by a custom set of pruning tables. It can be
+  included as a library in your C, C++ or Python projects, and it can build
+  to [WebAssembly](https://en.wikipedia.org/wiki/WebAssembly).
+* [nissy-classic](../nissy-classic) is another Rubik's cube solver, focused
+  on assisting the user in exploring [domino
+  reduction](https://www.speedsolving.com/wiki/index.php/Domino_Reduction)
+  solutions.
+* [minesweeper](../minesweeper) is an unremarkable attempt at building a
+  graphical application with [raylib](https://www.raylib.com/) and
+  [Hare](https://harelang.org/).
+* [zmodn](../zmodn) is a small library for [integers modulo
+  N](https://en.wikipedia.org/wiki/Modular_arithmetic) written in
+  modern C++. I also ported it to Rust, see [zmodn-rs](../zmodn-rs).
+
+## Configuration, scripts and website sources
+
+* [config](../config) contains the configuration files (a.k.a. dotfiles) for
+  my Alpine Linux laptop setup, as well as a collection of scripts for my
+  daily desktop use.
+* [sebastiano.tronto.net](../sebastiano.tronto.net) contains the source code
+  (Markdown) for [my personal website](https://sebastiano.tronto.net),
+  including template HTML and CSS files, and build scripts.
+* [cgit-config](../cgit-config) contains the configuration files for this
+  cgit page.
+
+## Programming challenges
+
+* [aoc](../aoc) contains my solutions to (some of) the [Advent of
+  Code](https://adventofcode.com) problems.
+* [cses](../cses) contains my solutions to (some of) the
+  [cses.fi](https://cses.fi) problems.
+
+## Math
+
+* [ecm](../ecm) is a Python implementation of the
+  [Elliptic Curve factorization
+  Method](https://en.wikipedia.org/wiki/Lenstra_elliptic-curve_factorization)
+  that I have used for a couple of
+  [talks](https://sebastiano.tronto.net/talks).
+* [kummer-degrees](../kummer-degrees) is a
+  [SageMath](https://www.sagemath.org/) library to compute
+  the degrees of [Kummer extensions](https://en.wikipedia.org/wiki/Kummer_theory)
+  over the rational numbers.
+* [mathsoftware](../mathsoftware) containes slides, exercises and references
+  for the course Mathematical Software that I taught at the
+  [University of Luxembourg](https://uni.lu) in the Fall of 2021.
+* [arithmeticbilliard](../arithmeticbilliard) contains code for [Arithmetic
+  Billiard](https://en.wikipedia.org/wiki/Arithmetic_billiards) simulations.
+* [platonicsolids](../platonicsolids) is a collection of Latex files for
+  drawing [Platonic solids](https://en.wikipedia.org/wiki/Platonic_solid)
+  with [TikZ](https://en.wikipedia.org/wiki/PGF/TikZ).
+
+## Tutorials and proofs of concept
+
+* [fmctutorial](../fmctutorial) is my tutorial for
+  [solving the Rubik's Cube](https://sebastiano.tronto.net/speedcubing)
+  in as few moves as possible. You can download the pdf from
+  [fmcsolves.cubing.net](https://fmcsolves.cubing.net).
+* [emscripten-tutorial](../emscripten-tutorial) contains the codes for
+  the example of [a blog post of
+  mine](https://sebastiano.tronto.net/blog/2025-06-06-webdev) about
+  [WebAssembly](https://en.wikipedia.org/wiki/WebAssembly)
+  and [Emscripten](https://en.wikipedia.org/wiki/Emscripten).
+* [python-c](../python) is a minimal example of Python module written in C.