simplified pre-commit hook

.pre-commit-config.yaml

@@ -40,19 +40,21 @@ repos:
         entry: cmake-format
         language: python
         types: [cmake]
-        args: [--in-place]
+        args: [--line-width, '100', '--tab-size', '4', '--in-place']
 
       - id: cmake-lint
         name: cmake-lint
         entry: cmake-lint
         language: python
         types: [cmake]
+        args: ['--disabled-codes', 'C0113 C0301']
 
   - repo: https://github.com/google/yamlfmt
     rev: v0.10.0
     hooks:
       - id: yamlfmt
-        args: [-conf, .yamlfmt.yaml]
+        args: ['-formatter', 'max_line_length=100', '-formatter', 'indent=2', '-formatter', 'retain_line_breaks=true',
+          '-formatter', 'include_document_start=false']
 
   - repo: https://github.com/igorshubovych/markdownlint-cli
     rev: v0.42.0

docs/styles/extra.css

@@ -0,0 +1,6 @@
+:root {
+    --md-primary-fg-color:        #9d2246;
+    --md-primary-fg-color--light: #d50c2f;
+    --md-primary-fg-color--dark:  #9d2246;
+    --md-accent-fg-color:         #f39ca9;
+  }

include/PackageName/template.h

@@ -1,10 +1,22 @@
 #ifndef PACKAGENAME_TEMPLATE_H
 #define PACKAGENAME_TEMPLATE_H
 
-// Function declaration for addition
+/**
+ * @brief Add two integers
+ *
+ * @param pA First integer
+ * @param pB Second integer
+ * @return int Sum of the two integers
+ */
 int add(int pA, int pB);
 
-// Function declaration for subtraction
+/**
+ * @brief Subtract two integers
+ *
+ * @param pA First integer
+ * @param pB Second integer
+ * @return int Difference of the two integers
+ */
 int subtract(int pA, int pB);
 
 int multiply(int pA, int pB)

mkdocs.yaml

@@ -2,6 +2,11 @@ site_name: PackageName documentation
 site_url: https://secorolab.github.io/c_cpp_pkg_template/
 repo_url: https://github.com/secorolab/c_cpp_pkg_template
 repo_name: secorolab/c_cpp_pkg_template
+
+# nav:
+#   - Home: index.md
+#   - API Reference: reference/
+
 theme:
   #  logo: assets/logo.png
   icon:
@@ -10,20 +15,24 @@ theme:
   palette:
     # Palette toggle for automatic mode
     - media: (prefers-color-scheme)
+      primary: custom
+      accent: custom
       toggle:
         icon: material/brightness-auto
         name: Switch to light mode
         # Palette toggle for light mode
     - media: '(prefers-color-scheme: light)'
       scheme: default
-      primary: black
+      primary: custom
+      accent: custom
       toggle:
         icon: material/brightness-7
         name: Switch to dark mode
         # Palette toggle for dark mode
     - media: '(prefers-color-scheme: dark)'
       scheme: slate
-      primary: black
+      primary: custom
+      accent: custom
       toggle:
         icon: material/brightness-4
         name: Switch to system preference
@@ -71,6 +80,8 @@ markdown_extensions:
 plugins:
   - search
   - awesome-pages
+extra_css:
+  - styles/extra.css
 extra:
   social:
     - icon: fontawesome/brands/github