Add tags to docs

LivInTheLookingGlass · Aug 16, 2024 · 706bd12 · 706bd12
1 parent 6bb2669
commit 706bd12
Show file tree

Hide file tree

Showing 243 changed files with 466 additions and 48 deletions.
diff --git a/.gitignore b/.gitignore
@@ -24,4 +24,5 @@ docs/_build
 **/coverage
 **/dist/*
 javascript/src/lib/fallbacks
-docs/languages*.svg
+docs/languages*.svg
+docs/_tags
diff --git a/cplusplus/src/include/macros.h → cplusplus/src/include/macros.hpp b/cplusplus/src/include/macros.h → cplusplus/src/include/macros.hpp
diff --git a/cplusplus/src/include/math.h → cplusplus/src/include/math.hpp b/cplusplus/src/include/math.h → cplusplus/src/include/math.hpp
@@ -1,7 +1,7 @@
 #ifndef EULER_MATH_H
 #define EULER_MATH_H
 
-#include "macros.h"
+#include "macros.hpp"
 #include <math.h>
 #include <stdlib.h>
 #include <stdint.h>

diff --git a/cplusplus/src/include/utils.h → cplusplus/src/include/utils.hpp b/cplusplus/src/include/utils.h → cplusplus/src/include/utils.hpp
diff --git a/cplusplus/src/p0015.cpp b/cplusplus/src/p0015.cpp
@@ -18,7 +18,7 @@ How many such routes are there through a 20×20 grid?
 #define EULER_P0015
 #include <stdint.h>
 #include <iostream>
-#include "include/math.h"
+#include "include/math.hpp"
 
 #define lattice_paths(height, width) (n_choose_r(height + width, height))
 

diff --git a/cplusplus/src/p0022.cpp b/cplusplus/src/p0022.cpp
@@ -18,7 +18,7 @@
 #include <iostream>
 #include <vector>
 #include <algorithm>
-#include "include/utils.h"
+#include "include/utils.hpp"
 
 uint64_t p0022() {
     uint64_t answer = 0;

diff --git a/cplusplus/src/p0034.cpp b/cplusplus/src/p0034.cpp
@@ -15,7 +15,7 @@ Note: as 1! = 1 and 2! = 2 are not sums they are not included.
 #include <stdint.h>
 #include <iostream>
 #include <cstdio>
-#include "include/math.h"
+#include "include/math.hpp"
 
 uint64_t p0034() {
     uint64_t answer = 0, sum;

diff --git a/cplusplus/src/p0076.cpp b/cplusplus/src/p0076.cpp
@@ -42,7 +42,7 @@ positive integers?
 #define EULER_P0076
 #include <stdint.h>
 #include <iostream>
-#include "include/macros.h"
+#include "include/macros.hpp"
 
 uint32_t p0076() {
     uint32_t answer = 0;

diff --git a/cplusplus/src/tests/test_compiler_macros.cpp b/cplusplus/src/tests/test_compiler_macros.cpp
@@ -1,5 +1,5 @@
 #include <stdio.h>
-#include "../include/macros.h"
+#include "../include/macros.hpp"
 
 int main(int argc, char const *argv[]) {
     printf(

diff --git a/docs/_static/style.css b/docs/_static/style.css
@@ -0,0 +1,3 @@
+.rst-content .toctree-wrapper:not(:last-child) ul {
+    margin-bottom: 10px;
+}
diff --git a/docs/conf.py b/docs/conf.py
@@ -53,6 +53,9 @@
 rust_crates = [
     "../rust",
 ]
+html_css_files = [
+    'style.css',
+]
 
 try:
     check_call(['rpm-ostree', '--version'])

diff --git a/docs/index.rst b/docs/index.rst
@@ -241,6 +241,10 @@ Problems Solved
 
    usage
    src/*
+
+.. toctree::
+   :maxdepth: 1
+
    _tags/tagsindex
 
 Indices and tables

diff --git a/docs/src/c.rst b/docs/src/c.rst
@@ -10,7 +10,6 @@ Library Code
 
 .. toctree::
    :glob:
-   :numbered:
    :maxdepth: 1
 
    c/lib/*
@@ -20,7 +19,6 @@ Problems Solved
 
 .. toctree::
    :glob:
-   :numbered:
    :maxdepth: 1
 
    c/p[0-9][0-9][0-9][0-9]
diff --git a/docs/src/c/lib/bcd.rst b/docs/src/c/lib/bcd.rst
@@ -127,3 +127,5 @@ It was also a good exercise in x86 assembly, as several portions are accellerate
 .. literalinclude:: ../../../../c/src/include/bcd.h
    :language: C
    :linenos:
+
+.. tags:: large-numbers
diff --git a/docs/src/c/lib/digits.rst b/docs/src/c/lib/digits.rst
@@ -50,3 +50,5 @@ Includes
 .. literalinclude:: ../../../../c/src/include/digits.h
    :language: C
    :linenos:
+
+.. tags:: c-iterator
diff --git a/docs/src/c/lib/factors.rst b/docs/src/c/lib/factors.rst
@@ -39,4 +39,6 @@ factors for a given number. It is generally used by first calling
 
 .. literalinclude:: ../../../../c/src/include/factors.h
    :language: C
-   :linenos:
+   :linenos:
+
+.. tags:: factorization, divisor-count, c-iterator
diff --git a/docs/src/c/lib/fibonacci.rst b/docs/src/c/lib/fibonacci.rst
@@ -47,4 +47,6 @@ Includes
 
 .. literalinclude:: ../../../../c/src/include/fibonacci.h
    :language: C
-   :linenos:
+   :linenos:
+
+.. tags:: c-iterator, fibonacci-number
diff --git a/docs/src/c/lib/iterator.rst b/docs/src/c/lib/iterator.rst
@@ -114,4 +114,6 @@ Includes
 
 .. literalinclude:: ../../../../c/src/include/iterator.h
    :language: C
-   :linenos:
+   :linenos:
+
+.. tags:: c-iterator
diff --git a/docs/src/c/lib/primes.rst b/docs/src/c/lib/primes.rst
@@ -145,4 +145,6 @@ Includes
 
 .. literalinclude:: ../../../../c/src/include/primes.h
    :language: C
-   :linenos:
+   :linenos:
+
+.. tags:: prime-number, divisibility, factorization, c-iterator
diff --git a/docs/src/c/lib/utils.rst b/docs/src/c/lib/utils.rst
@@ -16,3 +16,5 @@ View source code :source:`c/src/include/utils.h`
 .. literalinclude:: ../../../../c/src/include/utils.h
    :language: C
    :linenos:
+
+.. tags:: file-io
diff --git a/docs/src/c/p0001.rst b/docs/src/c/p0001.rst
@@ -23,3 +23,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0001.c
    :language: C
    :linenos:
+
+.. tags:: c-iterator, divisibility
diff --git a/docs/src/c/p0002.rst b/docs/src/c/p0002.rst
@@ -23,3 +23,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0002.c
    :language: C
    :linenos:
+
+.. tags:: c-iterator, divisibility, fibonacci-number
diff --git a/docs/src/c/p0003.rst b/docs/src/c/p0003.rst
@@ -24,5 +24,5 @@ Solution
    :language: C
    :linenos:
 
-.. tags:: c-iterator factorization prime-number
+.. tags:: c-iterator, factorization, prime-number
 
diff --git a/docs/src/c/p0004.rst b/docs/src/c/p0004.rst
@@ -6,7 +6,7 @@ View source code :source:`c/src/p0004.c`
 Includes
 --------
 
-- `iterator.h <./lib/digits.html>`__
+- `digits.h <./lib/digits.html>`__
 
 Solution
 --------
@@ -23,3 +23,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0004.c
    :language: C
    :linenos:
+
+.. tags:: c-iterator, palindrome
diff --git a/docs/src/c/p0005.rst b/docs/src/c/p0005.rst
@@ -24,3 +24,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0005.c
    :language: C
    :linenos:
+
+.. tags:: c-iterator, divisibility, factorization, prime-number
diff --git a/docs/src/c/p0006.rst b/docs/src/c/p0006.rst
@@ -18,3 +18,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0006.c
    :language: C
    :linenos:
+
+.. tags:: arithmetic-progression, sequence-summation
diff --git a/docs/src/c/p0007.rst b/docs/src/c/p0007.rst
@@ -23,3 +23,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0007.c
    :language: C
    :linenos:
+
+.. tags:: c-iterator, prime-number
diff --git a/docs/src/c/p0009.rst b/docs/src/c/p0009.rst
@@ -18,3 +18,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0009.c
    :language: C
    :linenos:
+
+.. tags:: pythagorean-triple
diff --git a/docs/src/c/p0010.rst b/docs/src/c/p0010.rst
@@ -23,3 +23,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0010.c
    :language: C
    :linenos:
+
+.. tags:: c-iterator, prime-number
diff --git a/docs/src/c/p0011.rst b/docs/src/c/p0011.rst
@@ -23,3 +23,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0011.c
    :language: C
    :linenos:
+
+.. tags:: optimization
diff --git a/docs/src/c/p0012.rst b/docs/src/c/p0012.rst
@@ -28,3 +28,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0012.c
    :language: C
    :linenos:
+
+.. tags:: c-iterator, divisor-count, divisibility, marked-slow
diff --git a/docs/src/c/p0013.rst b/docs/src/c/p0013.rst
@@ -23,3 +23,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0013.c
    :language: C
    :linenos:
+
+.. tags:: large-numbers
diff --git a/docs/src/c/p0014.rst b/docs/src/c/p0014.rst
@@ -23,3 +23,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0014.c
    :language: C
    :linenos:
+
+.. tags:: collatz, recursion, longest-path
diff --git a/docs/src/c/p0015.rst b/docs/src/c/p0015.rst
@@ -23,3 +23,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0015.c
    :language: C
    :linenos:
+
+.. tags:: combinatorics
diff --git a/docs/src/c/p0016.rst b/docs/src/c/p0016.rst
@@ -23,3 +23,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0016.c
    :language: C
    :linenos:
+
+.. tags:: large-numbers, digit-sum, power
diff --git a/docs/src/c/p0017.rst b/docs/src/c/p0017.rst
@@ -18,3 +18,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0017.c
    :language: C
    :linenos:
+
+.. tags:: word-problem, combinatorics
diff --git a/docs/src/c/p0020.rst b/docs/src/c/p0020.rst
@@ -18,3 +18,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0020.c
    :language: C
    :linenos:
+
+.. tags:: large-numbers, digit-sum, factorial
diff --git a/docs/src/c/p0022.rst b/docs/src/c/p0022.rst
@@ -34,3 +34,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0022.c
    :language: C
    :linenos:
+
+.. tags:: word-problem, sorting, file-io
diff --git a/docs/src/c/p0025.rst b/docs/src/c/p0025.rst
@@ -23,3 +23,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0025.c
    :language: C
    :linenos:
+
+.. tags:: fibonacci-number, large-numbers
diff --git a/docs/src/c/p0030.rst b/docs/src/c/p0030.rst
@@ -23,3 +23,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0030.c
    :language: C
    :linenos:
+
+.. tags:: power, digit-sum, c-iterator
diff --git a/docs/src/c/p0034.rst b/docs/src/c/p0034.rst
@@ -24,3 +24,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0034.c
    :language: C
    :linenos:
+
+.. tags:: factorial, digit-sum, c-iterator
diff --git a/docs/src/c/p0076.rst b/docs/src/c/p0076.rst
@@ -23,3 +23,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0076.c
    :language: C
    :linenos:
+
+.. tags:: partition
diff --git a/docs/src/c/p0836.rst b/docs/src/c/p0836.rst
@@ -18,3 +18,5 @@ Solution
 .. literalinclude:: ../../../c/src/p0836.c
    :language: C
    :linenos:
+
+.. tags:: word-problem
diff --git a/docs/src/cplusplus.rst b/docs/src/cplusplus.rst
@@ -10,7 +10,6 @@ Library Code
 
 .. toctree::
    :glob:
-   :numbered:
    :maxdepth: 1
 
    cplusplus/lib/*
@@ -20,7 +19,6 @@ Problems Solved
 
 .. toctree::
    :glob:
-   :numbered:
    :maxdepth: 1
 
    cplusplus/p[0-9][0-9][0-9][0-9]
diff --git a/docs/src/cplusplus/lib/macros.rst b/docs/src/cplusplus/lib/macros.rst
@@ -1,7 +1,7 @@
-macros.h
-========
+macros.hpp
+==========
 
-View source code :source:`cplusplus/src/include/macros.h`
+View source code :source:`cplusplus/src/include/macros.hpp`
 
 .. c:namespace-push:: cppmacros
 

diff --git a/docs/src/cplusplus/lib/math.rst b/docs/src/cplusplus/lib/math.rst
@@ -1,7 +1,7 @@
-math.h
-======
+math.hpp
+========
 
-View source code :source:`cplusplus/src/include/math.h`
+View source code :source:`cplusplus/src/include/math.hpp`
 
 Includes
 --------

diff --git a/docs/src/cplusplus/lib/utils.rst b/docs/src/cplusplus/lib/utils.rst
@@ -1,7 +1,7 @@
-utils.h
-=======
+utils.hpp
+=========
 
-View source code :source:`cplusplus/src/include/utils.h`
+View source code :source:`cplusplus/src/include/utils.hpp`
 
 .. cpp:namespace-push:: utils
     
@@ -16,3 +16,5 @@ View source code :source:`cplusplus/src/include/utils.h`
 .. literalinclude:: ../../../../cplusplus/src/include/utils.h
    :language: C++
    :linenos:
+
+.. tags:: file-io
diff --git a/docs/src/cplusplus/p0001.rst b/docs/src/cplusplus/p0001.rst
@@ -8,3 +8,5 @@ View source code :source:`cplusplus/src/p0001.cpp`
 .. literalinclude:: ../../../cplusplus/src/p0001.cpp
    :language: C++
    :linenos:
+
+.. tags:: divisibility
diff --git a/docs/src/cplusplus/p0002.rst b/docs/src/cplusplus/p0002.rst
@@ -8,3 +8,5 @@ View source code :source:`cplusplus/src/p0002.cpp`
 .. literalinclude:: ../../../cplusplus/src/p0002.cpp
    :language: C++
    :linenos:
+
+.. tags:: fibonacci-number, divisibility
diff --git a/docs/src/cplusplus/p0004.rst b/docs/src/cplusplus/p0004.rst
@@ -8,3 +8,5 @@ View source code :source:`cplusplus/src/p0004.cpp`
 .. literalinclude:: ../../../cplusplus/src/p0004.cpp
    :language: C++
    :linenos:
+
+.. tags:: palindrome
diff --git a/docs/src/cplusplus/p0006.rst b/docs/src/cplusplus/p0006.rst
@@ -17,3 +17,5 @@ Solution
 .. literalinclude:: ../../../cplusplus/src/p0006.cpp
    :language: C++
    :linenos:
+
+.. tags:: arithmetic-progression, sequence-summation
diff --git a/docs/src/cplusplus/p0009.rst b/docs/src/cplusplus/p0009.rst
@@ -17,3 +17,5 @@ Solution
 .. literalinclude:: ../../../cplusplus/src/p0009.cpp
    :language: C++
    :linenos:
+
+.. tags:: pythagorean-triple