initial commit

docs/guides/creating-arise-pages/README.md

@@ -0,0 +1,122 @@
+# Creating Arise Pages
+
+This documentation page will explain how Arise websites are structured, how to create new pages, and the options that are available when configuring a new page.
+
+## Site Architecture Overview
+
+All pages in Arise have a common modular structure. Each page is made up of a folder with an `index.md` at the root of the page. Thumbnails, images, and other page assets should be stored in the same folder as the page `index.md` file. The basic structure of every page in Arise can be visualised like this:
+
+```
+    .
+    ├── pagename/
+    │   ├── index.md
+    │   ├── thumbnail.png
+    │   └── [other assets]
+    └── ...
+```
+
+When Arise builds your site, it traverses the folder structure of the entire site and builds everything with the above structure in mind.
+
+For large folders full of pages, Arise also supports the creation of dynamically generated index pages. You can tell Arise to create an index page at a given folder by using the `toc` setting (see: [Optional Settings](#optional-settings)) in your index folder's `index.md`. 
+
+The structure of an Arise website making use of indices should look something like this:
+
+```
+    .
+    ├── index1/
+    │   ├── index.md
+    │   ├── page1/..
+    │   └── page2/..
+    │
+    ├── index2/
+    │   ├── index.md                                   
+    │   ├── page1/..                                                                   
+    │   └── page2/..  
+    └── ...
+```
+
+
+## Creating New Pages
+
+To create a new page, simply create a folder and make an `index.md` file with an Arise metadata header at the very top of the file. A standard Arise metadata header looks like this:
+
+```
+<!-- BEGIN ARISE ------------------------------
+Title:: "My Cool Page"
+
+Author:: "Johnny Silverhand"
+Description:: "Write a thrilling description here"
+Language:: "en"
+Thumbnail:: "thumbnail.png"
+Published Date:: "2077-05-12"
+Modified Date:: "2077-05-12"
+
+toc:: "false"
+process_markdown:: "true"
+content_header:: "true"
+---- END ARISE \\ DO NOT MODIFY THIS LINE ---->
+```
+
+The Arise metadata header is broken up into three sections **Critical** settings, **Standard** settings, and **Optional** settings. The setting variable names are case sensitive.
+
+### Critical Settings
+
+If critical settings are not included or are left blank your page will not build. There is currently only one critical setting:
+
+- **Title**: This is the human-readable title of your web page. It cannot be left blank or your page will not build.
+
+### Standard Settings
+
+Standard settings must be present in your page header, but they can optionally be left blank. However, it is not recommended to leave them blank because your page will be missing SEO data if these settings are not populated.
+
+- **Author**: Who wrote this page
+- **Description**: A brief human-readable description of your page. This will be what appears in the subtext of search engine results or social media that supports rich embeds, so you are advised (but not required) to keep this field under 120 characters in length.
+- **Language**: The [ISO 639-1 language code](https://www.w3schools.com/tags/ref_language_codes.asp) for the language your page is written in.
+- **Thumbnail**: The filename of your thumbnail image. The thumbnail image must be in the same folder as your `index.md` for your page.
+- **Published Date**: The [ISO-8601 short date](https://en.wikipedia.org/wiki/ISO_8601#Calendar_dates) (aka: YYYY-MM-DD) for when your page was originally published to your site.
+- **Modified Date**: The [ISO-8601 short date](https://en.wikipedia.org/wiki/ISO_8601#Calendar_dates) (aka: YYYY-MM-DD) for when your page was last modified.
+
+### Optional Settings
+
+Optional settings can be omitted entirely from your header. These settings contain advanced options for special functionality within Arise. If you choose to omit one of these options, Arise will build your page with the default setting for any omitted optional setting. Optional page settings that are available include:
+
+- **content_header**: (Default: **true**) Arise has a special build file `config/content_header.html` with content to be appended to every page immediately after the opening `<body>` tag.  However, for some special pages on your website, you may want to format the body of your page in a completely unique way that omits your standard site elements within the `<body>`. If you set `content_header` to `"false"`, the content header (but not SEO header) will be omitted from your special page so that you can format the body individually for that page.
+    - By default, the only thing included in the content header is a tag to display the post date and author of any given post. You can always add more or change the default content header to your liking if you have other standard content you'd like included in the body of your page!
+- **process_markdown**: (Default: **true**) Arise is designed to build pages written in [Markdown](https://daringfireball.net/projects/markdown/). However, let's say you have a page that is already written in HTML. When you set `process_markdown` to `"false"`, Arise will skip the step of converting Markdown into HTML and just pass the raw contents of your `index.md` as the body of your page. 
+    - This setting is particularly useful if you are porting content from another website that already has the body of your content in HTML format and you don't want any additional processing beyond the addition of a header+footer to be done to it.
+- **toc**: (Default: **false**) This is a special setting that instructs Arise that the folder containing this `index.md` isn't actually a normal page, but rather a folder containing other pages that you'd like a traversable index/TOC built for. If you set `toc` to `"true"`, Arise will look through all the folders contained in the current folder, grab their metadata if they are Arise-formatted pages, and generate a pretty index for you.
+    - If this setting is enabled, Arise will ignore all content present after the Arise metadata header and create an index/TOC page instead.
+- **rss_hide**: (Default: **false**) When set to "true", this setting hides your page from the RSS feed. This is useful for meta pages (privacy policy, contact, etc) that you don't want to send to the feeds for your RSS readers.
+    - Note that dynamically generated TOC pages are automatically hidden from your RSS feed, so you do not need to manually add this setting for those pages.
+
+## Page Themes
+
+All pages in Arise are built by concatenating the following files in the following order:
+- [/config/header.html](/arise-source/config/header.html)
+- [/config/content_header.html](/arise-source/config/content_header.html)
+- The `index.md` for the page being built
+- [/config/footer.html](/arise-source/config/footer.html)
+
+If you want to change the style or overall layout of your website, you need to edit the `/config/header.html` file for your website.
+
+By default, the stylesheet used by `/config/header.html` is [/config/main.css](/arise-source/config/main.css).
+
+The Arise header supports the following dynamic metadata tags, which will be populated with info from the page being built at build time:
+- `{{base_url}}` - The base url for your website, in the format of `https://example.com`
+- `{{global_name}}` - The human-readable global name of your website
+- `{{title}}` - The title of the page being built
+- `{{author}}` - The author of the page being built
+- `{{description}}` - The human-readable description of the page being built
+- `{{language}}` - The [ISO 639-1 language code](https://www.w3schools.com/tags/ref_language_codes.asp) for the language your page is written in.
+- `{{thumbnail}}` - The filename of your thumbnail image.
+- `{{published_date}}` - The [ISO-8601 short date](https://en.wikipedia.org/wiki/ISO_8601#Calendar_dates) (aka: YYYY-MM-DD) for when your page was originally published to your site.
+- `{{modified_date}}` - The [ISO-8601 short date](https://en.wikipedia.org/wiki/ISO_8601#Calendar_dates) (aka: YYYY-MM-DD) for when your page was last modified.
+
+Note that Arise automatically checks metadata strings for XML-unsafe characters and replaces them with [XML escape codes](https://docs.oracle.com/cd/A97335_02/apps.102/bc4j/developing_bc_projects/obcCustomXml.htm) at runtime. This ensures that you don't accidentally break your sitemap or RSS feed by having quotes or whatever in your page metadata.
+
+## Caveats & Gotchas
+
+There are some caveats to how this data is processed that you should be mindful of.
+
+- Arise specifically looks for files titled `index.md` for its build process. Do yourself a favour and don't name files `index.md` if you don't want Arise to include them.
+- `/config` is a specially directory reserved for site templates and live sitewide assets. Arise will not build pages in this folder or its subfolders.

docs/guides/getting-started/README.md

@@ -0,0 +1,26 @@
+# Getting Started with Arise
+
+Welcome to Arise! Arise is designed to be a cloud-native application. This guide will walk you through the basics of how to build and deploy your website to the cloud using Arise.
+
+It's actually very simple to get a website up and running using Arise.
+
+## Cloud Deployments
+
+1. Fork this repo
+2. Edit the global Arise site configuration file at `/arise-source/config/arise.conf`
+3. Edit the example site in `/arise-source/` to your liking
+    - Check out the page on [creating pages](../creating-arise-pages/README.md) for more information on the specifics of how Arise pages work
+4. Configure your `/arise-source/robots.txt` with your site domain and any additional crawler settings you'd like to set.
+5. Upon any new commit to the site source files, the GitHub Actions workflow present in `/.github/workflows/` will automatically build your website based on the contents of `/arise-source/` and output the built files to your `html` branch.
+6. Configure your cloud web host of choice to automatically deploy a static site from the `html` branch of your repo. Specific instructions for several notable providers can be found below:
+    - [Cloudflare Pages](cloudflare/README.md)
+    - [DigitalOcean](digitalocean/README.md)
+    - [GitHub Pages](github-pages/README.md)
+
+Congrats! Your site is now up and running! If you want to make changes to your website, you can simply make a commit to the `main` branch of your repo source files and it will automatically be deployed to your live website! Pretty wiz, yeah?
+
+## Running Arise Locally (Not Recommended)
+
+You can also clone this repo and run Arise locally. However, this not recommended because you are honestly wasting your time by manually running the build process and managing the build artefacts instead of just sitting back and letting CI/CD do the work for you.
+
+If you REALLY want to run Arise locally, please refer to [this guide](../running-arise-locally/README.md).

docs/guides/getting-started/cloudflare/README.md

@@ -0,0 +1,21 @@
+# Deploying to Cloudflare Pages
+
+This guide assumes that you have completed steps 1-3 from [Getting Started](../README.md) and have a successfully build website in your `html` branch.
+
+1. Navigate to your [Cloudflare Dashboard](https://dash.cloudflare.com) and click **Pages** in the sidebar.
+2. Click **Create a project** > **Connect to Git**.
+3. Add your account and select your repository. Click **Begin setup** to proceed.
+4. Name your project whatever you'd like and select `html` as your **Production branch**. Leave all the optional **Build settings** blank-- we don't need any of these.
+<p align="center"><img src="cloudflare-1.png" alt="Screenshot: Cloudflare Pages Deploy Settings" width=50% height=50% /></p>
+
+5. Click **Save and Deploy**
+6. **IMPORTANT**: Click **Pages** in the sidebar and click on your site.
+7. Click **Settings**.
+8. Click **Builds & deployments**.
+9. Click **Configure Preview deployments**.
+10. Click **None** and **Save**. 
+<p align="center"><img src="cloudflare-2.png" alt="Screenshot: Disable Cloudflare Preview deployments" width=50% height=50% /></p>
+
+As of this writing, if you don't IMMEDIATELY disable preview deployments, Cloudflare will automatically generate live externally-accessible "preview" URLs for every single branch in your website repo (even if your repo is private). Based on how Arise works, this will not only result in previews that are broken and do not work, but it will disclose literally everything in your repo including potentially WIP pages if your repo is private. To put a cherry on top, after preview deployments have been build for a branch, you cannot delete them without deleting and re-adding your entire damn website. What a stupid-ass system.
+
+Anyway, rants aside, your site should now be up and running on Cloudflare Pages! Congrats! If you'd like to use a custom domain, please review Cloudflare's [custom domains guide](https://developers.cloudflare.com/pages/platform/custom-domains/) as that is outside of the scope of this documentation.

docs/guides/getting-started/digitalocean/README.md

@@ -0,0 +1,13 @@
+# Deploying to DigitalOcean
+
+This guide assumes that you have completed steps 1-3 from [Getting Started](../README.md) and have a successfully build website in your `html` branch.
+
+1. Navigate to the [Apps](https://cloud.digitalocean.com/apps) pane in your DigitalOcean account.
+2. Click **Create App**.
+2. Select **GitHub** as your source, select your repository, and define `html` as your target branch. Leave `/` as your source directory. Leave the box checked next to **Autodeploy** so that your site will automatically pull new updates whenever you push a commit to `main` in your Arise site repo on GitHub. Hit **Next** to proceed. 
+<p align="center"><img src="digitalocean-1.png" alt="Screenshot: DigitalOcean Deploy Settings" width=50% height=50% /></p>
+
+3. Click **Skip to Review** to skip past all the other optional settings-- we don't need any of them.
+4. Click **Create Resources**.
+
+Congrats! Your Arise website is now live on DigitalOcean. If you'd like to use a custom domain, please review DigitalOcean's [custom domains guide](https://docs.digitalocean.com/products/app-platform/how-to/manage-domains/) as that is outside of the scope of this documentation.

docs/guides/getting-started/github-pages/README.md

@@ -0,0 +1,15 @@
+# Deploying to GitHub Pages
+
+This guide assumes that you have completed steps 1-3 from [Getting Started](../README.md) and have a successfully build website in your `html` branch.
+
+This guide will also assume that you don't already have a GitHub Pages site and are using Arise to host your User Site. For Project Sites, please review [GitHub's documentation](https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages#types-of-github-pages-sites).
+
+Frankly, the configuration annoyance of GitHub Pages with multiple hosted sites is a pretty good reason to use a provider like [Cloudflare Pages](../cloudflare/README.md) or [DigitalOcean](../digitalocean/README.md) instead.
+
+1. Name your repo to **yourusername.github.io**. 
+2. Navigate to your repo and click **Settings** in the navbar.
+3. Click **Pages** in the sidebar.
+4. Under the dropdown for **Source**, click **Deploy from a branch**.
+5. Select the `html` branch. Leave `/ (root)` as the folder and click **Save**.
+
+Congrats! Your Arise website is now live on GitHub Pages. If you'd like to use a custom domain, please review GitHub's [custom domains guide](https://docs.github.com/articles/using-a-custom-domain-with-github-pages/) as that is outside of the scope of this documentation.

docs/guides/running-arise-locally/README.md

@@ -0,0 +1,39 @@
+# Running Arise Locally
+
+The following instructions will walk you through how to build an Arise website by running Arise on your local machine. This is primarily intended for development and not regular use. If you just want to throw up an Arise website as easily as possible, please use the cloud native instructions in the [Getting Started](../getting-started/README.md) guide.
+
+1. Ensure you have the [proper dependencies](/README.md#dependencies) installed.
+2. Clone this repo and cd into it: `git clone https://github.com/spectrasecure/arise && cd arise`
+3. Edit the global Arise site configuration file at `/arise-source/config/arise.conf`
+4. Edit the example site in `/arise-source/` to your liking
+    - Check out the page on [creating pages](../creating-arise-pages/README.md) for more information on the specifics of how Arise pages work
+5. Configure your `robots.txt` in the root of the repository with your site domain and any additional crawler settings you'd like to set.
+6. Build Arise by running `bash arise build`
+7. Your built site will be output to `arise-out/`. It is up to you to upload these wherever to host your site.
+
+### Command Line Arguments for Arise
+
+The Arise shell script allows for several partial build modes, largely for testing purposes. These options are also displayed to you in the Help prompt which is displayed if you attempt to run Arise without any options or with invalid options.
+
+```
+Usage:
+------
+bash arise build -[k][f]
+        # Builds the entire site
+        available in all build modes:
+                -k: Keeps source files in output
+                -f: Force overwrite pre-existing output
+bash arise -[p|s|r][k][f]
+        # Builds only specific parts of the site
+        # Useful for testing purposes
+        mutually exclusive options:
+                -p: Build pages only mode
+                -s: Build sitemap only mode
+                -r: Build rss only mode
+```
+
+- `bash arise -p` - Running Arise in this manner will only build (p)ages. It will not build the sitemap or the RSS feed.
+- `bash arise -s` - Running Arise in this manner will only build the (s)itemap. It won't build anything else.
+- `bash arise -r` - Running Arise in this manner will only build the (r)ss feed. It won't build anything else.
+- `-k` - Adding this flag to any build mode will (k)eep the source files in the output directory rather than deleting them from the output.
+- `-f` - By default, Arise will throw an error if the output folder `arise-out` already has contents in it in order to prevent you from accidentally overwriting your current built output. If you would like to override this safeguard and (f)orce Arise to delete the current contents of `arise-out`, this is the flag to do so.

docs/logo/arise-logo.svg

@@ -0,0 +1,269 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   width="14.042mm"
+   height="5.3959999mm"
+   viewBox="0 0 14.041999 5.3959999"
+   version="1.1"
+   id="svg5"
+   inkscape:version="1.2.1 (9c6d41e410, 2022-07-14)"
+   sodipodi:docname="arise-logo.svg"
+   inkscape:export-filename="arise-logo-transparent.png"
+   inkscape:export-xdpi="542.65778"
+   inkscape:export-ydpi="542.65778"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <sodipodi:namedview
+     id="namedview7"
+     pagecolor="#ffffff"
+     bordercolor="#000000"
+     borderopacity="0.25"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     inkscape:document-units="mm"
+     showgrid="false"
+     inkscape:zoom="13.516172"
+     inkscape:cx="39.471234"
+     inkscape:cy="6.1407918"
+     inkscape:window-width="3440"
+     inkscape:window-height="1369"
+     inkscape:window-x="-8"
+     inkscape:window-y="-8"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="g1560" />
+  <defs
+     id="defs2">
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect176" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect440" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect475" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect542" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect544" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect546" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect552" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect558" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect688" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect690" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect692" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect797" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect799" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect801" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect936" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect938" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect940" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect1088" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect1090" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect1092" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect1562" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect1564" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect1566" />
+  </defs>
+  <g
+     inkscape:groupmode="layer"
+     id="layer2"
+     inkscape:label="BG"
+     style="display:none"
+     transform="translate(-9.2390895,-64.757885)">
+    <rect
+       style="display:inline;fill:#000000;fill-opacity:1;stroke-width:0.0412021"
+       id="rect1828"
+       width="17.772917"
+       height="8.028266"
+       x="7.9025664"
+       y="63.659115"
+       inkscape:label="Background" />
+  </g>
+  <g
+     inkscape:label="ARISE"
+     inkscape:groupmode="layer"
+     id="g1560"
+     style="display:inline;fill:#65f85a;fill-opacity:1;stroke:#112b26;stroke-width:0.2;stroke-dasharray:none;stroke-opacity:1"
+     transform="translate(-6.5038345,-63.220897)">
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:6.06473px;font-family:'ROBOTECH GP';-inkscape-font-specification:'ROBOTECH GP';letter-spacing:-0.284284px;display:inline;fill:#65f85a;fill-opacity:1;stroke:#112b26;stroke-width:0.2;stroke-dasharray:none;stroke-opacity:1"
+       x="14.917694"
+       y="62.806774"
+       id="text1550"
+       transform="scale(0.9306992,1.074461)"
+       sodipodi:insensitive="true"
+       inkscape:label="E"><tspan
+         sodipodi:role="line"
+         id="tspan1548"
+         style="fill:#65f85a;fill-opacity:1;stroke:#112b26;stroke-width:0.2;stroke-dasharray:none;stroke-opacity:1"
+         x="14.917694"
+         y="62.806774">  e</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:5.76972px;font-family:'ROBOTECH GP';-inkscape-font-specification:'ROBOTECH GP';letter-spacing:-0.29811px;display:inline;fill:#65f85a;fill-opacity:1;stroke:#112b26;stroke-width:0.2;stroke-dasharray:none;stroke-opacity:1"
+       x="16.334536"
+       y="59.891228"
+       id="text1558"
+       transform="scale(0.88753215,1.1267197)"
+       inkscape:label="S"
+       sodipodi:insensitive="true"><tspan
+         sodipodi:role="line"
+         id="tspan1556"
+         style="font-size:5.76972px;fill:#65f85a;fill-opacity:1;stroke:#112b26;stroke-width:0.2;stroke-dasharray:none;stroke-opacity:1"
+         x="16.334536"
+         y="59.891228"
+         dx="0">$</tspan></text>
+    <text
+       xml:space="preserve"
+       transform="matrix(0.26458333,0,0,0.26458333,2.7456913,0)"
+       id="text1546"
+       style="white-space:pre;shape-inside:url(#rect1566);display:inline;fill:#65f85a;fill-opacity:1;stroke:#112b26;stroke-width:0.755906;stroke-dasharray:none;stroke-opacity:1"
+       sodipodi:insensitive="true"
+       inkscape:label="I"><tspan
+         x="29.511719"
+         y="255.05469"
+         id="tspan6839"><tspan
+           style="font-weight:bold;font-family:Woodwarrior;-inkscape-font-specification:'Woodwarrior Bold'"
+           id="tspan6837">  I</tspan></tspan></text>
+    <text
+       xml:space="preserve"
+       id="text1542"
+       style="white-space:pre;shape-inside:url(#rect1564);display:inline;fill:#65f85a;fill-opacity:1;stroke:#112b26;stroke-width:0.755906;stroke-dasharray:none;stroke-opacity:1"
+       sodipodi:insensitive="true"
+       inkscape:label="R"
+       transform="scale(0.26458333)"><tspan
+         x="29.511719"
+         y="255.05469"
+         id="tspan6845"><tspan
+           style="font-family:Woodwarrior;-inkscape-font-specification:Woodwarrior"
+           id="tspan6841">  </tspan><tspan
+           style="font-weight:bold;font-family:Woodwarrior;-inkscape-font-specification:'Woodwarrior Bold'"
+           id="tspan6843">R</tspan></tspan></text>
+    <text
+       xml:space="preserve"
+       transform="matrix(-0.26458333,0,0,0.26458333,18.107909,0)"
+       id="text1534"
+       style="white-space:pre;shape-inside:url(#rect1562);display:inline;fill:#65f85a;fill-opacity:1;stroke:#112b26;stroke-width:0.755906;stroke-dasharray:none;stroke-opacity:1"
+       sodipodi:insensitive="true"
+       inkscape:label="A"><tspan
+         x="29.511719"
+         y="255.05469"
+         id="tspan6849"><tspan
+           style="font-weight:bold;font-family:Woodwarrior;-inkscape-font-specification:'Woodwarrior Bold'"
+           id="tspan6847">A</tspan></tspan></text>
+  </g>
+</svg>

docs/logo/arise-logo_flattened.svg

@@ -0,0 +1,255 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   width="14.042mm"
+   height="5.3959999mm"
+   viewBox="0 0 14.041999 5.3959999"
+   version="1.1"
+   id="svg5"
+   inkscape:version="1.2.1 (9c6d41e410, 2022-07-14)"
+   sodipodi:docname="arise-logo_flattened.svg"
+   inkscape:export-filename="arise-logo-transparent.png"
+   inkscape:export-xdpi="542.65778"
+   inkscape:export-ydpi="542.65778"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <sodipodi:namedview
+     id="namedview7"
+     pagecolor="#ffffff"
+     bordercolor="#000000"
+     borderopacity="0.25"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     inkscape:document-units="mm"
+     showgrid="false"
+     inkscape:zoom="13.516172"
+     inkscape:cx="39.471234"
+     inkscape:cy="6.1407918"
+     inkscape:window-width="3440"
+     inkscape:window-height="1369"
+     inkscape:window-x="-8"
+     inkscape:window-y="-8"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="g1560" />
+  <defs
+     id="defs2">
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect176" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect440" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect475" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect542" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect544" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect546" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect552" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect558" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect688" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect690" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect692" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect797" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect799" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect801" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect936" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect938" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect940" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect1088" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect1090" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect1092" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect1562" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect1564" />
+    <rect
+       x="29.511229"
+       y="241.55487"
+       width="703.89746"
+       height="247.01991"
+       id="rect1566" />
+  </defs>
+  <g
+     inkscape:groupmode="layer"
+     id="layer2"
+     inkscape:label="BG"
+     style="display:none"
+     transform="translate(-9.2390895,-64.757885)">
+    <rect
+       style="display:inline;fill:#000000;fill-opacity:1;stroke-width:0.0412021"
+       id="rect1828"
+       width="17.772917"
+       height="8.028266"
+       x="7.9025664"
+       y="63.659115"
+       inkscape:label="Background" />
+  </g>
+  <g
+     inkscape:label="ARISE"
+     inkscape:groupmode="layer"
+     id="g1560"
+     style="display:inline;fill:#65f85a;fill-opacity:1;stroke:#112b26;stroke-width:0.2;stroke-dasharray:none;stroke-opacity:1"
+     transform="translate(-6.5038345,-63.220897)">
+    <g
+       aria-label="  e"
+       transform="scale(0.9306992,1.074461)"
+       id="text1550"
+       style="font-size:6.06473px;font-family:'ROBOTECH GP';-inkscape-font-specification:'ROBOTECH GP';letter-spacing:-0.284284px;display:inline"
+       inkscape:label="E">
+      <path
+         d="m 20.745521,62.164173 v 0.642601 H 18.494938 V 62.164173 Z M 20.567843,60.98854 v 0.633717 H 18.494938 V 60.98854 Z m 0.325743,-1.137137 -0.325743,0.645562 h -2.072905 v -0.645562 z"
+         id="path6851" />
+    </g>
+    <g
+       aria-label="$"
+       transform="scale(0.88753215,1.1267197)"
+       id="text1558"
+       style="font-size:5.76972px;font-family:'ROBOTECH GP';-inkscape-font-specification:'ROBOTECH GP';letter-spacing:-0.29811px;display:inline"
+       inkscape:label="S">
+      <path
+         d="m 17.968538,58.172708 h 0.152132 q 0.743753,0.123958 0.749387,0.774742 v 0.07888 q -0.0056,0.774743 -0.743753,0.864895 h -0.157766 v 0.476114 h -0.704311 v -0.476114 h -0.926874 l 0.278907,-0.608525 h 0.647967 V 58.764329 H 17.08674 Q 16.342987,58.64037 16.337353,57.992404 v -0.07888 q 0.0056,-0.743753 0.743753,-0.836722 h 0.183121 v -0.433856 h 0.704311 v 0.433856 h 0.904336 l -0.284541,0.605708 h -0.619795 z m -0.704311,-0.490201 h -0.01972 q -0.208476,0.03099 -0.205659,0.259186 0,0.202842 0.22538,0.231015 z m 0.704311,1.597378 q 0.200025,-0.04226 0.200025,-0.270455 0,-0.191573 -0.200025,-0.239466 z"
+         id="path6854" />
+    </g>
+    <g
+       aria-label="  I"
+       transform="matrix(0.26458333,0,0,0.26458333,2.7456913,0)"
+       id="text1546"
+       style="white-space:pre;shape-inside:url(#rect1566);display:inline;stroke-width:0.755906"
+       inkscape:label="I">
+      <path
+         d="m 42.591737,255.05469 v -12 h -2.268 v 12 z"
+         style="font-weight:bold;font-family:Woodwarrior;-inkscape-font-specification:'Woodwarrior Bold'"
+         id="path6857" />
+    </g>
+    <g
+       aria-label="  R"
+       transform="scale(0.26458333)"
+       id="text1542"
+       style="white-space:pre;shape-inside:url(#rect1564);display:inline;stroke-width:0.755906"
+       inkscape:label="R">
+      <path
+         d="m 44.547737,245.23869 c 1.344,0 2.424,1.092 2.424,2.46 0,0.876 -0.468,1.656 -1.152,2.088 l -2.856,-4.548 z m 2.424,6.384 c 1.296,-0.816 2.148,-2.268 2.148,-3.924 0,-2.568 -2.052,-4.644 -4.572,-4.644 h -4.236 v 1.992 l 3.204,5.112 h -3.204 v 4.896 h 2.148 v -2.712 h 2.412 l 1.716,2.712 h 2.532 z"
+         style="font-weight:bold;font-family:Woodwarrior;-inkscape-font-specification:'Woodwarrior Bold'"
+         id="path6860" />
+    </g>
+    <g
+       aria-label="A"
+       transform="matrix(-0.26458333,0,0,0.26458333,18.107909,0)"
+       id="text1534"
+       style="white-space:pre;shape-inside:url(#rect1562);display:inline;stroke-width:0.755906"
+       inkscape:label="A">
+      <path
+         d="m 33.015719,249.05469 -1.344,1.98 v -3.96 z m 6.684,6 -8.136,-12 h -2.052 v 12 h 2.052 l 2.76,-4.068 2.736,4.068 z"
+         style="font-weight:bold;font-family:Woodwarrior;-inkscape-font-specification:'Woodwarrior Bold'"
+         id="path6863" />
+    </g>
+  </g>
+</svg>