Enable barebones csharp docs

LivInTheLookingGlass · Jul 2, 2024 · e5e05e4 · e5e05e4
1 parent 17f52ae
commit e5e05e4
Show file tree

Hide file tree

Showing 12 changed files with 62 additions and 4 deletions.
diff --git a/docs/c/p0001.rst b/docs/c/p0001.rst
@@ -8,3 +8,7 @@ View source code `here on GitHub! <https://github.com/LivInTheLookingGlass/Euler
 
 .. c:autodoc:: p0001.c
    :clang: -std=c11 -DAMD_COMPILER=0
+
+.. literalinclude:: ../../c/p0001.c
+   :language: C
+   :linenos:
diff --git a/docs/conf.py b/docs/conf.py
@@ -31,14 +31,15 @@
     'sphinx.ext.inheritance_diagram',
     'sphinx.ext.mathjax',
     'sphinx.ext.todo',
-    'hawkmoth',
     # 'breathe',
     # 'javasphinx',
     # 'sphinx_autodoc_typehints',
     # 'sphinx_pyreverse',
-    'sphinx_js',
-    # 'sphinx_csharp',
+    'sphinx_csharp.csharp',
 ]
+if 'TERMUX_VERSION' not in os.environ:
+    extensions.append('hawkmoth')
+    extensions.append('sphinx_js')
 
 templates_path = ['_templates']
 exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']

diff --git a/docs/csharp.rst b/docs/csharp.rst
@@ -10,3 +10,5 @@ Problems Solved
 
 .. toctree::
    :maxdepth: 1
+
+   csharp/p0001.rst
diff --git a/docs/csharp/p0001.rst b/docs/csharp/p0001.rst
@@ -0,0 +1,20 @@
+C Implementation of Problem 1
+=============================
+
+View source code `here on GitHub! <https://github.com/LivInTheLookingGlass/Euler/blob/master/c/p0001.c>`_
+
+.. csharp:namespace:: Euler
+
+.. csharp:class:: P0001
+
+   .. csharp:inherits:: Euler.IEuler
+
+   .. csharp:method:: Task<Int64> answer()
+
+      An alas for :meth:`p0001`
+
+   .. csharp:method:: Task<Int64> p0001()
+
+.. literalinclude:: ../../csharp/Euler/p0001.cs
+   :language: csharp
+   :linenos:
diff --git a/docs/javascript/p0001.rst b/docs/javascript/p0001.rst
@@ -4,3 +4,7 @@ JavaScript Implementation of Problem 1
 View source code `here on GitHub! <https://github.com/LivInTheLookingGlass/Euler/blob/master/javascript/p0001.js>`_
 
 .. js:autofunction:: p0001
+
+.. literalinclude:: ../../javascript/p0001.js
+   :language: javascript
+   :linenos:
diff --git a/docs/javascript/p0002.rst b/docs/javascript/p0002.rst
@@ -4,3 +4,8 @@ JavaScript Implementation of Problem 2
 View source code `here on GitHub! <https://github.com/LivInTheLookingGlass/Euler/blob/master/javascript/p0002.js>`_
 
 .. js:autofunction:: p0002
+
+.. literalinclude:: ../../javascript/p0002.js
+   :language: javascript
+   :linenos:
+
diff --git a/docs/python/p0001.rst b/docs/python/p0001.rst
@@ -6,3 +6,8 @@ View source code `here on GitHub! <https://github.com/LivInTheLookingGlass/Euler
 .. automodule:: python.p0001
    :members:
    :undoc-members:
+
+.. literalinclude:: ../../python/p0001.py
+   :language: python
+   :linenos:
+
diff --git a/docs/python/p0002.rst b/docs/python/p0002.rst
@@ -6,3 +6,7 @@ View source code `here on GitHub! <https://github.com/LivInTheLookingGlass/Euler
 .. automodule:: python.p0002
    :members:
    :undoc-members:
+
+.. literalinclude:: ../../python/p0002.py
+   :language: python
+   :linenos:
diff --git a/docs/python/p0003.rst b/docs/python/p0003.rst
@@ -6,3 +6,7 @@ View source code `here on GitHub! <https://github.com/LivInTheLookingGlass/Euler
 .. automodule:: python.p0003
    :members:
    :undoc-members:
+
+.. literalinclude:: ../../python/p0003.py
+   :language: python
+   :linenos:
diff --git a/docs/python/p0004.rst b/docs/python/p0004.rst
@@ -6,3 +6,7 @@ View source code `here on GitHub! <https://github.com/LivInTheLookingGlass/Euler
 .. automodule:: python.p0004
    :members:
    :undoc-members:
+
+.. literalinclude:: ../../python/p0004.py
+   :language: python
+   :linenos:
diff --git a/docs/python/p0005.rst b/docs/python/p0005.rst
@@ -6,3 +6,7 @@ View source code `here on GitHub! <https://github.com/LivInTheLookingGlass/Euler
 .. automodule:: python.p0005
    :members:
    :undoc-members:
+
+.. literalinclude:: ../../python/p0005.py
+   :language: python
+   :linenos:
diff --git a/docs/requirements.txt b/docs/requirements.txt
@@ -2,4 +2,5 @@ sphinx>=3.1
 sphinx-rtd-theme
 sphinx-js
 hawkmoth
-clang==14
+clang==14
+sphinx-csharp
Original file line number	Diff line number	Diff line change
Expand Up		@@ -10,3 +10,5 @@ Problems Solved

		.. toctree::
		:maxdepth: 1

		csharp/p0001.rst