From 44532072fb3d99fd1902c7073518e014e6962c12 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:37:20 -0400 Subject: [PATCH 01/10] Remove attribution for starcat-dev org icon --- docs/about/attribution.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/about/attribution.md b/docs/about/attribution.md index a9e5a9c..cdde5f6 100644 --- a/docs/about/attribution.md +++ b/docs/about/attribution.md @@ -6,7 +6,6 @@ This site, and all StarCat Systems projects, products, and services make use of - [`about` site](https://about.starcat.systems) favicon - adapted from [Book](https://thenounproject.com/icon/book-6252926/) by [iconpro86](https://thenounproject.com/creator/iconpro86/) from Noun Project. - [`about-docs` repo](https://git.starcat.systems/starcatsys/about) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. - [`starcat-infra` org](https://git.starcat.systems/starcat-infra) icon - adapted from [Engineering](https://thenounproject.com/icon/engineering-7486606/) by [sunardi](https://thenounproject.com/creator/matah3574/) from Noun Project. -- [`starcat-dev` org](https://git.starcat.systems/starcat-dev) icon - adapted from [lab](https://thenounproject.com/icon/lab-4581077/) by [cr9183353](https://thenounproject.com/creator/cr9183353/) from Noun Project. - [Git server](https://git.starcat.systems/) icon - adapted from [Arcticons Thin Line Icons Collection](https://www.svgrepo.com/collection/arcticons-thin-line-icons/) by [Donnnno](https://www.svgrepo.com/author/Donnnno/) and from the StarCat Systems logo, above. - [SourceCamp](https://source.camp) logo - adapted from [camp](https://thenounproject.com/icon/camp-7375488/) by [Ricons](https://thenounproject.com/creator/ricons/) from Noun Project. - Icons used on this `about` site are by [Material Design](https://pictogrammers.com/library/mdi/), [FontAwesome](https://fontawesome.com/search?m=free), [Octicons](https://octicons.github.com/), and [Simple Icons](https://simpleicons.org/). \ No newline at end of file From 33f07a696a83a9e95b3c230bb507d941996dc5a4 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:38:30 -0400 Subject: [PATCH 02/10] Remove attribution for git server icon --- docs/about/attribution.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/about/attribution.md b/docs/about/attribution.md index cdde5f6..e9c03d3 100644 --- a/docs/about/attribution.md +++ b/docs/about/attribution.md @@ -6,6 +6,5 @@ This site, and all StarCat Systems projects, products, and services make use of - [`about` site](https://about.starcat.systems) favicon - adapted from [Book](https://thenounproject.com/icon/book-6252926/) by [iconpro86](https://thenounproject.com/creator/iconpro86/) from Noun Project. - [`about-docs` repo](https://git.starcat.systems/starcatsys/about) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. - [`starcat-infra` org](https://git.starcat.systems/starcat-infra) icon - adapted from [Engineering](https://thenounproject.com/icon/engineering-7486606/) by [sunardi](https://thenounproject.com/creator/matah3574/) from Noun Project. -- [Git server](https://git.starcat.systems/) icon - adapted from [Arcticons Thin Line Icons Collection](https://www.svgrepo.com/collection/arcticons-thin-line-icons/) by [Donnnno](https://www.svgrepo.com/author/Donnnno/) and from the StarCat Systems logo, above. - [SourceCamp](https://source.camp) logo - adapted from [camp](https://thenounproject.com/icon/camp-7375488/) by [Ricons](https://thenounproject.com/creator/ricons/) from Noun Project. - Icons used on this `about` site are by [Material Design](https://pictogrammers.com/library/mdi/), [FontAwesome](https://fontawesome.com/search?m=free), [Octicons](https://octicons.github.com/), and [Simple Icons](https://simpleicons.org/). \ No newline at end of file From 87f4612e24eefd8dbd0f8f0e4d665f5356c58e48 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:46:28 -0400 Subject: [PATCH 03/10] Add StageLink logo attribution --- docs/about/attribution.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/about/attribution.md b/docs/about/attribution.md index e9c03d3..582e3ef 100644 --- a/docs/about/attribution.md +++ b/docs/about/attribution.md @@ -7,4 +7,5 @@ This site, and all StarCat Systems projects, products, and services make use of - [`about-docs` repo](https://git.starcat.systems/starcatsys/about) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. - [`starcat-infra` org](https://git.starcat.systems/starcat-infra) icon - adapted from [Engineering](https://thenounproject.com/icon/engineering-7486606/) by [sunardi](https://thenounproject.com/creator/matah3574/) from Noun Project. - [SourceCamp](https://source.camp) logo - adapted from [camp](https://thenounproject.com/icon/camp-7375488/) by [Ricons](https://thenounproject.com/creator/ricons/) from Noun Project. +- [StageLink](https://stagelink.cloud) logo - adapted from [slider](https://thenounproject.com/icon/slider-2309209/) by [DinosoftLabs](https://thenounproject.com/creator/dinosoftlab/) from Noun Project. - Icons used on this `about` site are by [Material Design](https://pictogrammers.com/library/mdi/), [FontAwesome](https://fontawesome.com/search?m=free), [Octicons](https://octicons.github.com/), and [Simple Icons](https://simpleicons.org/). \ No newline at end of file From 41d8aba8ea58cfea43d55e544468421896518198 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:48:58 -0400 Subject: [PATCH 04/10] Update 'about' repo name in attribution --- docs/about/attribution.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/about/attribution.md b/docs/about/attribution.md index 582e3ef..8682034 100644 --- a/docs/about/attribution.md +++ b/docs/about/attribution.md @@ -4,7 +4,7 @@ This site, and all StarCat Systems projects, products, and services make use of ## Icons - [StarCat Systems](https://starcat.systems) logo - adapted from [Cat](https://thenounproject.com/icon/cat-6441095/) by [Md Ahasan Habib](https://thenounproject.com/creator/md_ahasan/) from Noun Project. - [`about` site](https://about.starcat.systems) favicon - adapted from [Book](https://thenounproject.com/icon/book-6252926/) by [iconpro86](https://thenounproject.com/creator/iconpro86/) from Noun Project. -- [`about-docs` repo](https://git.starcat.systems/starcatsys/about) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. +- [`about` repo](https://git.starcat.systems/starcatsys/about) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. - [`starcat-infra` org](https://git.starcat.systems/starcat-infra) icon - adapted from [Engineering](https://thenounproject.com/icon/engineering-7486606/) by [sunardi](https://thenounproject.com/creator/matah3574/) from Noun Project. - [SourceCamp](https://source.camp) logo - adapted from [camp](https://thenounproject.com/icon/camp-7375488/) by [Ricons](https://thenounproject.com/creator/ricons/) from Noun Project. - [StageLink](https://stagelink.cloud) logo - adapted from [slider](https://thenounproject.com/icon/slider-2309209/) by [DinosoftLabs](https://thenounproject.com/creator/dinosoftlab/) from Noun Project. From eda93c36e01aa6334f2ba76d39a76503a3430d33 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:51:25 -0400 Subject: [PATCH 05/10] Add DocsHub logo attribution --- docs/about/attribution.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/about/attribution.md b/docs/about/attribution.md index 8682034..4a42467 100644 --- a/docs/about/attribution.md +++ b/docs/about/attribution.md @@ -7,5 +7,6 @@ This site, and all StarCat Systems projects, products, and services make use of - [`about` repo](https://git.starcat.systems/starcatsys/about) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. - [`starcat-infra` org](https://git.starcat.systems/starcat-infra) icon - adapted from [Engineering](https://thenounproject.com/icon/engineering-7486606/) by [sunardi](https://thenounproject.com/creator/matah3574/) from Noun Project. - [SourceCamp](https://source.camp) logo - adapted from [camp](https://thenounproject.com/icon/camp-7375488/) by [Ricons](https://thenounproject.com/creator/ricons/) from Noun Project. +- [DocsHub](https://docshub.io) logo - adapted from [Document](https://thenounproject.com/icon/document-6244658/) by [Reion](https://thenounproject.com/creator/dickydante/) from Noun Project. - [StageLink](https://stagelink.cloud) logo - adapted from [slider](https://thenounproject.com/icon/slider-2309209/) by [DinosoftLabs](https://thenounproject.com/creator/dinosoftlab/) from Noun Project. - Icons used on this `about` site are by [Material Design](https://pictogrammers.com/library/mdi/), [FontAwesome](https://fontawesome.com/search?m=free), [Octicons](https://octicons.github.com/), and [Simple Icons](https://simpleicons.org/). \ No newline at end of file From ca54fd4f3c83df9bc5d082f0f134f67fba864fa6 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:51:59 -0400 Subject: [PATCH 06/10] Update attribution icon order --- docs/about/attribution.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/about/attribution.md b/docs/about/attribution.md index 4a42467..3365e47 100644 --- a/docs/about/attribution.md +++ b/docs/about/attribution.md @@ -6,7 +6,7 @@ This site, and all StarCat Systems projects, products, and services make use of - [`about` site](https://about.starcat.systems) favicon - adapted from [Book](https://thenounproject.com/icon/book-6252926/) by [iconpro86](https://thenounproject.com/creator/iconpro86/) from Noun Project. - [`about` repo](https://git.starcat.systems/starcatsys/about) icon - adapted from [Book](https://thenounproject.com/icon/book-1833960/) by [Untashable](https://thenounproject.com/creator/untashable/) from Noun Project. - [`starcat-infra` org](https://git.starcat.systems/starcat-infra) icon - adapted from [Engineering](https://thenounproject.com/icon/engineering-7486606/) by [sunardi](https://thenounproject.com/creator/matah3574/) from Noun Project. +- Icons used on this `about` site are by [Material Design](https://pictogrammers.com/library/mdi/), [FontAwesome](https://fontawesome.com/search?m=free), [Octicons](https://octicons.github.com/), and [Simple Icons](https://simpleicons.org/). - [SourceCamp](https://source.camp) logo - adapted from [camp](https://thenounproject.com/icon/camp-7375488/) by [Ricons](https://thenounproject.com/creator/ricons/) from Noun Project. - [DocsHub](https://docshub.io) logo - adapted from [Document](https://thenounproject.com/icon/document-6244658/) by [Reion](https://thenounproject.com/creator/dickydante/) from Noun Project. -- [StageLink](https://stagelink.cloud) logo - adapted from [slider](https://thenounproject.com/icon/slider-2309209/) by [DinosoftLabs](https://thenounproject.com/creator/dinosoftlab/) from Noun Project. -- Icons used on this `about` site are by [Material Design](https://pictogrammers.com/library/mdi/), [FontAwesome](https://fontawesome.com/search?m=free), [Octicons](https://octicons.github.com/), and [Simple Icons](https://simpleicons.org/). \ No newline at end of file +- [StageLink](https://stagelink.cloud) logo - adapted from [slider](https://thenounproject.com/icon/slider-2309209/) by [DinosoftLabs](https://thenounproject.com/creator/dinosoftlab/) from Noun Project. \ No newline at end of file From f0299921ff8c1b428bd9797949af382e7a2a79a3 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 21:56:17 -0400 Subject: [PATCH 07/10] Make separate syntax page --- docs/handbook/meta/.nav.yml | 3 +- docs/handbook/meta/editing.md | 117 ------------------------------- docs/handbook/meta/syntax.md | 127 ++++++++++++++++++++++++++++++++++ 3 files changed, 129 insertions(+), 118 deletions(-) create mode 100644 docs/handbook/meta/syntax.md diff --git a/docs/handbook/meta/.nav.yml b/docs/handbook/meta/.nav.yml index 3fbd06f..9d27d6d 100644 --- a/docs/handbook/meta/.nav.yml +++ b/docs/handbook/meta/.nav.yml @@ -1,4 +1,5 @@ title: Meta nav: - index.md - - editing.md \ No newline at end of file + - editing.md + - syntax.md \ No newline at end of file diff --git a/docs/handbook/meta/editing.md b/docs/handbook/meta/editing.md index 84a7f99..7009b8a 100644 --- a/docs/handbook/meta/editing.md +++ b/docs/handbook/meta/editing.md @@ -5,124 +5,7 @@ This page contains information on editing/making changes to this website. ## Material for MkDocs This site is written in Markdown and is generated using [:simple-materialformkdocs: Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) Insiders. The source Markdown is stored in the [:simple-forgejo: about Git repo](https://git.starcat.systems/starcatsys/about). -## Icons -Reference for all available Material for MkDocs icons: [:simple-materialformkdocs: Icons, Emojis](https://squidfunk.github.io/mkdocs-material/reference/icons-emojis/) -### Commonly-used icons for links -:octicons-arrow-right-16: `:octicons-arrow-right-16:` - used for links within the wiki -:octicons-tab-external-16: `:octicons-tab-external-16:` - used for links outside the wiki, but within StarCat Systems -:octicons-link-external-16: `:octicons-link-external-16:` - used for external links to sites not controlled by StarCat Systems -:material-book-lock: `:material-book-lock:` - used for links to the StarCat Systems internal handbook - -### Coloring icons -You can add a color to an icon by adding the CSS color after the icon, like this: -:fontawesome-solid-dragon:{ .bug-pink } `:fontawesome-solid-dragon:{ .bug-pink }` - - -Currently, the available configured colors are based off the built-in admonition colors and icons, as follows: - -:fontawesome-regular-note-sticky:{ .note-blue } `:fontawesome-regular-note-sticky:{ .note-blue }` -:octicons-info-16:{ .info-blue } `:octicons-info-16:{ .info-blue }` -:octicons-flame-16:{ .tip-teal } `:octicons-flame-16:{ .tip-teal }` -:octicons-check-16:{ .success-green } `:octicons-check-16:{ .success-green }` -:octicons-question-16:{ .question-green } `:octicons-question-16:{ .question-green }` -:octicons-alert-16:{ .warning-yellow } `:octicons-alert-16:{ .warning-yellow }` -:octicons-x-circle-16:{ .failure-red } `:octicons-x-circle-16:{ .failure-red }` -:octicons-zap-16:{ .danger-red } `:octicons-zap-16:{ .danger-red }` -:octicons-bug-16:{ .bug-pink } `:octicons-bug-16:{ .bug-pink }` -:octicons-beaker-16:{ .example-purple } `:octicons-beaker-16:{ .example-purple }` -:octicons-quote-16:{ .quote-grey } `:octicons-quote-16:{ .quote-grey }` - -:octicons-flame-16:{ .tip-teal } Want to know how these colors work? Check out [:simple-forgejo: the CSS in the source](https://git.starcat.systems/starcatsys/about/src/branch/main/docs/stylesheets/extra.css). - -## Admonitions -Reference for using Admonitions: [:simple-materialformkdocs: Admonitions](https://squidfunk.github.io/mkdocs-material/reference/admonitions/#usage) - - - -### Common Admonition Usage -Here are some common admonitions, when you might use them, and quick code snippets that you can paste in. - -!!! note - Highlights information that users should take into account, even when skimming. - - - ``` - !!! note - Highlights information that users should take into account, even when skimming. - ``` - -!!! tip - Helpful advice for doing things better or more easily. - - ``` - !!! tip - Helpful advice for doing things better or more easily. - ``` - -!!! warning - Advises about risks or negative outcomes of certain actions. - - ``` - !!! warning - Advises about risks or negative outcomes of certain actions. - ``` - -!!! danger - Urgent info that needs immediate user attention to avoid problems. - - ``` - !!! danger - Urgent info that needs immediate user attention to avoid problems. - ``` - -!!! bug - Information about a known bug in a current version. Whenever possible, provide a link to the issue report. Place a link back to the page with this admonition, in the issue report so that the admonition can be removed when the bug is closed. - - ``` - !!! bug - Information about a known bug in a current version. Whenever possible, provide a link to the issue report. Place a link back to the page with this admonition, in the issue report so that the admonition can be removed when the bug is closed. - ``` - -### Custom -We've modified a couple of the standard admonitions to mean something a little different on this site. - -#### Work in Progress -For pages that aren't yet complete, and need revisions (that we know are going to be revised sooner/more frequently than a typical page.) - -Typically, we will put this at the bottom of the page content, with a dividing line between any page content and this admonition. - -Example page with this Work in Progress admonition: [:octicons-arrow-right-16: Example WIP Admonition](example_pages/example_wip_admonition.md) - -??? quote "Syntax" - Copy and paste at the bottom of page content: - ``` - --- - - !!! example "Work in Progress" - This page is not complete, and is subject to change. - - Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. - ``` - - -#### Placeholder Page -For pages that are newly created and have no (or very little) content on the page itself. Also used for `index.md` pages in directories that have other contents, but no content on the directory index. - -Example page with the Placeholder Page admonition: [:octicons-arrow-right-16: Example Placeholder Page Admonition](example_pages/example_placeholder_page_admonition.md) - -??? quote "Syntax" - Copy and paste at the bottom of page content: - ``` - !!! abstract "Placeholder Page" - This is a placeholder page. Please see the site navigation for any sub-pages that exist. - ``` - -!!! tip - Typically, any page that is marked as a Placeholder Page should also be marked with the **Work in Progress** admonition because they are, by their nature, incomplete. - - Example page with the Placeholder and WIP admonitions: [:octicons-arrow-right-16: Example Placeholder and WIP Admonitions](example_pages/example_wip_placeholder_admonitions.md) - Source code that you can quickly copy from when making an index or placeholder page is located [:simple-forgejo: here](https://git.starcat.systems/starcatsys/about/src/branch/main/docs/handbook/meta/example_pages/example_wip_placeholder_admonitions.md). --- diff --git a/docs/handbook/meta/syntax.md b/docs/handbook/meta/syntax.md new file mode 100644 index 0000000..09d3b47 --- /dev/null +++ b/docs/handbook/meta/syntax.md @@ -0,0 +1,127 @@ +# Syntax + +## Icons +Reference for all available Material for MkDocs icons: [:simple-materialformkdocs: Icons, Emojis](https://squidfunk.github.io/mkdocs-material/reference/icons-emojis/) + +### Commonly-used icons for links +:octicons-arrow-right-16: `:octicons-arrow-right-16:` - used for links within the wiki +:octicons-tab-external-16: `:octicons-tab-external-16:` - used for links outside the wiki, but within StarCat Systems +:octicons-link-external-16: `:octicons-link-external-16:` - used for external links to sites not controlled by StarCat Systems +:material-book-lock: `:material-book-lock:` - used for links to the StarCat Systems internal handbook + +### Coloring icons +You can add a color to an icon by adding the CSS color after the icon, like this: +:fontawesome-solid-dragon:{ .bug-pink } `:fontawesome-solid-dragon:{ .bug-pink }` + + +Currently, the available configured colors are based off the built-in admonition colors and icons, as follows: + +:fontawesome-regular-note-sticky:{ .note-blue } `:fontawesome-regular-note-sticky:{ .note-blue }` +:octicons-info-16:{ .info-blue } `:octicons-info-16:{ .info-blue }` +:octicons-flame-16:{ .tip-teal } `:octicons-flame-16:{ .tip-teal }` +:octicons-check-16:{ .success-green } `:octicons-check-16:{ .success-green }` +:octicons-question-16:{ .question-green } `:octicons-question-16:{ .question-green }` +:octicons-alert-16:{ .warning-yellow } `:octicons-alert-16:{ .warning-yellow }` +:octicons-x-circle-16:{ .failure-red } `:octicons-x-circle-16:{ .failure-red }` +:octicons-zap-16:{ .danger-red } `:octicons-zap-16:{ .danger-red }` +:octicons-bug-16:{ .bug-pink } `:octicons-bug-16:{ .bug-pink }` +:octicons-beaker-16:{ .example-purple } `:octicons-beaker-16:{ .example-purple }` +:octicons-quote-16:{ .quote-grey } `:octicons-quote-16:{ .quote-grey }` + +:octicons-flame-16:{ .tip-teal } Want to know how these colors work? Check out [:simple-forgejo: the CSS in the source](https://git.starcat.systems/starcatsys/about/src/branch/main/docs/stylesheets/extra.css). + +## Admonitions +Reference for using Admonitions: [:simple-materialformkdocs: Admonitions](https://squidfunk.github.io/mkdocs-material/reference/admonitions/#usage) + + + +### Common Admonition Usage +Here are some common admonitions, when you might use them, and quick code snippets that you can paste in. + +!!! note + Highlights information that users should take into account, even when skimming. + + + ``` + !!! note + Highlights information that users should take into account, even when skimming. + ``` + +!!! tip + Helpful advice for doing things better or more easily. + + ``` + !!! tip + Helpful advice for doing things better or more easily. + ``` + +!!! warning + Advises about risks or negative outcomes of certain actions. + + ``` + !!! warning + Advises about risks or negative outcomes of certain actions. + ``` + +!!! danger + Urgent info that needs immediate user attention to avoid problems. + + ``` + !!! danger + Urgent info that needs immediate user attention to avoid problems. + ``` + +!!! bug + Information about a known bug in a current version. Whenever possible, provide a link to the issue report. Place a link back to the page with this admonition, in the issue report so that the admonition can be removed when the bug is closed. + + ``` + !!! bug + Information about a known bug in a current version. Whenever possible, provide a link to the issue report. Place a link back to the page with this admonition, in the issue report so that the admonition can be removed when the bug is closed. + ``` + +### Custom +We've modified a couple of the standard admonitions to mean something a little different on this site. + +#### Work in Progress +For pages that aren't yet complete, and need revisions (that we know are going to be revised sooner/more frequently than a typical page.) + +Typically, we will put this at the bottom of the page content, with a dividing line between any page content and this admonition. + +Example page with this Work in Progress admonition: [:octicons-arrow-right-16: Example WIP Admonition](example_pages/example_wip_admonition.md) + +??? quote "Syntax" + Copy and paste at the bottom of page content: + ``` + --- + + !!! example "Work in Progress" + This page is not complete, and is subject to change. + + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. + ``` + + +#### Placeholder Page +For pages that are newly created and have no (or very little) content on the page itself. Also used for `index.md` pages in directories that have other contents, but no content on the directory index. + +Example page with the Placeholder Page admonition: [:octicons-arrow-right-16: Example Placeholder Page Admonition](example_pages/example_placeholder_page_admonition.md) + +??? quote "Syntax" + Copy and paste at the bottom of page content: + ``` + !!! abstract "Placeholder Page" + This is a placeholder page. Please see the site navigation for any sub-pages that exist. + ``` + +!!! tip + Typically, any page that is marked as a Placeholder Page should also be marked with the **Work in Progress** admonition because they are, by their nature, incomplete. + + Example page with the Placeholder and WIP admonitions: [:octicons-arrow-right-16: Example Placeholder and WIP Admonitions](example_pages/example_wip_placeholder_admonitions.md) + Source code that you can quickly copy from when making an index or placeholder page is located [:simple-forgejo: here](https://git.starcat.systems/starcatsys/about/src/branch/main/docs/handbook/meta/example_pages/example_wip_placeholder_admonitions.md). + +--- + +!!! example "Work in Progress" + This page is not complete, and is subject to change. + + Want to help with this page? Please see [:octicons-arrow-right-16: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about) for this site. \ No newline at end of file From 1ac79049b187ec0d5fb56e06f5a7f13546e7d7e7 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 22:03:20 -0400 Subject: [PATCH 08/10] Add syntax reference to editing and syntax docs - Introduced a new section on syntax in editing.md - Added a detailed syntax reference in syntax.md --- docs/handbook/meta/editing.md | 3 ++- docs/handbook/meta/syntax.md | 2 ++ 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/handbook/meta/editing.md b/docs/handbook/meta/editing.md index 7009b8a..2394f73 100644 --- a/docs/handbook/meta/editing.md +++ b/docs/handbook/meta/editing.md @@ -5,7 +5,8 @@ This page contains information on editing/making changes to this website. ## Material for MkDocs This site is written in Markdown and is generated using [:simple-materialformkdocs: Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) Insiders. The source Markdown is stored in the [:simple-forgejo: about Git repo](https://git.starcat.systems/starcatsys/about). - +## 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. --- diff --git a/docs/handbook/meta/syntax.md b/docs/handbook/meta/syntax.md index 09d3b47..794f544 100644 --- a/docs/handbook/meta/syntax.md +++ b/docs/handbook/meta/syntax.md @@ -1,5 +1,7 @@ # Syntax +You can find a reference for the syntax used in writing this site in the Material for MkDocs [:simple-materialformkdocs: Reference section](https://squidfunk.github.io/mkdocs-material/reference/). On this particular site, there are some specific syntax point that we use. This page is intended to provide a reference for those specifics. + ## Icons Reference for all available Material for MkDocs icons: [:simple-materialformkdocs: Icons, Emojis](https://squidfunk.github.io/mkdocs-material/reference/icons-emojis/) From 42b143ec87d5a0827fa01f0c0940e73e721095d9 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 22:07:08 -0400 Subject: [PATCH 09/10] Update handbook meta structure and content --- docs/handbook/meta/editing.md | 3 --- docs/handbook/meta/index.md | 9 +++++++-- 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/docs/handbook/meta/editing.md b/docs/handbook/meta/editing.md index 2394f73..810a45b 100644 --- a/docs/handbook/meta/editing.md +++ b/docs/handbook/meta/editing.md @@ -2,9 +2,6 @@ This page contains information on editing/making changes to this website. -## Material for MkDocs -This site is written in Markdown and is generated using [:simple-materialformkdocs: Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) Insiders. The source Markdown is stored in the [:simple-forgejo: about Git repo](https://git.starcat.systems/starcatsys/about). - ## 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. diff --git a/docs/handbook/meta/index.md b/docs/handbook/meta/index.md index 408ffb5..7441ac7 100644 --- a/docs/handbook/meta/index.md +++ b/docs/handbook/meta/index.md @@ -1,7 +1,12 @@ # Handbook Meta -!!! abstract "Placeholder Page" - This is a placeholder page. Please see the site navigation for any sub-pages that exist. +This Meta section is for information about this `about.starcat.systems` site itself. + +## Material for MkDocs +This site is written in Markdown and is generated using [:simple-materialformkdocs: Material for MkDocs](https://squidfunk.github.io/mkdocs-material/) Insiders. The source Markdown is stored in the [:simple-forgejo: about Git repo](https://git.starcat.systems/starcatsys/about). + +## 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). --- From a67f992d921f1f7ac2012a9f00a66fbf195de53f Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Tue, 29 Apr 2025 22:19:52 -0400 Subject: [PATCH 10/10] Remove Forgejo last commit badge from README.md --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index 60a3ba3..316bb37 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,6 @@ This repo contains the source Markdown and MkDocs files that generate [about.starcat.systems](https://about.starcat.systems) using [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/). -[![Gitea Last Commit](https://img.shields.io/gitea/last-commit/starcatsys/about?display_timestamp=committer&gitea_url=https%3A%2F%2Fgit.starcat.systems&style=flat&logo=git&logoColor=fff&logoSize=auto)](https://git.starcat.systems/starcatsys/about_docs/) ## Contributing