diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
new file mode 100644
index 0000000..ec38faa
--- /dev/null
+++ b/.github/workflows/lint.yml
@@ -0,0 +1,13 @@
+name: Lint
+on: [push, pull_request, workflow_dispatch]
+jobs:
+ lint:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout ποΈ
+ uses: actions/checkout@v4
+ - name: Ruby π₯
+ uses: ruby/setup-ruby@v1
+ with: { bundler-cache: true }
+ - name: Lint π¬
+ run: bundle exec rake lint
diff --git a/.github/workflows/site.yml b/.github/workflows/site.yml
new file mode 100644
index 0000000..fa3d77c
--- /dev/null
+++ b/.github/workflows/site.yml
@@ -0,0 +1,20 @@
+name: Site
+on:
+ push: { branches: [ "main" ], paths: ["showcase/srv/**"] }
+ pull_request: { branches: [ "main" ], paths: ["showcase/srv/**"] }
+ workflow_dispatch:
+concurrency:
+ group: "pages"
+ cancel-in-progress: true
+jobs:
+ site:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout ποΈ
+ uses: actions/checkout@v4
+ - name: Deploy π₯
+ uses: shalzz/zola-deploy-action@v0.18.0
+ env:
+ BUILD_DIR: showcase/srv
+ PAGES_BRANCH: site
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
new file mode 100644
index 0000000..f2b4c02
--- /dev/null
+++ b/.github/workflows/test.yml
@@ -0,0 +1,13 @@
+name: Test
+on: [push, pull_request, workflow_dispatch]
+jobs:
+ test:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout ποΈ
+ uses: actions/checkout@v4
+ - name: Ruby π₯
+ uses: ruby/setup-ruby@v1
+ with: { bundler-cache: true }
+ - name: Unit π¬
+ run: bundle exec rake test
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..ff2f92b
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,10 @@
+*.old
+*/themes/adidoks/
+.envrc
+/.VSCodeCounter/
+/.bundle/
+/.local/
+/coverage/
+/pkg/
+/vendor/
+_/
diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000..4633b59
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "showcase/srv/themes/adidoks"]
+ path = showcase/srv/themes/adidoks
+ url = https://github.com/aaranxu/adidoks.git
diff --git a/.rubocop.yml b/.rubocop.yml
new file mode 100644
index 0000000..19f75c5
--- /dev/null
+++ b/.rubocop.yml
@@ -0,0 +1,91 @@
+inherit_gem:
+ rubocop-rails-omakase: rubocop.yml
+
+require:
+ - "rubocop-md"
+ - "rubocop-packaging"
+ - "rubocop-rake"
+
+Layout/ExtraSpacing:
+ Exclude:
+ - "**/lib/sevgi/standard/**/*.rb"
+ - "**/test/**/*.rb"
+Layout/HashAlignment:
+ Enabled: true
+ EnforcedHashRocketStyle: table
+ EnforcedColonStyle: table
+Layout/LineLength:
+ Max: 140
+ Exclude:
+ - "**/test/**/*.rb"
+Layout/MultilineArrayLineBreaks:
+ Exclude:
+ - "**/test/**/*.rb"
+Layout/MultilineMethodArgumentLineBreaks:
+ Exclude:
+ - "**/test/**/*.rb"
+Layout/MultilineOperationIndentation:
+ Enabled: false
+
+Metrics/BlockLength:
+ Exclude:
+ - "**/test/**/*.rb"
+ - "*.gemspec"
+ - "**/srv/examples/**/*.sevgi"
+Metrics/ClassLength:
+ Exclude:
+ - "**/test/**/*.rb"
+ - "**/srv/examples/**/*.sevgi"
+Metrics/MethodLength:
+ Exclude:
+ - "**/test/**/*.rb"
+ - "**/srv/examples/**/*.sevgi"
+
+Naming/MethodName:
+ Enabled: false
+
+Minitest/UselessAssertion:
+ Exclude:
+ - "**/test/test_common.rb" # TODO: to avoid a bug
+
+Rails/RefuteMethods:
+ Enabled: false
+
+Style/AsciiComments:
+ Enabled: false
+Style/ClassAndModuleChildren:
+ Exclude:
+ - "**/test/**/*.rb"
+Style/Documentation:
+ Enabled: false
+Style/LambdaCall:
+ Enabled: false
+Style/MethodCallWithArgsParentheses:
+ Exclude:
+ - "**/test/**/*.rb"
+ - "**/srv/examples/**/*.sevgi"
+Style/ParallelAssignment:
+ Enabled: false
+Style/SymbolArray:
+ Exclude:
+ - "**/lib/sevgi/standard/**/*.rb"
+ - "**/test/**/*.rb"
+Style/SymbolLiteral:
+ Exclude:
+ - "**/lib/sevgi/standard/**/*.rb"
+ - "**/test/**/*.rb"
+Style/TrailingCommaInArguments:
+ Exclude:
+ - "**/test/**/*.rb"
+Style/TrailingCommaInArrayLiteral:
+ Exclude:
+ - "**/test/**/*.rb"
+
+AllCops:
+ NewCops: enable
+ Include:
+ - "**/srv/examples/**/*.sevgi"
+ Exclude:
+ - "vendor/**/*"
+ - "_/**/*"
+ - "**/_/**/*"
diff --git a/.ruby-version b/.ruby-version
new file mode 100644
index 0000000..15a2799
--- /dev/null
+++ b/.ruby-version
@@ -0,0 +1 @@
+3.3.0
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..8c17c5f
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,9 @@
+Changelog
+=========
+
+This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+Unreleased
+----------
+
+Initial release.
diff --git a/Gemfile b/Gemfile
new file mode 100644
index 0000000..95a572d
--- /dev/null
+++ b/Gemfile
@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+ruby File.read(File.expand_path(".ruby-version", __dir__)).strip
+
+gemspec path: "external"
+
+group :sevgi do
+ gem "sevgi-standard", path: "standard"
+ gem "sevgi-geometry", path: "geometry"
+ gem "sevgi-graphics", path: "graphics"
+end
+
+group :test, :development do
+ gem "bundler"
+ gem "minitest"
+ gem "minitest-focus", ">= 1.2.1"
+ gem "minitest-reporters", ">= 1.4.3"
+ gem "rake"
+end
+
+group :development do
+ gem "rubocop-md"
+ gem "rubocop-packaging"
+ gem "rubocop-rails-omakase"
+ gem "rubocop-rake"
+ gem "ruby-lsp"
+end
diff --git a/Gemfile.lock b/Gemfile.lock
new file mode 100644
index 0000000..c82e2b8
--- /dev/null
+++ b/Gemfile.lock
@@ -0,0 +1,140 @@
+PATH
+ remote: external
+ specs:
+ sevgi (0.1.0)
+ sevgi-geometry (= 0.1.0)
+ sevgi-graphics (= 0.1.0)
+ sevgi-standard (= 0.1.0)
+
+PATH
+ remote: geometry
+ specs:
+ sevgi-geometry (0.1.0)
+
+PATH
+ remote: graphics
+ specs:
+ sevgi-graphics (0.1.0)
+
+PATH
+ remote: standard
+ specs:
+ sevgi-standard (0.1.0)
+
+GEM
+ remote: https://rubygems.org/
+ specs:
+ activesupport (7.1.3.3)
+ base64
+ bigdecimal
+ concurrent-ruby (~> 1.0, >= 1.0.2)
+ connection_pool (>= 2.2.5)
+ drb
+ i18n (>= 1.6, < 2)
+ minitest (>= 5.1)
+ mutex_m
+ tzinfo (~> 2.0)
+ ansi (1.5.0)
+ ast (2.4.2)
+ base64 (0.2.0)
+ bigdecimal (3.1.8)
+ builder (3.2.4)
+ concurrent-ruby (1.2.3)
+ connection_pool (2.4.1)
+ drb (2.2.1)
+ i18n (1.14.5)
+ concurrent-ruby (~> 1.0)
+ json (2.7.2)
+ language_server-protocol (3.17.0.3)
+ minitest (5.23.0)
+ minitest-focus (1.4.0)
+ minitest (>= 4, < 6)
+ minitest-reporters (1.6.1)
+ ansi
+ builder
+ minitest (>= 5.0)
+ ruby-progressbar
+ mutex_m (0.2.0)
+ parallel (1.24.0)
+ parser (3.3.1.0)
+ ast (~> 2.4.1)
+ racc
+ prism (0.27.0)
+ racc (1.8.0)
+ rack (3.0.11)
+ rainbow (3.1.1)
+ rake (13.2.1)
+ regexp_parser (2.9.2)
+ rexml (3.2.8)
+ strscan (>= 3.0.9)
+ rubocop (1.63.5)
+ json (~> 2.3)
+ language_server-protocol (>= 3.17.0)
+ parallel (~> 1.10)
+ parser (>= 3.3.0.2)
+ rainbow (>= 2.2.2, < 4.0)
+ regexp_parser (>= 1.8, < 3.0)
+ rexml (>= 3.2.5, < 4.0)
+ rubocop-ast (>= 1.31.1, < 2.0)
+ ruby-progressbar (~> 1.7)
+ unicode-display_width (>= 2.4.0, < 3.0)
+ rubocop-ast (1.31.3)
+ parser (>= 3.3.1.0)
+ rubocop-md (1.2.2)
+ rubocop (>= 1.0)
+ rubocop-minitest (0.35.0)
+ rubocop (>= 1.61, < 2.0)
+ rubocop-ast (>= 1.31.1, < 2.0)
+ rubocop-packaging (0.5.2)
+ rubocop (>= 1.33, < 2.0)
+ rubocop-performance (1.21.0)
+ rubocop (>= 1.48.1, < 2.0)
+ rubocop-ast (>= 1.31.1, < 2.0)
+ rubocop-rails (2.25.0)
+ activesupport (>= 4.2.0)
+ rack (>= 1.1)
+ rubocop (>= 1.33.0, < 2.0)
+ rubocop-ast (>= 1.31.1, < 2.0)
+ rubocop-rails-omakase (1.0.0)
+ rubocop
+ rubocop-minitest
+ rubocop-performance
+ rubocop-rails
+ rubocop-rake (0.6.0)
+ rubocop (~> 1.0)
+ ruby-lsp (0.16.6)
+ language_server-protocol (~> 3.17.0)
+ prism (>= 0.23.0, < 0.28)
+ sorbet-runtime (>= 0.5.10782)
+ ruby-progressbar (1.13.0)
+ sorbet-runtime (0.5.11385)
+ strscan (3.1.0)
+ tzinfo (2.0.6)
+ concurrent-ruby (~> 1.0)
+ unicode-display_width (2.5.0)
+
+PLATFORMS
+ ruby
+ x86_64-linux
+
+DEPENDENCIES
+ bundler
+ minitest
+ minitest-focus (>= 1.2.1)
+ minitest-reporters (>= 1.4.3)
+ rake
+ rubocop-md
+ rubocop-packaging
+ rubocop-rails-omakase
+ rubocop-rake
+ ruby-lsp
+ sevgi!
+ sevgi-geometry!
+ sevgi-graphics!
+ sevgi-standard!
+
+RUBY VERSION
+ ruby 3.3.0p0
+
+BUNDLED WITH
+ 2.5.10
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..f288702
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,674 @@
+ GNU GENERAL PUBLIC LICENSE
+ Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc.
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+ Preamble
+
+ The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+ The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works. By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users. We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors. You can apply it to
+your programs, too.
+
+ When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+ To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights. Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+ For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received. You must make sure that they, too, receive
+or can get the source code. And you must show them these terms so they
+know their rights.
+
+ Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+ For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software. For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+ Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so. This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software. The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable. Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products. If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+ Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary. To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+ The precise terms and conditions for copying, distribution and
+modification follow.
+
+ TERMS AND CONDITIONS
+
+ 0. Definitions.
+
+ "This License" refers to version 3 of the GNU General Public License.
+
+ "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+ "The Program" refers to any copyrightable work licensed under this
+License. Each licensee is addressed as "you". "Licensees" and
+"recipients" may be individuals or organizations.
+
+ To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy. The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+ A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+ To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy. Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+ To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies. Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+ An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License. If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+ 1. Source Code.
+
+ The "source code" for a work means the preferred form of the work
+for making modifications to it. "Object code" means any non-source
+form of a work.
+
+ A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+ The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form. A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+ The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities. However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work. For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+ The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+ The Corresponding Source for a work in source code form is that
+same work.
+
+ 2. Basic Permissions.
+
+ All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met. This License explicitly affirms your unlimited
+permission to run the unmodified Program. The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work. This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+ You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force. You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright. Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+ Conveying under any other circumstances is permitted solely under
+the conditions stated below. Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+ 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+ No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+ When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+ 4. Conveying Verbatim Copies.
+
+ You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+ You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+ 5. Conveying Modified Source Versions.
+
+ You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+ a) The work must carry prominent notices stating that you modified
+ it, and giving a relevant date.
+
+ b) The work must carry prominent notices stating that it is
+ released under this License and any conditions added under section
+ 7. This requirement modifies the requirement in section 4 to
+ "keep intact all notices".
+
+ c) You must license the entire work, as a whole, under this
+ License to anyone who comes into possession of a copy. This
+ License will therefore apply, along with any applicable section 7
+ additional terms, to the whole of the work, and all its parts,
+ regardless of how they are packaged. This License gives no
+ permission to license the work in any other way, but it does not
+ invalidate such permission if you have separately received it.
+
+ d) If the work has interactive user interfaces, each must display
+ Appropriate Legal Notices; however, if the Program has interactive
+ interfaces that do not display Appropriate Legal Notices, your
+ work need not make them do so.
+
+ A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit. Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+ 6. Conveying Non-Source Forms.
+
+ You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+ a) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by the
+ Corresponding Source fixed on a durable physical medium
+ customarily used for software interchange.
+
+ b) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by a
+ written offer, valid for at least three years and valid for as
+ long as you offer spare parts or customer support for that product
+ model, to give anyone who possesses the object code either (1) a
+ copy of the Corresponding Source for all the software in the
+ product that is covered by this License, on a durable physical
+ medium customarily used for software interchange, for a price no
+ more than your reasonable cost of physically performing this
+ conveying of source, or (2) access to copy the
+ Corresponding Source from a network server at no charge.
+
+ c) Convey individual copies of the object code with a copy of the
+ written offer to provide the Corresponding Source. This
+ alternative is allowed only occasionally and noncommercially, and
+ only if you received the object code with such an offer, in accord
+ with subsection 6b.
+
+ d) Convey the object code by offering access from a designated
+ place (gratis or for a charge), and offer equivalent access to the
+ Corresponding Source in the same way through the same place at no
+ further charge. You need not require recipients to copy the
+ Corresponding Source along with the object code. If the place to
+ copy the object code is a network server, the Corresponding Source
+ may be on a different server (operated by you or a third party)
+ that supports equivalent copying facilities, provided you maintain
+ clear directions next to the object code saying where to find the
+ Corresponding Source. Regardless of what server hosts the
+ Corresponding Source, you remain obligated to ensure that it is
+ available for as long as needed to satisfy these requirements.
+
+ e) Convey the object code using peer-to-peer transmission, provided
+ you inform other peers where the object code and Corresponding
+ Source of the work are being offered to the general public at no
+ charge under subsection 6d.
+
+ A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+ A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling. In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage. For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product. A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+ "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source. The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+ If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information. But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+ The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed. Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+ Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+ 7. Additional Terms.
+
+ "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law. If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+ When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it. (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.) You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+ Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+ a) Disclaiming warranty or limiting liability differently from the
+ terms of sections 15 and 16 of this License; or
+
+ b) Requiring preservation of specified reasonable legal notices or
+ author attributions in that material or in the Appropriate Legal
+ Notices displayed by works containing it; or
+
+ c) Prohibiting misrepresentation of the origin of that material, or
+ requiring that modified versions of such material be marked in
+ reasonable ways as different from the original version; or
+
+ d) Limiting the use for publicity purposes of names of licensors or
+ authors of the material; or
+
+ e) Declining to grant rights under trademark law for use of some
+ trade names, trademarks, or service marks; or
+
+ f) Requiring indemnification of licensors and authors of that
+ material by anyone who conveys the material (or modified versions of
+ it) with contractual assumptions of liability to the recipient, for
+ any liability that these contractual assumptions directly impose on
+ those licensors and authors.
+
+ All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10. If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term. If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+ If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+ Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+ 8. Termination.
+
+ You may not propagate or modify a covered work except as expressly
+provided under this License. Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+ However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+ Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+ Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License. If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+ 9. Acceptance Not Required for Having Copies.
+
+ You are not required to accept this License in order to receive or
+run a copy of the Program. Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance. However,
+nothing other than this License grants you permission to propagate or
+modify any covered work. These actions infringe copyright if you do
+not accept this License. Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+ 10. Automatic Licensing of Downstream Recipients.
+
+ Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License. You are not responsible
+for enforcing compliance by third parties with this License.
+
+ An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations. If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+ You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License. For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+ 11. Patents.
+
+ A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based. The
+work thus licensed is called the contributor's "contributor version".
+
+ A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version. For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+ Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+ In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement). To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+ If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients. "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+ If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+ A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License. You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+ Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+ 12. No Surrender of Others' Freedom.
+
+ If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all. For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+ 13. Use with the GNU Affero General Public License.
+
+ Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work. The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+ 14. Revised Versions of this License.
+
+ The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time. Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+ Each version is given a distinguishing version number. If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation. If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+ If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+ Later license versions may give you additional or different
+permissions. However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+ 15. Disclaimer of Warranty.
+
+ THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+ 16. Limitation of Liability.
+
+ IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+ 17. Interpretation of Sections 15 and 16.
+
+ If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+ END OF TERMS AND CONDITIONS
+
+ How to Apply These Terms to Your New Programs
+
+ If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+ To do so, attach the following notices to the program. It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+
+ Copyright (C)
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see .
+
+Also add information on how to contact you by electronic and paper mail.
+
+ If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+ Copyright (C)
+ This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+ This is free software, and you are welcome to redistribute it
+ under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License. Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+ You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+.
+
+ The GNU General Public License does not permit incorporating your program
+into proprietary programs. If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library. If this is what you want to do, use the GNU Lesser General
+Public License instead of this License. But first, please read
+.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..43907d6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,35 @@
+[![test status](https://github.com/roktas/sevgi/workflows/Test/badge.svg)](https://github.com/roktas/sevgi/actions?query=workflow%3ATest)
+[![code quality](https://codebeat.co/badges/ca6557d0-972b-4941-9f20-7c3a72a966fe)](https://codebeat.co/projects/github-com-roktas-sevgi-main)
+
+# SEVGI
+
+**SEVGI** is a toolkit for creating SVG content programmatically with Ruby as demonstrated below[^1]. You can use it 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.
+
+
+
+
+
+
+### Roadmap
+
+**The project is currently in pre-alpha stage. So many things might not work and many things can change.**
+
+Alpha stage
+
+- [ ] Stabilize API.
+- [ ] Complete unit tests for all critical code paths.
+- [ ] Populate examples while adding integration tests.
+- [ ] Write entry-level user documentation.
+
+Beta stage
+
+- [ ] Complete Geometry library.
+- [ ] Complete user documentation.
+- [ ] Start documenting API.
+
+[^1]: Inspired by [Victor](https://github.com/DannyBen/victor), which might be a better choice for those seeking
+ something simpler. Please note that a fair amount of the examples used for demonstration purposes come from this
+ project (thanks to the author).
diff --git a/Rakefile b/Rakefile
new file mode 100644
index 0000000..437c015
--- /dev/null
+++ b/Rakefile
@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+# rubocop:disable Metrics/BlockLength
+
+rootdir = File.expand_path(__dir__)
+version = File.read("#{rootdir}/VERSION").strip
+projects = Hash[*
+ ::Dir["*/*.gemspec"].map do |file|
+ [::File.dirname(file), ::File.basename(file, ".*")]
+ end.flatten
+]
+
+directory "pkg"
+
+projects.each do |project, package|
+ namespace project do
+ gem = "pkg/#{package}-#{version}.gem"
+ gemspec = "#{package}.gemspec"
+
+ %i[ lint test ].each do |tn|
+ desc "#{tn.capitalize} #{project.capitalize}"
+ task tn do |t|
+ puts "==> #{t}"
+ Dir.chdir(project) do
+ sh "rake #{tn}"
+ end
+ puts ""
+ end
+ end
+
+ desc "Package #{package}"
+ task :package => %w[ pkg ] do |t|
+ puts "==> #{t}"
+ Dir.chdir(project) do
+ sh <<~CMD
+ rake package && gem build #{gemspec} && mv #{package}-#{version}.gem #{rootdir}/pkg/ && rm -rf pkg
+ CMD
+ end
+ puts ""
+ end
+
+ desc "Build #{package}"
+ task build: %i[ clean package ]
+
+ desc "Push #{package}"
+ task push: :build do
+ puts "==> #{t}"
+ sh "gem push #{gem}"
+ puts ""
+ end
+ end
+end
+
+%i[ build lint push test ].each do |tn|
+ desc "#{tn.capitalize} all"
+ task tn => projects.keys.map { |project| "#{project}:#{tn}" }
+end
+
+desc "Bump versions"
+task :bump do
+ if ARGV[1]
+ ::File.write("#{rootdir}/VERSION", version = ARGV[1])
+ end
+
+ ::Dir["*/**/version.rb"].each do |source|
+ ::File.write(
+ source,
+ ::File.read(source).gsub(/^(\s*)version(\s*)= .*?$/, "\\1version = \"#{version}\"")
+ )
+ end
+end
+
+desc "Clean all"
+task :clean do
+ rm_rf "pkg"
+end
+
+desc "Make (almost) all"
+task all: %i[ lint test ]
+
+task default: :test
diff --git a/VERSION b/VERSION
new file mode 100644
index 0000000..6e8bf73
--- /dev/null
+++ b/VERSION
@@ -0,0 +1 @@
+0.1.0
diff --git a/external/README.md b/external/README.md
new file mode 100644
index 0000000..e69de29
diff --git a/external/Rakefile b/external/Rakefile
new file mode 120000
index 0000000..2c3c2af
--- /dev/null
+++ b/external/Rakefile
@@ -0,0 +1 @@
+../showcase/Rakefile
\ No newline at end of file
diff --git a/external/bin/sevgi b/external/bin/sevgi
new file mode 100755
index 0000000..4dc4725
--- /dev/null
+++ b/external/bin/sevgi
@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "sevgi/external/cli"
+
+Sevgi::CLI.(ARGV)
diff --git a/external/lib/sevgi.rb b/external/lib/sevgi.rb
new file mode 100644
index 0000000..6b9e90b
--- /dev/null
+++ b/external/lib/sevgi.rb
@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "sevgi/geometry"
+require "sevgi/standard"
+require "sevgi/graphics"
+require "sevgi/version"
+
+require "sevgi/external"
diff --git a/external/lib/sevgi/external.rb b/external/lib/sevgi/external.rb
new file mode 100644
index 0000000..93383e4
--- /dev/null
+++ b/external/lib/sevgi/external.rb
@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+require_relative "internal"
+
+module Sevgi
+ # Externals management DSL for consumers
+
+ module External
+ @constants = {}
+
+ class << self
+ private
+
+ def Promote(constant, symbol = Undefined)
+ @constants[Undefined.default(symbol, constant.to_s.split("::").last.to_sym)] = constant
+ end
+
+ def included(base)
+ super
+
+ @constants.each { |args| base.const_set(*args) }
+ end
+ end
+
+ def Extern(*modules, &block)
+ ::Sevgi::External.tap do |external|
+ external.module_exec(&block)
+ modules.each { external.include(_1) }
+ ::Sevgi.extend(external)
+ end
+ end
+
+ def Extern!(receiver, ...)
+ receiver.send(:include, Extern(...))
+ end
+ end
+
+ extend External
+
+ # Externals for Graphics
+
+ require "sevgi/graphics"
+
+ module External
+ def Canvas(...)
+ Graphics.Canvas(...)
+ end
+
+ def Mixin(mod, document = Graphics::Document::Base, &block)
+ document.mixture(mod)
+ document.mixture(::Module.new(&block)) if block
+ end
+
+ def SVG(...)
+ Graphics.SVG(...)
+ end
+
+ def Verbatim(content)
+ Graphics::Content.verbatim(content)
+ end
+ end
+
+ # Externals for Geometry
+
+ require "sevgi/geometry"
+
+ module External
+ def Grid(canvas, unit:, multiple:)
+ ArgumentError.("Must be a Canvas: #{canvas}") unless canvas.is_a?(Graphics::Canvas)
+
+ Geometry::Grid[
+ Geometry::Ruler.new(brut: canvas.width, unit:, multiple:, margin: canvas.left),
+ Geometry::Ruler.new(brut: canvas.height, unit:, multiple:, margin: canvas.top)
+ ]
+ end
+
+ def Point(...)
+ Geometry::Point.new(...)
+ end
+
+ def Ruler(...)
+ Geometry::Ruler.new(...)
+ end
+
+ # Extern Function::Float
+ # Extern Function::Math
+
+ Promote Geometry
+ end
+
+ # Glue Graphics and Geometry
+
+ module Geometry
+ class Rect
+ def draw(node, **) = node.rect(x: position!.x, y: position!.y, width: width!, height: height!, **)
+ end
+
+ class Segment
+ def draw(node, **) = node.segment(x1: position!.x, y1: position!.y, x2: ending!.x, y2: ending!.y, **)
+ end
+ end
+
+ module Graphics
+ module Mixtures
+ module Hatch
+ module InstanceMethods
+ def Draw(segments, **kwargs)
+ segments.each { |segment| segment.draw(self, **kwargs) }
+ end
+
+ def Hatch(element, initial: nil, direction:, step:, **kwargs)
+ Geometry::Operation.sweep!(element, initial: initial || element.position, direction:, step:).tap do |segments|
+ Draw(segments, **kwargs)
+ end
+ end
+ end
+ end
+ end
+ end
+
+ Mixin Graphics::Mixtures::Hatch
+
+ # Other externals
+
+ EXTENSION = "sevgi"
+
+ module External
+ def Load(file)
+ start = ::File.dirname(exclude = caller_locations(1..1).first.path)
+
+ raise(Error, "Cannot load a file matching: #{file}") unless (location = Locate.(F.qualify(file, EXTENSION), start, exclude:))
+
+ Sandbox.load(location.file)
+ end
+
+ Promote Function, :F
+ end
+end
diff --git a/external/lib/sevgi/external/cli.rb b/external/lib/sevgi/external/cli.rb
new file mode 100644
index 0000000..b00af62
--- /dev/null
+++ b/external/lib/sevgi/external/cli.rb
@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+require "sevgi/external"
+
+module Sevgi
+ module CLI
+ extend self
+
+ CLIError = Class.new(Sevgi::Error)
+
+ PROGNAME = "sevgi"
+ ENVVOMIT = "SEVGI_VOMIT"
+
+ Options = Struct.new(:preload, :require, :vomit, :help, :version) do
+ class << self
+ # codebeat:disable[ABC,BLOCK_NESTING,LOC]
+ def parse(argv)
+ new.tap do |options|
+ argv.first.start_with?("-") ? option(argv, options) : break until argv.empty?
+
+ next unless options.preload
+
+ CLIError.("No preload file found: #{options.preload}") unless ::File.exist?(options.preload)
+ end
+ end
+
+ private
+
+ def option(argv, options)
+ case (arg = argv.shift)
+ when "-l", "--preload" then options.preload = argv.shift
+ when "-r", "--require" then options.require = argv.shift
+ when "-x", "--exception" then options.vomit = true
+ when "-h", "--help" then options.help = true
+ when "-v", "--version" then options.version = true
+ else CLIError.("Not a valid option: #{arg}")
+ end
+ end
+ # codebeat:enable[ABC,BLOCK_NESTING,LOC]
+ end
+ end
+
+ private_constant :Options
+
+ def call(argv)
+ return puts(help) if (options = Options.parse(argv)).help
+ return puts(Sevgi::VERSION) if options.version
+
+ run(file = argv.shift, options)
+ rescue Exception => e # rubocop:disable Lint/RescueException
+ die(e, file, options)
+ end
+
+ private
+
+ def die(e, file, options)
+ abort(e.message) if e.is_a?(CLIError)
+
+ raise(e) if options.vomit || ENV[ENVVOMIT]
+
+ warn("")
+ abort(postmortem(file))
+ end
+
+ # codebeat:disable[ABC,LOC]
+ def help
+ <<~HELP
+ Usage: #{PROGNAME} [options...]
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
{{ section.extra.lead | default(value="Please start setting config.toml and adding your content.") | safe }}
+ {% if section.extra.list %}
+ {% for val in section.extra.list %}
+
+
{{ val.title }}
+
{{ val.content | safe }}
+
+ {% endfor %}
+ {% else %}
+
+
The power of Ruby β‘οΈ
+
Take advantage of Ruby's elegant programming and computational power to create pixel-perfect graphics without using a vector graphics editor in certain scenarios.
+
+
+
Rich helpers π οΈ
+
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.
+
+
+
Neat output β¨
+
Properly indented and informally validated SVG output to satisfy your possible aesthetic obsessions. The code produced is visually comprehensible without artificial bloats.
+
+ {% endif %}
+
+
+
+
+
+
+
+
+
+{% endblock content %}
diff --git a/showcase/srv/themes/adidoks/.gitignore b/showcase/srv/themes/adidoks/.gitignore
new file mode 100644
index 0000000..1e496a3
--- /dev/null
+++ b/showcase/srv/themes/adidoks/.gitignore
@@ -0,0 +1,3 @@
+public
+.vs
+.vscode
diff --git a/showcase/srv/themes/adidoks/CODE_OF_CONDUCT.md b/showcase/srv/themes/adidoks/CODE_OF_CONDUCT.md
new file mode 100644
index 0000000..b5dc127
--- /dev/null
+++ b/showcase/srv/themes/adidoks/CODE_OF_CONDUCT.md
@@ -0,0 +1,133 @@
+# Contributor Covenant Code of Conduct
+
+## 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
+.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+[https://www.contributor-covenant.org/version/2/0/code_of_conduct.html][v2.0].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available
+at [https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.0]: https://www.contributor-covenant.org/version/2/0/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations
+
diff --git a/showcase/srv/themes/adidoks/CONTRIBUTING.md b/showcase/srv/themes/adidoks/CONTRIBUTING.md
new file mode 100644
index 0000000..95c7022
--- /dev/null
+++ b/showcase/srv/themes/adidoks/CONTRIBUTING.md
@@ -0,0 +1,28 @@
+# Contributing
+
+We'd love your help! Thanks for caring about the theme of Zola.
+
+## Licensing
+
+This repository is under the MIT license. You can find the full text of the [license](./LICENSE) in this repository.
+
+## Code of Conduct
+
+The AdiDoks theme has a [code of conduct](./CODE_OF_CONDUCT.md) that governs all sub-projects, including this one. Please respect it!
+
+## Contribute to Doks
+
+- Follow the [GitHub flow](https://guides.github.com/introduction/flow/).
+- Follow the [Conventional Commits Specification](https://www.conventionalcommits.org/en/v1.0.0/)
+
+## Create an issue
+
+- [Bug report](https://github.com/aaranxu/adidoks/issues/new?template=bug-report---.md)
+- [Feature request](https://github.com/aaranxu/adidoks/issues/new?template=feature-request---.md)
+
+## Improve documentation
+
+π The documentation lives in [`./content/docs/`](https://github.com/aaranxu/adidoks/tree/master/content/docs) of the [`adidoks` repository](https://github.com/h-enk/getdoks.org).
+
+- Follow the [GitHub flow](https://guides.github.com/introduction/flow/).
+- Follow the [Conventional Commits Specification](https://www.conventionalcommits.org/en/v1.0.0/)
diff --git a/showcase/srv/themes/adidoks/LICENSE b/showcase/srv/themes/adidoks/LICENSE
new file mode 100644
index 0000000..60fda43
--- /dev/null
+++ b/showcase/srv/themes/adidoks/LICENSE
@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 Aaran Xu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/showcase/srv/themes/adidoks/README.md b/showcase/srv/themes/adidoks/README.md
new file mode 100644
index 0000000..8b060ac
--- /dev/null
+++ b/showcase/srv/themes/adidoks/README.md
@@ -0,0 +1,177 @@
+# Zola Theme AdiDoks
+
+AdiDoks is a modern documentation theme, which is a port of the Hugo
+theme [Doks](https://github.com/h-enk/doks) for Zola.
+
+## Demo
+
+[Live Preview](https://adidoks.netlify.app/).
+
+## Requirements
+
+Before using the theme, you need to install the [Zola](https://www.getzola.org/documentation/getting-started/installation/) β₯ 0.15.0.
+
+## Quick Start
+
+```bash
+git clone https://github.com/aaranxu/adidoks.git
+cd adidoks
+zola serve
+# open http://127.0.0.1:1111/ in the browser
+```
+
+Read more from [the document of the AdiDoks](https://adidoks.org/docs/getting-started/introduction/).
+
+## Installation
+
+Just earlier we showed you how to run the theme directly. Now we start to
+install the theme in an existing site step by step.
+
+### Step 1: Create a new zola site
+
+```bash
+zola init mysite
+```
+
+### Step 2: Install AdiDoks
+
+Download this theme to your themes directory:
+
+```bash
+cd mysite/themes
+git clone https://github.com/aaranxu/adidoks.git
+```
+
+Or install as a submodule:
+
+```bash
+cd mysite
+git init # if your project is a git repository already, ignore this command
+git submodule add https://github.com/aaranxu/adidoks.git themes/adidoks
+```
+
+### Step 3: Configuration
+
+Enable the theme in your `config.toml` in the site directory:
+
+```toml
+theme = "adidoks"
+```
+
+Or copy the `config.toml.example` from the theme directory to your project's
+root directory:
+
+```bash
+cp themes/adidoks/config.toml.example config.toml
+```
+
+### Step 4: Add new content
+
+You can copy the content from the theme directory to your project:
+
+```bash
+cp -r themes/adidoks/content .
+```
+
+You can modify or add new posts in the `content/blog`, `content/docs` or other
+content directories as needed.
+
+### Step 5: Run the project
+
+Just run `zola serve` in the root path of the project:
+
+```bash
+zola serve
+```
+
+AdiDoks will start the Zola development web server accessible by default at
+`http://127.0.0.1:1111`. Saved changes will live reload in the browser.
+
+## Customisation
+
+You can customize your configurations, templates and content for yourself. Look
+at the `config.toml`, `theme.toml`, `content` files and templates files in this
+repo for an idea.
+
+### Global Configuration
+
+There are some configuration options that you can customize in `config.toml`.
+
+#### Configuration options before `extra` options
+
+Set the authors's taxonomies for the site.
+
+```toml
+taxonomies = [
+ {name = "authors"},
+]
+```
+
+Use search function for the content.
+
+```toml
+build_search_index = true
+```
+
+#### Configuration options under the `extra`
+
+The following options should be under the `[extra]` in `config.toml`
+
+- `language_code` - set HTML file language (default to `en-US`)
+- `theme_color` - your site's HTML color (default to `#fff`)
+- `title_separator` - the separator to your site title, like `|` and `-` (defaults to `|`)
+- `title_addition` - the additon content for the title of the homepage
+- `timeformat` - the timeformat for the blog article published date
+- `timezone` - the timezone for the blog article published date
+- `edit_page` (and `docs_repo`, `repo_branch`) - whether to show the edit page in the github repo for your docs
+- `math` (and `library`) - set KaTeX or MathJax library
+- `[extra.open]` - Open Graph + Twitter Cards for the site
+- `[extra.schema]` - set JSON-LD for the site
+- `[[extra.menu.main]]` - the header navigations for the site
+- `[[extra.menu.social]]` - the social links on the header of the page
+- `[extra.footer]` - the footer content on the left
+- `[[extra.footer.nav]]` - the footer navigations on the right
+
+### Templates
+
+All pages are extend to the `base.html`, and you can customize them as need.
+
+### Content
+
+#### Homepage
+
+Go to the *content/_index.md* file to add your own homepage content.
+
+- `[extra]` - the main content of the homepage
+- `[[extra.ist]]` - the lists' content of the homepage
+
+#### Sections
+
+Each section includes a `_index.md`, and you can customize it or add your new
+section under the `content` folder.
+
+#### Pages
+
+There are mainly three types of pages in the site.
+
+- `blog` - blog article
+- `docs` - documentation article
+- `authors` - authors page if you need to add some information for a new author
+
+## Reporting Issues
+
+We use GitHub Issues as the official bug tracker for the **AdiDoks**. Please
+search [existing issues](https://github.com/aaranxu/adidoks/issues). Itβs
+possible someone has already reported the same problem.
+
+If your problem or idea is not addressed yet, [open a new issue](https://github.com/aaranxu/adidoks/issues/new).
+
+## Contributing
+
+We'd love your help! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) to learn
+about the kinds of contributions we're looking for.
+
+## License
+
+**AdiDoks** is distributed under the terms of the
+[MIT license](https://github.com/aaranxu/adidoks/blob/main/LICENSE).
diff --git a/showcase/srv/themes/adidoks/config.toml b/showcase/srv/themes/adidoks/config.toml
new file mode 100644
index 0000000..533366a
--- /dev/null
+++ b/showcase/srv/themes/adidoks/config.toml
@@ -0,0 +1,132 @@
+# The URL the site will be built for
+base_url = "https://adidoks.netlify.com"
+title = "AdiDoks"
+description = "AdiDoks is a Zola theme helping you build modern documentation websites, which is a port of the Hugo theme Doks for Zola."
+
+# The default language; used in feeds and search index
+# Note: the search index doesn't support Chinese/Japanese/Korean Languages
+default_language = "en"
+
+# Whether to automatically compile all Sass files in the sass directory
+compile_sass = true
+
+# Whether to generate a feed file for the site
+generate_feed = true
+
+# When set to "true", the generated HTML files are minified.
+minify_html = false
+
+# The taxonomies to be rendered for the site and their configuration.
+taxonomies = [
+ {name = "authors"}, # Basic definition: no feed or pagination
+]
+
+# Whether to build a search index to be used later on by a JavaScript library
+# When set to "true", a search index is built from the pages and section
+# content for `default_language`.
+build_search_index = true
+
+[languages.fi]
+title="AdiDoks"
+
+
+[search]
+# Whether to include the title of the page/section in the index
+include_title = true
+# Whether to include the description of the page/section in the index
+include_description = false
+# Whether to include the rendered content of the page/section in the index
+include_content = true
+
+[markdown]
+# Whether to do syntax highlighting.
+# Theme can be customised by setting the `highlight_theme`
+# variable to a theme supported by Zola
+highlight_code = true
+
+[extra]
+# Put all your custom variables here
+author = "Aaran Xu"
+github = "https://github.com/aaranxu"
+twitter = "https://twitter.com/aaranxu"
+email = "aaranxu@outlook.com"
+ganalytics = "" # Google Analytics code
+
+# If running on netlify.app site, set to true
+is_netlify = true
+
+# Set HTML file language
+language_code = "en-US"
+
+# Set theme-color meta tag for Chrome browser
+theme_color = "#fff"
+
+# More about site's title
+title_separator = "|" # set as |, -, _, etc
+title_addition = "Modern Documentation Theme"
+
+
+# Set date format in blog publish metadata
+timeformat = "%Y-%m-%d %H:%M:%S" # e.g. 2021-05-01 09:19:42
+timezone = "UTC"
+
+# Edit page on reposity or not
+edit_page = false
+docs_repo = "https://github.com/aaranxu/adidoks"
+repo_branch = "main"
+
+## Math settings
+# options: true, false. Enable math support globally,
+# default: false. You can always enable math on a per page.
+math = false
+library = "katex" # options: "katex", "mathjax". default is "katex".
+
+## Open Graph + Twitter Cards
+[extra.open]
+enable = true
+# this image will be used as fallback if a page has no image of its own
+image = "doks.png"
+twitter_site = "aaranxu"
+twitter_creator = "aaranxu"
+facebook_author = "ichunyun"
+facebook_publisher = "ichunyun"
+og_locale = "en_US"
+
+## JSON-LD
+[extra.schema]
+type = "Organization"
+logo = "logo-doks.png"
+twitter = "https://twitter.com/aaranxu"
+linked_in = ""
+github = "https://github.com/aaranxu"
+section = "blog" # see config.extra.main~url
+## Sitelinks Search Box
+site_links_search_box = false
+
+
+[[extra.menu.social]]
+name = "Twitter"
+pre = ''
+url = "https://twitter.com/aaranxu"
+weight = 10
+
+[[extra.menu.social]]
+name = "GitHub"
+pre = ''
+url = "https://github.com/aaranxu/adidoks"
+post = "v0.1.0"
+weight = 20
+
+# Footer contents
+[extra.footer]
+info = 'Powered by Netlify, Zola, and AdiDoks'
+
+[[extra.footer.nav]]
+name = "Privacy"
+url = "/privacy-policy/"
+weight = 10
+
+[[extra.footer.nav]]
+name = "Code of Conduct"
+url = "/docs/contributing/code-of-conduct/"
+weight = 20
diff --git a/showcase/srv/themes/adidoks/config.toml.example b/showcase/srv/themes/adidoks/config.toml.example
new file mode 100644
index 0000000..a395048
--- /dev/null
+++ b/showcase/srv/themes/adidoks/config.toml.example
@@ -0,0 +1,143 @@
+# The URL the site will be built for
+base_url = "https://adidoks.netlify.com"
+title = "AdiDoks"
+description = "AdiDoks is a Zola theme helping you build modern documentation websites, which is a port of the Hugo theme Doks for Zola."
+
+# The site theme to use.
+theme = "adidoks"
+
+# The default language; used in feeds and search index
+# Note: the search index doesn't support Chinese/Japanese/Korean Languages
+default_language = "en"
+
+# Whether to automatically compile all Sass files in the sass directory
+compile_sass = true
+
+# Whether to generate a feed file for the site
+generate_feed = true
+
+# When set to "true", the generated HTML files are minified.
+minify_html = false
+
+# The taxonomies to be rendered for the site and their configuration.
+taxonomies = [
+ {name = "authors"}, # Basic definition: no feed or pagination
+]
+
+# Whether to build a search index to be used later on by a JavaScript library
+# When set to "true", a search index is built from the pages and section
+# content for `default_language`.
+build_search_index = true
+
+[search]
+# Whether to include the title of the page/section in the index
+include_title = true
+# Whether to include the description of the page/section in the index
+include_description = false
+# Whether to include the rendered content of the page/section in the index
+include_content = true
+
+[markdown]
+# Whether to do syntax highlighting.
+# Theme can be customised by setting the `highlight_theme`
+# variable to a theme supported by Zola
+highlight_code = true
+
+[extra]
+# Put all your custom variables here
+author = "Aaran Xu"
+github = "https://github.com/aaranxu"
+twitter = "https://twitter.com/aaranxu"
+email = "aaranxu@outlook.com"
+
+# If running on netlify.app site, set to true
+is_netlify = true
+
+# Set HTML file language
+language_code = "en-US"
+
+# Set theme-color meta tag for Chrome browser
+theme_color = "#fff"
+
+# More about site's title
+title_separator = "|" # set as |, -, _, etc
+title_addition = "Modern Documentation Theme"
+
+
+# Set date format in blog publish metadata
+timeformat = "%B %e, %Y" # e.g. June 14, 2021
+timezone = "America/New_York"
+
+# Edit page on reposity or not
+edit_page = false
+docs_repo = "https://github.com/aaranxu/adidoks"
+repo_branch = "main"
+
+## Math settings
+# options: true, false. Enable math support globally,
+# default: false. You can always enable math on a per page.
+math = false
+library = "katex" # options: "katex", "mathjax". default is "katex".
+
+## Open Graph + Twitter Cards
+[extra.open]
+enable = true
+# this image will be used as fallback if a page has no image of its own
+image = "doks.png"
+twitter_site = "aaranxu"
+twitter_creator = "aaranxu"
+facebook_author = "ichunyun"
+facebook_publisher = "ichunyun"
+og_locale = "en_US"
+
+## JSON-LD
+[extra.schema]
+type = "Organization"
+logo = "logo-doks.png"
+twitter = "https://twitter.com/aaranxu"
+linked_in = ""
+github = "https://github.com/aaranxu"
+section = "blog" # see config.extra.main~url
+## Sitelinks Search Box
+site_links_search_box = false
+
+
+# Menu items
+[[extra.menu.main]]
+name = "Docs"
+section = "docs"
+url = "/docs/getting-started/introduction/"
+weight = 10
+
+[[extra.menu.main]]
+name = "Blog"
+section = "blog"
+url = "/blog/"
+weight = 20
+
+[[extra.menu.social]]
+name = "Twitter"
+pre = ''
+url = "https://twitter.com/aaranxu"
+weight = 10
+
+[[extra.menu.social]]
+name = "GitHub"
+pre = ''
+url = "https://github.com/aaranxu/adidoks"
+post = "v0.1.0"
+weight = 20
+
+# Footer contents
+[extra.footer]
+info = 'Powered by Netlify, Zola, and AdiDoks'
+
+[[extra.footer.nav]]
+name = "Privacy"
+url = "/privacy-policy/"
+weight = 10
+
+[[extra.footer.nav]]
+name = "Code of Conduct"
+url = "/docs/contributing/code-of-conduct/"
+weight = 20
diff --git a/showcase/srv/themes/adidoks/content/_index.fi.md b/showcase/srv/themes/adidoks/content/_index.fi.md
new file mode 100644
index 0000000..0e52f3c
--- /dev/null
+++ b/showcase/srv/themes/adidoks/content/_index.fi.md
@@ -0,0 +1,51 @@
++++
+title = "Nykyaikainen teema dokumentaatiolle"
+
+
+# The homepage contents
+[extra]
+lead = 'AdiDoks on nykyaikainen teema dokumentaatiosivustoille. Se on portattu Zolalle Hugo-teemasta nimeltΓ€ Doks.'
+url = "/docs/getting-started/introduction/"
+url_button = "Aloita"
+repo_version = "GitHub v0.1.0"
+repo_license = "Open-source MIT License."
+repo_url = "https://github.com/aaranxu/adidoks"
+
+# Menu items
+[[extra.menu.main]]
+name = "Dokumentaatio"
+section = "docs"
+url = "/docs/getting-started/introduction/"
+weight = 10
+
+[[extra.menu.main]]
+name = "Blogi"
+section = "blog"
+url = "/blog/"
+weight = 20
+
+[[extra.list]]
+title = "Turvallisuustietoinen"
+content = 'Saat A+-arvosanoja Mozilla ObservatoryssΓ€ suoraan. Voit vaihtaa turvallisuusheadereita tarpeidesi mukaan.'
+
+[[extra.list]]
+title = "Salamannopea β‘οΈ"
+content = 'Saat hyvΓ€t pisteet Google Lighthousessa defaultina. Doks poistaa tarpeettomat css:t, esinoutaa linkit, ja lataa kuvat laiskasti.'
+
+[[extra.list]]
+title = "SEO-valmis"
+content = "KΓ€ytΓ€ jΓ€rkeviΓ€ oletusarvoja rakenteiselle datalle, open graphille ja Twitter-korteille. Tai muunna SEO-asetukset mieleisiksesi helposti."
+
+[[extra.list]]
+title = "Fulltext-haku"
+content = "Tee hakuja sivuillesi FlexSearchilla. Muuntele indeksointiasetuksia mieleisiksesi helposti."
+
+[[extra.list]]
+title = "Sivujen layoutit"
+content = "Rakenna sivuja laskeutumisivun, blogisivun tai dokumentaatiolayoutin mukaan. LisÀÀ osioita ja komponentteja tarpeen mukaan."
+
+[[extra.list]]
+title = "Dark mode"
+content = "Vaihda hÀmÀrÀssÀ kÀytettÀvÀÀn kÀyttâliittymÀteemaan nappia painamalla. Muuta vÀrit muuttujilla vastaamaan brÀndiÀsi."
+
++++
diff --git a/showcase/srv/themes/adidoks/content/_index.md b/showcase/srv/themes/adidoks/content/_index.md
new file mode 100644
index 0000000..fb5961e
--- /dev/null
+++ b/showcase/srv/themes/adidoks/content/_index.md
@@ -0,0 +1,51 @@
++++
+title = "Modern Documentation Theme"
+
+
+# The homepage contents
+[extra]
+lead = 'AdiDoks is a modern documentation theme, which is a port of the Hugo theme Doks for Zola.'
+url = "/docs/getting-started/introduction/"
+url_button = "Get started"
+repo_version = "GitHub v0.1.0"
+repo_license = "Open-source MIT License."
+repo_url = "https://github.com/aaranxu/adidoks"
+
+# Menu items
+[[extra.menu.main]]
+name = "Docs"
+section = "docs"
+url = "/docs/getting-started/introduction/"
+weight = 10
+
+[[extra.menu.main]]
+name = "Blog"
+section = "blog"
+url = "/blog/"
+weight = 20
+
+[[extra.list]]
+title = "Security aware"
+content = 'Get A+ scores on Mozilla Observatory out of the box. Easily change the default Security Headers to suit your needs.'
+
+[[extra.list]]
+title = "Fast by default β‘οΈ"
+content = 'Get 100 scores on Google Lighthouse by default. Doks removes unused css, prefetches links, and lazy loads images.'
+
+[[extra.list]]
+title = "SEO-ready"
+content = "Use sensible defaults for structured data, open graph, and Twitter cards. Or easily change the SEO settings to your liking."
+
+[[extra.list]]
+title = "Full text search"
+content = "Search your Doks site with FlexSearch. Easily customize index settings and search options to your liking."
+
+[[extra.list]]
+title = "Page layouts"
+content = "Build pages with a landing page, blog, or documentation layout. Add custom sections and components to suit your needs."
+
+[[extra.list]]
+title = "Dark mode"
+content = "Switch to a low-light UI with the click of a button. Change colors with variables to match your branding."
+
++++
diff --git a/showcase/srv/themes/adidoks/content/authors/_index.md b/showcase/srv/themes/adidoks/content/authors/_index.md
new file mode 100644
index 0000000..0686f76
--- /dev/null
+++ b/showcase/srv/themes/adidoks/content/authors/_index.md
@@ -0,0 +1,18 @@
++++
+title = "Authors"
+description = "The authurs of the blog articles."
+date = 2021-04-01T08:00:00+00:00
+updated = 2021-04-01T08:00:00+00:00
+draft = false
+
+# If add a new author page in this section, please add a new item,
+# and the format is as follows:
+#
+# "author-name-in-url" = "the-full-path-of-the-author-page"
+#
+# Note: We use quoted keys here.
+[extra.author_pages]
+"aaran-xu" = "authors/aaran-xu.md"
++++
+
+The authors of the blog articles.
diff --git a/showcase/srv/themes/adidoks/content/authors/aaran-xu.md b/showcase/srv/themes/adidoks/content/authors/aaran-xu.md
new file mode 100644
index 0000000..386b0fe
--- /dev/null
+++ b/showcase/srv/themes/adidoks/content/authors/aaran-xu.md
@@ -0,0 +1,11 @@
++++
+title = "Aaran Xu"
+description = "Creator of AdiDoks."
+date = 2021-04-01T08:50:45+00:00
+updated = 2021-04-01T08:50:45+00:00
+draft = false
++++
+
+Creator of **AdiDoks**.
+
+[@aaranxu](https://github.com/aaranxu)
diff --git a/showcase/srv/themes/adidoks/content/blog/_index.md b/showcase/srv/themes/adidoks/content/blog/_index.md
new file mode 100644
index 0000000..95ecd8e
--- /dev/null
+++ b/showcase/srv/themes/adidoks/content/blog/_index.md
@@ -0,0 +1,7 @@
++++
+title = "Blog"
+description = "Blog"
+sort_by = "date"
+paginate_by = 2
+template = "blog/section.html"
++++
diff --git a/showcase/srv/themes/adidoks/content/blog/hello-world.md b/showcase/srv/themes/adidoks/content/blog/hello-world.md
new file mode 100644
index 0000000..541c613
--- /dev/null
+++ b/showcase/srv/themes/adidoks/content/blog/hello-world.md
@@ -0,0 +1,41 @@
++++
+title = "Hello World"
+description = "Introducing Doks, a Hugo theme helping you build modern documentation websites that are secure, fast, and SEO-ready β by default."
+date = 2021-05-01T09:19:42+00:00
+updated = 2021-05-01T09:19:42+00:00
+draft = false
+template = "blog/page.html"
+
+[taxonomies]
+authors = ["Rustaceans"]
+
+[extra]
+lead = "This is the source code of the traditional Hello World program."
++++
+
+```rust
+// This is a comment, and is ignored by the compiler
+
+// This is the main function
+fn main() {
+ // Statements here are executed when the compiled binary is called
+
+ // Print text to the console
+ println!("Hello World!");
+}
+```
+
+`println!` is a macro that prints text to the console.
+
+A binary can be generated using the Rust compiler: `rustc`.
+
+```bash
+$ rustc hello.rs
+```
+
+`rustc` will produce a `hello` binary that can be executed.
+
+```bash
+$ ./hello
+Hello World!
+```
diff --git a/showcase/srv/themes/adidoks/content/blog/markdown-syntax.md b/showcase/srv/themes/adidoks/content/blog/markdown-syntax.md
new file mode 100644
index 0000000..baccf97
--- /dev/null
+++ b/showcase/srv/themes/adidoks/content/blog/markdown-syntax.md
@@ -0,0 +1,152 @@
++++
+title = "Markdown Syntax Guide"
+description = "Sample article showcasing basic Markdown syntax and formatting for HTML elements."
+date = 2021-04-20T09:19:42+00:00
+updated = 2021-04-20T09:19:42+00:00
+draft = false
+template = "blog/page.html"
+
+[taxonomies]
+authors = ["Public"]
+
+[extra]
+lead = "This article offers a sample of basic Markdown syntax that can be used in Zola content files, also it shows whether basic HTML elements are decorated with CSS in a Zola theme."
++++
+
+## Headings
+
+The following HTML `
`β`
` elements represent six levels of section
+headings. `
` is the highest section level while `
` is the lowest.
+
+# H1
+## H2
+### H3
+#### H4
+##### H5
+###### H6
+
+## Paragraph
+
+Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum,
+voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma
+dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as
+cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin
+porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur?
+Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit
+ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda
+veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore
+eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata
+tiustia prat.
+
+Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne
+sapicia is sinveli squiatum, core et que aut hariosam ex eat.
+
+## Blockquotes
+
+The blockquote element represents content that is quoted from another source,
+optionally with a citation which must be within a `footer` or `cite` element,
+and optionally with in-line changes such as annotations and abbreviations.
+
+#### Blockquote without attribution
+
+> Tiam, ad mint andaepu dandae nostion secatur sequo quae.
+> **Note** that you can use *Markdown syntax* within a blockquote.
+
+#### Blockquote with attribution
+
+> Don't communicate by sharing memory, share memory by communicating.
+> β Rob Pike[^1]
+
+> All men by nature desire to know.
+> β Aristotle[^2]
+
+## Tables
+
+Tables aren't part of the core Markdown spec, but Zola supports them
+out-of-the-box.
+
+ Name | Age
+--------|------
+ Bob | 27
+ Alice | 23
+
+#### Inline Markdown within tables
+
+| Italics | Bold | Code |
+| -------- | -------- | ------ |
+| *italics* | **bold** | `code` |
+
+## Code Blocks
+
+#### Code block with backticks
+
+```html
+
+
+
+
+ Example HTML5 Document
+
+
+
Test
+
+
+```
+
+#### Code block indented with four spaces
+
+
+
+
+
+ Example HTML5 Document
+
+
+
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
+
+
+
+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
+.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+[https://www.contributor-covenant.org/version/2/0/code_of_conduct.html][v2.0].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available
+at [https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.0]: https://www.contributor-covenant.org/version/2/0/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations
diff --git a/showcase/srv/themes/adidoks/content/docs/contributing/how-to-contribute.md b/showcase/srv/themes/adidoks/content/docs/contributing/how-to-contribute.md
new file mode 100644
index 0000000..6999e36
--- /dev/null
+++ b/showcase/srv/themes/adidoks/content/docs/contributing/how-to-contribute.md
@@ -0,0 +1,37 @@
++++
+title = "How to Contribute"
+description = "Contribute to AdiDoks, improve documentation, or submit to showcase."
+date = 2021-05-01T18:10:00+00:00
+updated = 2021-05-01T18:10:00+00:00
+draft = false
+weight = 410
+sort_by = "weight"
+template = "docs/page.html"
+
+[extra]
+lead = "Contribute to AdiDoks, improve documentation, or submit to showcase."
+toc = true
+top = false
++++
+
+π Make sure to read the [Code of Conduct](../code-of-conduct/).
+
+## Contribute to Doks
+
+π The AdiDoks code lives in the [`adidoks` repository](https://github.com/aaranxu/adidoks)
+
+- Follow the [GitHub flow](https://guides.github.com/introduction/flow/).
+- Follow the [Conventional Commits Specification](https://www.conventionalcommits.org/en/v1.0.0/)
+
+### Create an issue
+
+- [Bug report](https://github.com/aaranxu/adidoks/issues/new?template=bug-report---.md)
+- [Feature request](https://github.com/aaranxu/adidoks/issues/new?template=feature-request---.md)
+
+## Improve documentation
+
+π The documentation lives in [`./content/docs/`](https://github.com/aaranxu/adidoks/tree/master/content/docs)
+of the [`adidoks` repository](https://github.com/h-enk/getdoks.org).
+
+- Follow the [GitHub flow](https://guides.github.com/introduction/flow/).
+- Follow the [Conventional Commits Specification](https://www.conventionalcommits.org/en/v1.0.0/)
diff --git a/showcase/srv/themes/adidoks/content/docs/getting-started/_index.md b/showcase/srv/themes/adidoks/content/docs/getting-started/_index.md
new file mode 100644
index 0000000..8b972db
--- /dev/null
+++ b/showcase/srv/themes/adidoks/content/docs/getting-started/_index.md
@@ -0,0 +1,10 @@
++++
+title = "Getting Started"
+description = "Quick start and guides for installing the AdiDoks theme on your preferred operating system."
+date = 2025-05-01T08:00:00+00:00
+updated = 2021-05-01T08:00:00+00:00
+template = "docs/section.html"
+sort_by = "weight"
+weight = 1
+draft = false
++++
diff --git a/showcase/srv/themes/adidoks/content/docs/getting-started/introduction.md b/showcase/srv/themes/adidoks/content/docs/getting-started/introduction.md
new file mode 100644
index 0000000..6dfe20b
--- /dev/null
+++ b/showcase/srv/themes/adidoks/content/docs/getting-started/introduction.md
@@ -0,0 +1,31 @@
++++
+title = "Introduction"
+description = "AdiDoks is a Zola theme helping you build modern documentation websites, which is a port of the Hugo theme Doks for Zola."
+date = 2021-05-01T08:00:00+00:00
+updated = 2021-05-01T08:00:00+00:00
+draft = false
+weight = 10
+sort_by = "weight"
+template = "docs/page.html"
+
+[extra]
+lead = 'AdiDoks is a Zola theme helping you build modern documentation websites, which is a port of the Hugo theme Doks for Zola.'
+toc = true
+top = false
++++
+
+## Quick Start
+
+One page summary of how to start a new AdiDoks project. [Quick Start β](../quick-start/)
+
+## Go further
+
+Contributing and Help.
+
+## Contributing
+
+Find out how to contribute to Doks. [Contributing β](../../contributing/how-to-contribute/)
+
+## Help
+
+Get help on Doks. [Help β](../../help/faq/)
diff --git a/showcase/srv/themes/adidoks/content/docs/getting-started/quick-start.md b/showcase/srv/themes/adidoks/content/docs/getting-started/quick-start.md
new file mode 100644
index 0000000..db3a22d
--- /dev/null
+++ b/showcase/srv/themes/adidoks/content/docs/getting-started/quick-start.md
@@ -0,0 +1,94 @@
++++
+title = "Quick Start"
+description = "One page summary of how to start a new AdiDoks project."
+date = 2021-05-01T08:20:00+00:00
+updated = 2021-05-01T08:20:00+00:00
+draft = false
+weight = 20
+sort_by = "weight"
+template = "docs/page.html"
+
+[extra]
+lead = "One page summary of how to start a new AdiDoks project."
+toc = true
+top = false
++++
+
+## Requirements
+
+Before using the theme, you need to install the [Zola](https://www.getzola.org/documentation/getting-started/installation/) β₯ 0.15.0.
+
+## Run the Theme Directly
+
+```bash
+git clone https://github.com/aaranxu/adidoks.git
+cd adidoks
+zola serve
+```
+
+Visit `http://127.0.0.1:1111/` in the browser.
+
+## Installation
+
+Just earlier we showed you how to run the theme directly. Now we start to
+install the theme in an existing site step by step.
+
+### Step 1: Create a new zola site
+
+```bash
+zola init mysite
+```
+
+### Step 2: Install AdiDoks
+
+Download this theme to your themes directory:
+
+```bash
+cd mysite/themes
+git clone https://github.com/aaranxu/adidoks.git
+```
+
+Or install as a submodule:
+
+```bash
+cd mysite
+git init # if your project is a git repository already, ignore this command
+git submodule add https://github.com/aaranxu/adidoks.git themes/adidoks
+```
+
+### Step 3: Configuration
+
+Enable the theme in your `config.toml` in the site derectory:
+
+```toml
+theme = "adidoks"
+```
+
+Or copy the `config.toml.example` from the theme directory to your project's
+root directory:
+
+```bash
+cp themes/adidoks/config.toml.example config.toml
+```
+
+### Step 4: Add new content
+
+You can copy the content from the theme directory to your project:
+
+```bash
+cp -r themes/adidoks/content .
+```
+
+You can modify or add new posts in the `content/blog`, `content/docs` or other
+content directories as needed.
+
+### Step 5: Run the project
+
+Just run `zola serve` in the root path of the project:
+
+```bash
+zola serve
+```
+
+AdiDoks will start the Zola development web server accessible by default at
+`http://127.0.0.1:1111`. Saved changes will live reload in the browser.
diff --git a/showcase/srv/themes/adidoks/content/docs/help/_index.md b/showcase/srv/themes/adidoks/content/docs/help/_index.md
new file mode 100644
index 0000000..8cfed4b
--- /dev/null
+++ b/showcase/srv/themes/adidoks/content/docs/help/_index.md
@@ -0,0 +1,10 @@
++++
+title = "Help"
+description = "Get help on AdiDoks."
+date = 2025-05-01T19:00:00+00:00
+updated = 2021-05-01T19:00:00+00:00
+template = "docs/section.html"
+sort_by = "weight"
+weight = 5
+draft = false
++++
diff --git a/showcase/srv/themes/adidoks/content/docs/help/faq.md b/showcase/srv/themes/adidoks/content/docs/help/faq.md
new file mode 100644
index 0000000..b001001
--- /dev/null
+++ b/showcase/srv/themes/adidoks/content/docs/help/faq.md
@@ -0,0 +1,39 @@
++++
+title = "FAQ"
+description = "Answers to frequently asked questions."
+date = 2021-05-01T19:30:00+00:00
+updated = 2021-05-01T19:30:00+00:00
+draft = false
+weight = 30
+sort_by = "weight"
+template = "docs/page.html"
+
+[extra]
+lead = "Answers to frequently asked questions."
+toc = true
+top = false
++++
+
+## What is the AdiDoks?
+
+AdiDoks is a Zola theme for Documentation's sites, ported by the Hugo Theme
+[Doks](https://getdoks.org), which is a pretty nice theme. Thanks a lot to
+[*h-enk*](https://github.com/h-enk), the creator of the [Doks](https://getdoks.org).
+
+## Keyboard shortcuts for search?
+
+- focus: `/`
+- select: `β` and `β`
+- open: `Enter`
+- close: `Esc`
+
+## Other documentation?
+
+- [Netlify](https://docs.netlify.com/)
+- [Zola](https://www.getzola.org/documentation/getting-started/overview/)
+
+## Contact the creator?
+
+Send *Aaran Xu* an E-mail:
+
+-
diff --git a/showcase/srv/themes/adidoks/content/privacy-policy/_index.md b/showcase/srv/themes/adidoks/content/privacy-policy/_index.md
new file mode 100644
index 0000000..d8050da
--- /dev/null
+++ b/showcase/srv/themes/adidoks/content/privacy-policy/_index.md
@@ -0,0 +1,27 @@
++++
+title = "Privacy Policy"
+description = "We do not use cookies and we do not collect any personal data."
+date = 2021-05-01T08:00:00+00:00
+updated = 2020-05-01T08:00:00+00:00
+draft = false
+
+[extra]
+class = "page single"
++++
+
+__TLDR__: We do not use cookies and we do not collect any personal data.
+
+## Website visitors
+
+- No personal information is collected.
+- No information is stored in the browser.
+- No information is shared with, sent to or sold to third-parties.
+- No information is shared with advertising companies.
+- No information is mined and harvested for personal and behavioral trends.
+- No information is monetized.
+
+## Contact us
+
+[Contact us](https://github.com/aaranxu/adidoks) if you have any questions.
+
+Effective Date: _1st May 2021_
diff --git a/showcase/srv/themes/adidoks/netlify.toml b/showcase/srv/themes/adidoks/netlify.toml
new file mode 100644
index 0000000..0f91fa9
--- /dev/null
+++ b/showcase/srv/themes/adidoks/netlify.toml
@@ -0,0 +1,9 @@
+[build]
+publish = "public"
+command = "zola build"
+
+[build.environment]
+ZOLA_VERSION = "0.15.0"
+
+[context.deploy-preview]
+command = "zola build --base-url $DEPLOY_PRIME_URL"
diff --git a/showcase/srv/themes/adidoks/sass/_custom.scss b/showcase/srv/themes/adidoks/sass/_custom.scss
new file mode 100644
index 0000000..e69de29
diff --git a/showcase/srv/themes/adidoks/sass/bootstrap/LICENSE b/showcase/srv/themes/adidoks/sass/bootstrap/LICENSE
new file mode 100644
index 0000000..72dda23
--- /dev/null
+++ b/showcase/srv/themes/adidoks/sass/bootstrap/LICENSE
@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2011-2021 Twitter, Inc.
+Copyright (c) 2011-2021 The Bootstrap Authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
diff --git a/showcase/srv/themes/adidoks/sass/bootstrap/README.md b/showcase/srv/themes/adidoks/sass/bootstrap/README.md
new file mode 100644
index 0000000..6d87cec
--- /dev/null
+++ b/showcase/srv/themes/adidoks/sass/bootstrap/README.md
@@ -0,0 +1,239 @@
+
` all receive top and bottom margins. We nuke the top\n// margin for easier control within type scales as it avoids margin collapsing.\n\n%heading {\n margin-top: 0; // 1\n margin-bottom: $headings-margin-bottom;\n font-family: $headings-font-family;\n font-style: $headings-font-style;\n font-weight: $headings-font-weight;\n line-height: $headings-line-height;\n color: $headings-color;\n}\n\nh1 {\n @extend %heading;\n @include font-size($h1-font-size);\n}\n\nh2 {\n @extend %heading;\n @include font-size($h2-font-size);\n}\n\nh3 {\n @extend %heading;\n @include font-size($h3-font-size);\n}\n\nh4 {\n @extend %heading;\n @include font-size($h4-font-size);\n}\n\nh5 {\n @extend %heading;\n @include font-size($h5-font-size);\n}\n\nh6 {\n @extend %heading;\n @include font-size($h6-font-size);\n}\n\n\n// Reset margins on paragraphs\n//\n// Similarly, the top margin on `
`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 `
` alignment by inheriting `text-align`.\n// 3. Fix alignment for Safari\n\nth {\n font-weight: $table-th-font-weight; // 1\n text-align: inherit; // 2\n text-align: -webkit-match-parent; // 3\n}\n\nthead,\ntbody,\ntfoot,\ntr,\ntd,\nth {\n border-color: inherit;\n border-style: solid;\n border-width: 0;\n}\n\n\n// Forms\n//\n// 1. Allow labels to use `margin` for spacing.\n\nlabel {\n display: inline-block; // 1\n}\n\n// Remove the default `border-radius` that macOS Chrome adds.\n// See https://github.com/twbs/bootstrap/issues/24093\n\nbutton {\n // stylelint-disable-next-line property-disallowed-list\n border-radius: 0;\n}\n\n// Explicitly remove focus outline in Chromium when it shouldn't be\n// visible (e.g. as result of mouse click or touch tap). It already\n// should be doing this automatically, but seems to currently be\n// confused and applies its very visible two-tone outline anyway.\n\nbutton:focus:not(:focus-visible) {\n outline: 0;\n}\n\n// 1. Remove the margin in Firefox and Safari\n\ninput,\nbutton,\nselect,\noptgroup,\ntextarea {\n margin: 0; // 1\n font-family: inherit;\n @include font-size(inherit);\n line-height: inherit;\n}\n\n// Remove the inheritance of text transform in Firefox\nbutton,\nselect {\n text-transform: none;\n}\n// Set the cursor for non-`