+ +
+ +{{ section.extra.lead | default(value="Please start setting config.toml and adding your content.") | safe }}
+ {{ section.extra.url_button | default(value="Quick Start") }} +{{ val.content | safe }}
+Take advantage of Ruby's elegant programming and computational power to create pixel-perfect graphics without using a vector graphics editor in certain scenarios.
+Thanks to a mixin based design, you can easily add custom features and use a rich set of methods, especially for tiling, hatching and various geometric operations.
+Properly indented and informally validated SVG output to satisfy your possible aesthetic obsessions. The code produced is visually comprehensible without artificial bloats.
+Test
+ + +``` + +#### Code block indented with four spaces + + + + + +Test
+ + + +## List Types + +#### Ordered List + +1. First item +2. Second item +3. Third item + +#### Unordered List + +- List item +- Another item +- And another item + +#### Nested list + +- Fruit + - Apple + - Orange + - Banana +- Dairy + - Milk + - Cheese + +## Other Elements β abbr, sub, sup, kbd, mark + +GIF is a bitmap image format. + +H2O + +Xn + Yn = Zn + +Press CTRL+ALT+Delete to end the +session. + +Most salamanders are nocturnal, and hunt for insects, worms, and +other small creatures. + +--- + +[^1]: The above quote is excerpted from Rob Pike's [talk](https://www.youtube.com/watch?v=PAAkCSZUG1c) +during Gopherfest, November 18, 2015. + +[^2]: The quote is the first sentence of Aristotle's [Metaphysics](http://classics.mit.edu/Aristotle/metaphysics.html). \ No newline at end of file diff --git a/showcase/srv/themes/adidoks/content/blog/math-typesetting.md b/showcase/srv/themes/adidoks/content/blog/math-typesetting.md new file mode 100644 index 0000000..99eaca8 --- /dev/null +++ b/showcase/srv/themes/adidoks/content/blog/math-typesetting.md @@ -0,0 +1,48 @@ ++++ +title = "Math Typesetting" +description = "Introducing Doks, a Hugo theme helping you build modern documentation websites that are secure, fast, and SEO-ready β by default." +date = 2021-04-08T09:19:42+00:00 +updated = 2021-04-08T09:19:42+00:00 +draft = false +template = "blog/page.html" + +[taxonomies] +authors = ["Public"] + +[extra] +lead = "Mathematical notation in a project can be enabled by using third party JavaScript libraries." +math = true ++++ + + +In this example we will be using [KaTeX](https://katex.org/) + +- Create a macro under `/template/macros/math.html` with a macro named `math`. +- Within this macro reference the [Auto-render Extension](https://katex.org/docs/autorender.html) or host these scripts locally. +- Import the macro in your templates like so: + +```bash +{% import 'macros/math.html' as macros %} +{% if page.extra.math or section.extra.math or config.extra.math %} +{{ macros::math() }} +{% endif %} +``` + +- To enable KaTex globally set the parameter `extra.math` to `true` in a project's configuration +- To enable KaTex on a per page basis include the parameter `extra.math = true` in content files + +**Note:** + +1. The MathJax library is the other optional choice, and you can set the parameter `extra.library` to `mathjax` in a project's configuration +2. Use the online reference of [Supported TeX Functions](https://katex.org/docs/supported.html) + +### Examples + ++Inline math: \(\varphi = \dfrac{1+\sqrt5}{2}= 1.6180339887β¦\) +
+ +Block math: +$$ + \varphi = 1+\frac{1} {1+\frac{1} {1+\frac{1} {1+\cdots} } } +$$ diff --git a/showcase/srv/themes/adidoks/content/blog/placeholder-text.md b/showcase/srv/themes/adidoks/content/blog/placeholder-text.md new file mode 100644 index 0000000..750d5ab --- /dev/null +++ b/showcase/srv/themes/adidoks/content/blog/placeholder-text.md @@ -0,0 +1,62 @@ ++++ +title = "Placeholder Text" +description = "Lorem Ipsum Dolor Si Amet" +date = 2021-04-10T09:19:42+00:00 +updated = 2021-04-10T09:19:42+00:00 +draft = false +template = "blog/page.html" + +[taxonomies] +authors = ["Public"] + ++++ + +Lorem est tota propiore conpellat pectoribus de pectora summo. Redit +teque digerit hominumque toris verebor lumina non cervice subde tollit usus +habet Arctonque, furores quas nec ferunt. Quoque montibus nunc caluere tempus +inhospita parcite confusaque translucet patri vestro qui optatis lumine +cognoscere flos nubis! Fronde ipsamque patulos Dryopen deorum. + +1. Exierant elisi ambit vivere dedere +2. Duce pollice +3. Eris modo +4. Spargitque ferrea quos palude + +Rursus nulli murmur; hastile inridet ut ab gravi sententia! Nomine potitus +silentia flumen, sustinet placuit petis in dilapsa erat sunt. Atria tractus malis. + +1. Comas hunc haec pietate fetum procerum dixit +2. Post torum vates letum Tiresia +3. Flumen querellas +4. Arcanaque montibus omnes +5. Quidem et + +# Vagus elidunt + + + +[The Van de Graaf Canon](https://en.wikipedia.org/wiki/Canons_of_page_construction#Van_de_Graaf_canon) + +## Mane refeci capiebant unda mulcebat + +Victa caducifer, malo vulnere contra dicere aurato, ludit regale, voca! Retorsit +colit est profanae esse virescere furit nec; iaculi matertera et visa est, +viribus. Divesque creatis, tecta novat collumque vulnus est, parvas. +**Faces illo pepulere** tempus adest. Tendit flamma, ab opes virum sustinet, +sidus sequendo urbis. + +Iubar proles corpore raptos vero auctor imperium; sed et huic: manus caeli +Lelegas tu lux. Verbis obstitit intus oblectamina fixis linguisque ausus sperare +Echionides cornuaque tenent clausit possit. Omnia putatur. Praeteritae refert +ausus; ferebant e primus lora nutat, vici quae mea ipse. Et iter nil spectatae +vulnus haerentia iuste et exercebat, sui et. + +Eurytus Hector, materna ipsumque ut Politen, nec, nate, ignari, vernum cohaesit +sequitur. Vel **mitis temploque** vocatus, inque alis, *oculos nomen* non silvis +corpore coniunx ne displicet illa. Crescunt non unus, vidit visa quantum inmiti +flumina mortis facto sic: undique a alios vincula sunt iactata abdita! +Suspenderat ego fuit tendit: luna, ante urbem Propoetides **parte**. + + diff --git a/showcase/srv/themes/adidoks/content/blog/say-hello-to-zola-doks.md b/showcase/srv/themes/adidoks/content/blog/say-hello-to-zola-doks.md new file mode 100644 index 0000000..5599f4a --- /dev/null +++ b/showcase/srv/themes/adidoks/content/blog/say-hello-to-zola-doks.md @@ -0,0 +1,15 @@ ++++ +title = "Say hello to AdiDoks π" +description = "Introducing AdiDoks, a Zola theme helping you build modern documentation websites, which is a port of the Hugo theme Doks for Zola." +date = 2021-04-03T07:00:00+00:00 +updated = 2021-04-03T07:00:00+00:00 +template = "blog/page.html" +draft = false + +[taxonomies] +authors = ["Aaran Xu"] + +[extra] +lead = 'Introducing AdiDoks, a Zola theme helping you build modern documentation websites, which is a port of the Hugo theme Doks for Zola.' +images = [] ++++ diff --git a/showcase/srv/themes/adidoks/content/docs/_index.md b/showcase/srv/themes/adidoks/content/docs/_index.md new file mode 100644 index 0000000..d715a6c --- /dev/null +++ b/showcase/srv/themes/adidoks/content/docs/_index.md @@ -0,0 +1,9 @@ ++++ +title = "Docs" +description = "The documents of the AdiDoks theme." +date = 2025-05-01T08:00:00+00:00 +updated = 2021-05-01T08:00:00+00:00 +sort_by = "weight" +weight = 1 +template = "docs/section.html" ++++ diff --git a/showcase/srv/themes/adidoks/content/docs/contributing/_index.md b/showcase/srv/themes/adidoks/content/docs/contributing/_index.md new file mode 100644 index 0000000..2c6b355 --- /dev/null +++ b/showcase/srv/themes/adidoks/content/docs/contributing/_index.md @@ -0,0 +1,10 @@ ++++ +title = "Contributing" +description = "Find out how to contribute to AdiDoks." +date = 2025-05-01T18:00:00+00:00 +updated = 2021-05-01T18:00:00+00:00 +template = "docs/section.html" +sort_by = "weight" +weight = 4 +draft = false ++++ diff --git a/showcase/srv/themes/adidoks/content/docs/contributing/code-of-conduct.md b/showcase/srv/themes/adidoks/content/docs/contributing/code-of-conduct.md new file mode 100644 index 0000000..f212db1 --- /dev/null +++ b/showcase/srv/themes/adidoks/content/docs/contributing/code-of-conduct.md @@ -0,0 +1,146 @@ ++++ +title = "Code of Conduct" +description = "Contributor Covenant Code of Conduct." +date = 2021-05-01T18:20:00+00:00 +updated = 2021-05-01T18:20:00+00:00 +draft = false +weight = 420 +sort_by = "weight" +template = "docs/page.html" + +[extra] +lead = "Contributor Covenant Code of Conduct." +toc = true +top = false ++++ + +## Our Pledge + +We as members, contributors, and leaders pledge to make participation in our +community a harassment-free experience for everyone, regardless of age, body +size, visible or invisible disability, ethnicity, sex characteristics, gender +identity and expression, level of experience, education, socio-economic status, +nationality, personal appearance, race, caste, color, religion, or sexual identity +and orientation. + +We pledge to act and interact in ways that contribute to an open, welcoming, +diverse, inclusive, and healthy community. + +## Our Standards + +Examples of behavior that contributes to a positive environment for our +community include: + +* Demonstrating empathy and kindness toward other people +* Being respectful of differing opinions, viewpoints, and experiences +* Giving and gracefully accepting constructive feedback +* Accepting responsibility and apologizing to those affected by our mistakes, + and learning from the experience +* Focusing on what is best not just for us as individuals, but for the + overall community + +Examples of unacceptable behavior include: + +* The use of sexualized language or imagery, and sexual attention or + advances of any kind +* Trolling, insulting or derogatory comments, and personal or political attacks +* Public or private harassment +* Publishing others' private information, such as a physical or email + address, without their explicit permission +* Other conduct which could reasonably be considered inappropriate in a + professional setting + +## Enforcement Responsibilities + +Community leaders are responsible for clarifying and enforcing our standards of +acceptable behavior and will take appropriate and fair corrective action in +response to any behavior that they deem inappropriate, threatening, offensive, +or harmful. + +Community leaders have the right and responsibility to remove, edit, or reject +comments, commits, code, wiki edits, issues, and other contributions that are +not aligned to this Code of Conduct, and will communicate reasons for moderation +decisions when appropriate. + +## Scope + +This Code of Conduct applies within all community spaces, and also applies when +an individual is officially representing the community in public spaces. +Examples of representing our community include using an official e-mail address, +posting via an official social media account, or acting as an appointed +representative at an online or offline event. + +## Enforcement + +Instances of abusive, harassing, or otherwise unacceptable behavior may be +reported to the community leaders responsible for enforcement at ++ + + +
+ +
+ Sleek, intuitive, and powerful front-end framework for faster and easier web development.
+
+ Explore Bootstrap docs Β»
+
+
+ Report bug
+ Β·
+ Request feature
+ Β·
+ Themes
+ Β·
+ Blog
+
`s get reset. However, we also reset the\n// bottom margin to use `rem` units instead of `em`.\n\np {\n margin-top: 0;\n margin-bottom: $paragraph-margin-bottom;\n}\n\n\n// Abbreviations\n//\n// 1. Duplicate behavior to the data-bs-* attribute for our tooltip plugin\n// 2. Add the correct text decoration in Chrome, Edge, Opera, and Safari.\n// 3. Add explicit cursor to indicate changed behavior.\n// 4. Prevent the text-decoration to be skipped.\n\nabbr[title],\nabbr[data-bs-original-title] { // 1\n text-decoration: underline dotted; // 2\n cursor: help; // 3\n text-decoration-skip-ink: none; // 4\n}\n\n\n// Address\n\naddress {\n margin-bottom: 1rem;\n font-style: normal;\n line-height: inherit;\n}\n\n\n// Lists\n\nol,\nul {\n padding-left: 2rem;\n}\n\nol,\nul,\ndl {\n margin-top: 0;\n margin-bottom: 1rem;\n}\n\nol ol,\nul ul,\nol ul,\nul ol {\n margin-bottom: 0;\n}\n\ndt {\n font-weight: $dt-font-weight;\n}\n\n// 1. Undo browser default\n\ndd {\n margin-bottom: .5rem;\n margin-left: 0; // 1\n}\n\n\n// Blockquote\n\nblockquote {\n margin: 0 0 1rem;\n}\n\n\n// Strong\n//\n// Add the correct font weight in Chrome, Edge, and Safari\n\nb,\nstrong {\n font-weight: $font-weight-bolder;\n}\n\n\n// Small\n//\n// Add the correct font size in all browsers\n\nsmall {\n @include font-size($small-font-size);\n}\n\n\n// Mark\n\nmark {\n padding: $mark-padding;\n background-color: $mark-bg;\n}\n\n\n// Sub and Sup\n//\n// Prevent `sub` and `sup` elements from affecting the line height in\n// all browsers.\n\nsub,\nsup {\n position: relative;\n @include font-size($sub-sup-font-size);\n line-height: 0;\n vertical-align: baseline;\n}\n\nsub { bottom: -.25em; }\nsup { top: -.5em; }\n\n\n// Links\n\na {\n color: $link-color;\n text-decoration: $link-decoration;\n\n &:hover {\n color: $link-hover-color;\n text-decoration: $link-hover-decoration;\n }\n}\n\n// And undo these styles for placeholder links/named anchors (without href).\n// It would be more straightforward to just use a[href] in previous block, but that\n// causes specificity issues in many other styles that are too complex to fix.\n// See https://github.com/twbs/bootstrap/issues/19402\n\na:not([href]):not([class]) {\n &,\n &:hover {\n color: inherit;\n text-decoration: none;\n }\n}\n\n\n// Code\n\npre,\ncode,\nkbd,\nsamp {\n font-family: $font-family-code;\n @include font-size(1em); // Correct the odd `em` font sizing in all browsers.\n direction: ltr #{\"/* rtl:ignore */\"};\n unicode-bidi: bidi-override;\n}\n\n// 1. Remove browser default top margin\n// 2. Reset browser default of `1em` to use `rem`s\n// 3. Don't allow content to break outside\n\npre {\n display: block;\n margin-top: 0; // 1\n margin-bottom: 1rem; // 2\n overflow: auto; // 3\n @include font-size($code-font-size);\n color: $pre-color;\n\n // Account for some code outputs that place code tags in pre tags\n code {\n @include font-size(inherit);\n color: inherit;\n word-break: normal;\n }\n}\n\ncode {\n @include font-size($code-font-size);\n color: $code-color;\n word-wrap: break-word;\n\n // Streamline the style when inside anchors to avoid broken underline and more\n a > & {\n color: inherit;\n }\n}\n\nkbd {\n padding: $kbd-padding-y $kbd-padding-x;\n @include font-size($kbd-font-size);\n color: $kbd-color;\n background-color: $kbd-bg;\n @include border-radius($border-radius-sm);\n\n kbd {\n padding: 0;\n @include font-size(1em);\n font-weight: $nested-kbd-font-weight;\n }\n}\n\n\n// Figures\n//\n// Apply a consistent margin strategy (matches our type styles).\n\nfigure {\n margin: 0 0 1rem;\n}\n\n\n// Images and content\n\nimg,\nsvg {\n vertical-align: middle;\n}\n\n\n// Tables\n//\n// Prevent double borders\n\ntable {\n caption-side: bottom;\n border-collapse: collapse;\n}\n\ncaption {\n padding-top: $table-cell-padding-y;\n padding-bottom: $table-cell-padding-y;\n color: $table-caption-color;\n text-align: left;\n}\n\n// 1. Removes font-weight bold by inheriting\n// 2. Matches default `