From 723c4765caca5baefa8633665158a545b96131e3 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Thu, 5 Jun 2025 12:27:40 -0400 Subject: [PATCH 01/10] Add comments, increase body width --- docs/stylesheets/extra.css | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css index caf93c7..027f2be 100644 --- a/docs/stylesheets/extra.css +++ b/docs/stylesheets/extra.css @@ -1,3 +1,4 @@ +/*--- Custom admonition: Deprecated ---*/ :root { --md-admonition-icon--deprecated: url('data:image/svg+xml;charset=utf-8,') } @@ -16,6 +17,7 @@ mask-image: var(--md-admonition-icon--deprecated); } +/*--- Custom admonition: Page Moved ---*/ :root { --md-admonition-icon--page-moved: url('data:image/svg+xml;charset=utf-8,') } @@ -34,6 +36,7 @@ mask-image: var(--md-admonition-icon--page-moved); } +/*--- Custom icon colors ---*/ .starcat-blue { color: #00FFFF; } @@ -72,4 +75,9 @@ } .quote-grey { color: #9E9E9E; - } \ No newline at end of file + } + +/*--- Increase maximum width for body text ---*/ +.md-grid { + max-width: 85%; +} \ No newline at end of file From a08531b1e1746554e1f5440a26033ec711739508 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Thu, 5 Jun 2025 12:28:35 -0400 Subject: [PATCH 02/10] Remove changed admonition icons --- mkdocs.yml | 14 -------------- 1 file changed, 14 deletions(-) diff --git a/mkdocs.yml b/mkdocs.yml index 4dcf26e..35f5dfa 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -20,20 +20,6 @@ theme: name: Switch to light mode logo: assets/starcat_head-circle-only-white-transparent_larger.svg favicon: assets/favicon.svg - icon: - admonition: - note: fontawesome/regular/note-sticky - abstract: material/select-multiple - info: octicons/info-16 - tip: octicons/flame-16 - success: octicons/check-16 - question: octicons/question-16 - warning: octicons/alert-16 - failure: octicons/x-circle-16 - danger: octicons/zap-16 - bug: octicons/bug-16 - example: octicons/beaker-16 - quote: fontawesome/solid/quote-left features: - navigation.instant - navigation.instant.progress From 6e9657502d059668891edb2d971079196e61cf98 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Thu, 5 Jun 2025 12:33:28 -0400 Subject: [PATCH 03/10] Hide title on index page --- docs/index.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/index.md b/docs/index.md index 3007a32..f13a923 100644 --- a/docs/index.md +++ b/docs/index.md @@ -109,4 +109,10 @@ You'll find the following sections of information on this site: Found an error, or have a content suggestion? **You** are welcome to suggest changes to this site! The source material for this site is hosted on our [:simple-forgejo: Git server](https://git.starcat.systems/starcatsys/about). Check out the [:octicons-arrow-right-16: Editing this site](editing.md) section in the Handbook for more information on making changes. ## :fontawesome-brands-creative-commons: License -The contents of this site are licensed under [:fontawesome-brands-creative-commons::fontawesome-brands-creative-commons-by::fontawesome-brands-creative-commons-sa: CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/), unless otherwise noted. \ No newline at end of file +The contents of this site are licensed under [:fontawesome-brands-creative-commons::fontawesome-brands-creative-commons-by::fontawesome-brands-creative-commons-sa: CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/), unless otherwise noted. + + \ No newline at end of file From 4f4e80362a2ca604e8a5e4ed7ceb854ea07a050b Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Thu, 5 Jun 2025 12:43:25 -0400 Subject: [PATCH 04/10] Update meta info, add tricks page --- docs/handbook/meta/.nav.yml | 1 + docs/handbook/meta/editing.md | 3 +++ docs/handbook/meta/index.md | 5 +++++ docs/handbook/meta/tricks.md | 14 ++++++++++++++ 4 files changed, 23 insertions(+) create mode 100644 docs/handbook/meta/tricks.md diff --git a/docs/handbook/meta/.nav.yml b/docs/handbook/meta/.nav.yml index d21ca40..91bf99c 100644 --- a/docs/handbook/meta/.nav.yml +++ b/docs/handbook/meta/.nav.yml @@ -3,4 +3,5 @@ nav: - index.md - editing.md - syntax.md + - tricks.md - custom_icons.md \ No newline at end of file diff --git a/docs/handbook/meta/editing.md b/docs/handbook/meta/editing.md index 810a45b..1d3f926 100644 --- a/docs/handbook/meta/editing.md +++ b/docs/handbook/meta/editing.md @@ -5,6 +5,9 @@ This page contains information on editing/making changes to this website. ## Syntax Please see [:octicons-arrow-right-16: Syntax](syntax.md) for reference on various Material for MkDocs syntax you can use in your Markdown, and specific usage on this site. +## Tips + Tricks +[:octicons-arrow-right-16: Tips + Tricks](tricks.md) contains some useful hints for "strange" things you might need to do every once in a while. + --- !!! example "Work in Progress" diff --git a/docs/handbook/meta/index.md b/docs/handbook/meta/index.md index 7441ac7..0da21c8 100644 --- a/docs/handbook/meta/index.md +++ b/docs/handbook/meta/index.md @@ -8,6 +8,11 @@ This site is written in Markdown and is generated using [:simple-materialformkdo ## Editing If you're looking for information about editing this site, please see [:octicons-arrow-right-16: Editing](editing.md). For specific Markdown syntax you can use with Material for MkDocs, please see [:octicons-arrow-right-16: Syntax](syntax.md). +## Setup notes +Some of these pages are notes on custom configurations/setups that we're using for this site: + +[:octicons-arrow-right-16: Custom Icons](custom_icons.md) - instructions for creating and loading custom icons/symbols for use in MkDocs + --- !!! example "Work in Progress" diff --git a/docs/handbook/meta/tricks.md b/docs/handbook/meta/tricks.md new file mode 100644 index 0000000..89f2002 --- /dev/null +++ b/docs/handbook/meta/tricks.md @@ -0,0 +1,14 @@ +# Tips + Tricks +Some handy tips and tricks when working on this site: + +## Custom HTML +### Hide page title +To hide the title on a page (like on the [:octicons-arrow-right-16: Home page](../../support/index.md)), paste this style block somewhere on the page: + +``` html + +``` \ No newline at end of file From 2838b0111ad5a94e15ade5c778339b1412a84bc4 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Thu, 5 Jun 2025 12:54:18 -0400 Subject: [PATCH 05/10] Add code block copy, select, annotate --- mkdocs.yml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/mkdocs.yml b/mkdocs.yml index 35f5dfa..96a0cd7 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -32,6 +32,9 @@ theme: # - navigation.footer - header.autohide - content.tooltips + - content.code.copy + - content.code.select + - content.code.annotate markdown_extensions: - admonition - pymdownx.details From 9c9cc8c73da39ac10950532705f9552323f2bde3 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Thu, 5 Jun 2025 12:54:25 -0400 Subject: [PATCH 06/10] Add line numbers --- docs/handbook/meta/tricks.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/handbook/meta/tricks.md b/docs/handbook/meta/tricks.md index 89f2002..8b23650 100644 --- a/docs/handbook/meta/tricks.md +++ b/docs/handbook/meta/tricks.md @@ -5,7 +5,7 @@ Some handy tips and tricks when working on this site: ### Hide page title To hide the title on a page (like on the [:octicons-arrow-right-16: Home page](../../support/index.md)), paste this style block somewhere on the page: -``` html +``` html linenums="1" +``` + +## Images +### Logo Size +When embedding a site logo in a page (like on the [:octicons-arrow-right-16: Home page](../../support/index.md)), the sweet spot seems to be `300px` for the image width so that it doesn't look "off". + +### Different images for dark/light mode +You can use `#only-dark` to only show an image in dark mode, and `#only-light` to only show an image in light mode. For example: + +``` md linenums="1" +![StarCat Systems Logo-dark](https://cdn.starcat.systems/logos/Starcat_Systems-Head_Circle_Name-212121_Black-300x150px.svg#only-light) +![StarCat Systems Logo-light](https://cdn.starcat.systems/logos/Starcat_Systems-Head_Circle_Name-FFFFFF_White-300x150px.svg#only-dark) ``` \ No newline at end of file From fafb5b02cda6083bedc704d4151b3e0f82f592d4 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Thu, 5 Jun 2025 16:24:22 -0400 Subject: [PATCH 09/10] Reorganize policies landing page --- docs/policies/index.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/docs/policies/index.md b/docs/policies/index.md index c0accd3..da71cde 100644 --- a/docs/policies/index.md +++ b/docs/policies/index.md @@ -6,9 +6,10 @@ This `policies` section contains important legal information regarding our produ Unless otherwise noted, these policies apply to all products and services built and provided by StarCat Systems. If there are any variations to policies for specific products, we'll make a note on that product's policies page(s). ## Our Policies -- [Terms of Service](terms.md) -- [Privacy Policy](privacy.md) -- [Acceptable Use Policy](aup.md) -- [Sub-processors](subprocessors.md) -- [DMCA Policy](dmca.md) -- [Refund Policy](refund.md) \ No newline at end of file +[:octicons-arrow-right-16: Terms of Service](terms.md) +[:octicons-arrow-right-16: Privacy Policy](privacy.md) +[:octicons-arrow-right-16: Acceptable Use Policy](aup.md) +[:octicons-arrow-right-16: Abuse Handling Policy](abuse.md) +[:octicons-arrow-right-16: DMCA Policy](dmca.md) +[:octicons-arrow-right-16: Subprocessors](subprocessors.md) +[:octicons-arrow-right-16: Refund Policy](refund.md) \ No newline at end of file From 42a35ba85509b1e8392f32506651f33a4fef8bb8 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Thu, 5 Jun 2025 16:24:33 -0400 Subject: [PATCH 10/10] Fill out Subprocessors page --- docs/policies/subprocessors.md | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/docs/policies/subprocessors.md b/docs/policies/subprocessors.md index 3fbb881..8648da9 100644 --- a/docs/policies/subprocessors.md +++ b/docs/policies/subprocessors.md @@ -1,3 +1,15 @@ -# Sub-processors -StarCat Systems uses the following sub-processors to assist in providing our services. +# Subprocessors +*Last updated 2025-06-05* + +StarCat Systems uses the following subprocessors to assist in providing our services. + +| Subprocessor | Activity | Service Location | +| ------------ | -------- | -------- | +| [Backblaze](https://backblaze.com) | File storage | USA, EU | +| [bunny.net](https://bunny.net) | Content delivery network | USA, EU | +| [Hetzner](https://hetzner.com) | Hosting services, file storage | Germany, Finland | +| [MXroute](https://mxroute.com) | Email hosting | USA, EU | +| [NearlyFreeSpeech.Net](https://nearlyfreespeech.net) | Hosting services | USA | +| [Peakford](https://peakford.com) | Hosting services | EU, USA | +| [Polar](https://polar.sh) | Payment processing | USA | \ No newline at end of file