From 85c9c4a87c120f9957bd38ab58d9485df1ceda31 Mon Sep 17 00:00:00 2001 From: flibber-hk <76987839+flibber-hk@users.noreply.github.com> Date: Tue, 31 Mar 2026 20:12:13 +0100 Subject: [PATCH 1/4] Setup without examples.md populated --- .github/dependabot.yml | 4 +++ .github/workflows/docs.yml | 50 +++++++++++++++++++++++++++++++ .gitmodules | 3 ++ docs/.gitignore | 8 +++++ docs/articles/examples.md | 0 docs/articles/toc.yml | 3 ++ docs/docfx.json | 47 +++++++++++++++++++++++++++++ docs/index.md | 28 +++++++++++++++++ docs/silksong-modding-style-docfx | 1 + docs/toc.yml | 5 ++++ 10 files changed, 149 insertions(+) create mode 100644 .github/workflows/docs.yml create mode 100644 .gitmodules create mode 100644 docs/.gitignore create mode 100644 docs/articles/examples.md create mode 100644 docs/articles/toc.yml create mode 100644 docs/docfx.json create mode 100644 docs/index.md create mode 160000 docs/silksong-modding-style-docfx create mode 100644 docs/toc.yml diff --git a/.github/dependabot.yml b/.github/dependabot.yml index 953194c..3feca49 100644 --- a/.github/dependabot.yml +++ b/.github/dependabot.yml @@ -12,3 +12,7 @@ updates: package-ecosystem: github-actions schedule: interval: daily + - directory: / + package-ecosystem: gitsubmodule + schedule: + interval: daily diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml new file mode 100644 index 0000000..1a83c73 --- /dev/null +++ b/.github/workflows/docs.yml @@ -0,0 +1,50 @@ +name: Docs + +on: + push: + branches: [main] + +permissions: + actions: read + pages: write + id-token: write + +concurrency: + group: pages + cancel-in-progress: false + +jobs: + generate-docs: + runs-on: ubuntu-latest + + environment: + name: github-pages + url: ${{ steps.deployment.output.page_url }} + + steps: + - name: Checkout + uses: actions/checkout@v6 + with: + submodules: true + + - name: Setup .NET + uses: actions/setup-dotnet@v5 + with: + dotnet-version: 10.x + + - name: Build + run: dotnet build -c Release + + - name: DocFX build + working-directory: docs + run: dnx docfx --yes + continue-on-error: false + + - name: Upload assets + uses: actions/upload-pages-artifact@v4 + with: + path: docs/_site + + - name: Deploy + id: deployment + uses: actions/deploy-pages@v4 diff --git a/.gitmodules b/.gitmodules new file mode 100644 index 0000000..34f4de1 --- /dev/null +++ b/.gitmodules @@ -0,0 +1,3 @@ +[submodule "docs/silksong-modding-style-docfx"] + path = docs/silksong-modding-style-docfx + url = https://github.com/silksong-modding/silksong-modding-style-docfx diff --git a/docs/.gitignore b/docs/.gitignore new file mode 100644 index 0000000..ff96cc0 --- /dev/null +++ b/docs/.gitignore @@ -0,0 +1,8 @@ +/**/DROP/ +/**/TEMP/ +/**/packages/ +/**/bin/ +/**/obj/ +_site +/api/*.yml +/api/.manifest diff --git a/docs/articles/examples.md b/docs/articles/examples.md new file mode 100644 index 0000000..e69de29 diff --git a/docs/articles/toc.yml b/docs/articles/toc.yml new file mode 100644 index 0000000..eb9d937 --- /dev/null +++ b/docs/articles/toc.yml @@ -0,0 +1,3 @@ +- name: Getting Started +- href: ../index.md +- href: examples.md diff --git a/docs/docfx.json b/docs/docfx.json new file mode 100644 index 0000000..4f6f23e --- /dev/null +++ b/docs/docfx.json @@ -0,0 +1,47 @@ +{ + "$schema": "https://raw.githubusercontent.com/dotnet/docfx/main/schemas/docfx.schema.json", + "metadata": [ + { + "src": [ + { + "src": "../Silksong.ModMenu", + "files": [ + "**/*.csproj" + ] + } + ], + "dest": "api" + } + ], + "build": { + "content": [ + { + "files": [ + "**/*.{md,yml}" + ], + "exclude": [ + "_site/**" + ] + } + ], + "resource": [ + { + "files": [ + "images/**" + ] + } + ], + "output": "_site", + "template": [ + "default", + "modern", + "silksong-modding-style-docfx" + ], + "globalMetadata": { + "_appName": "ModMenu", + "_appTitle": "ModMenu", + "_enableSearch": true, + "pdf": false + } + } +} \ No newline at end of file diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000..92e91e4 --- /dev/null +++ b/docs/index.md @@ -0,0 +1,28 @@ +# ModMenu + +[![NuGet Version](https://img.shields.io/nuget/v/Silksong.ModMenu)](https://www.nuget.org/packages/Silksong.ModMenu) + +ModMenu adds a "Mods" menu to the options menu screen, and provides an API for mods to customize +their menu. + +## Usage + +Add the following line to your .csproj: +``` + +``` +The most up to date version number can be retrieved from [Nuget](https://www.nuget.org/packages/Silksong.ModMenu). + +You will also need to add a dependency to your thunderstore.toml: +``` +silksong_modding-ModMenu = "0.4.5" +``` +The version number does not matter hugely, but the most up to date number can be retrieved from +[Thunderstore](https://thunderstore.io/c/hollow-knight-silksong/p/silksong_modding/ModMenu/). +If manually uploading, instead copy the dependency string from the Thunderstore link. + +ModMenu should be added as a BepInEx dependency by putting the following attribute +onto your plugin class, below the BepInAutoPlugin attribute. +``` +[BepInDependency(Silksong.ModMenu.ModMenuPlugin.Id)] +``` diff --git a/docs/silksong-modding-style-docfx b/docs/silksong-modding-style-docfx new file mode 160000 index 0000000..168e249 --- /dev/null +++ b/docs/silksong-modding-style-docfx @@ -0,0 +1 @@ +Subproject commit 168e249d0a23cc92e26e0d9b231cd21ff121d4f8 diff --git a/docs/toc.yml b/docs/toc.yml new file mode 100644 index 0000000..938e6f6 --- /dev/null +++ b/docs/toc.yml @@ -0,0 +1,5 @@ +- name: Articles + href: articles/ +- name: API Documentation + href: api/ + \ No newline at end of file From 65823138631ff33f3a6c8641bf34c3d2c5e13e5f Mon Sep 17 00:00:00 2001 From: flibber-hk <76987839+flibber-hk@users.noreply.github.com> Date: Tue, 31 Mar 2026 20:20:35 +0100 Subject: [PATCH 2/4] Remove examples article I don't want to create this until v1.0 is released, and I don't want to upgrade to v1.0 right now --- docs/articles/examples.md | 0 docs/articles/toc.yml | 1 - docs/docfx.json | 3 ++- docs/filterconfig.yml | 4 ++++ 4 files changed, 6 insertions(+), 2 deletions(-) delete mode 100644 docs/articles/examples.md create mode 100644 docs/filterconfig.yml diff --git a/docs/articles/examples.md b/docs/articles/examples.md deleted file mode 100644 index e69de29..0000000 diff --git a/docs/articles/toc.yml b/docs/articles/toc.yml index eb9d937..a8baf40 100644 --- a/docs/articles/toc.yml +++ b/docs/articles/toc.yml @@ -1,3 +1,2 @@ - name: Getting Started - href: ../index.md -- href: examples.md diff --git a/docs/docfx.json b/docs/docfx.json index 4f6f23e..1a9ac79 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -10,7 +10,8 @@ ] } ], - "dest": "api" + "dest": "api", + "filter": filterconfig.yml" } ], "build": { diff --git a/docs/filterconfig.yml b/docs/filterconfig.yml new file mode 100644 index 0000000..78af075 --- /dev/null +++ b/docs/filterconfig.yml @@ -0,0 +1,4 @@ +### YamlMime:ManagedReference +apiRules: + - exclude: + uidRegex: 'Silksong\.ModMenu\.ModMenuPlugin' From ece63b3e80a08599cff3de5f313bf736b7ed18b1 Mon Sep 17 00:00:00 2001 From: flibber-hk <76987839+flibber-hk@users.noreply.github.com> Date: Tue, 31 Mar 2026 20:23:21 +0100 Subject: [PATCH 3/4] Minor changes --- README.md | 7 +++++++ docs/index.md | 5 +++-- 2 files changed, 10 insertions(+), 2 deletions(-) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..8976848 --- /dev/null +++ b/README.md @@ -0,0 +1,7 @@ +# Silksong.ModMenu + +The standard menu-modification mod for Silksong. It provides a small but powerful set of features for mods to use. + +This mod also adds a 'Mod Options' menu to the main Options menu by default. + +For documentation and examples, see the [documentation](https://docs.silksong-modding.org/Silksong.DataManager). diff --git a/docs/index.md b/docs/index.md index 92e91e4..8eb9904 100644 --- a/docs/index.md +++ b/docs/index.md @@ -2,8 +2,9 @@ [![NuGet Version](https://img.shields.io/nuget/v/Silksong.ModMenu)](https://www.nuget.org/packages/Silksong.ModMenu) -ModMenu adds a "Mods" menu to the options menu screen, and provides an API for mods to customize -their menu. +The standard menu-modification mod for Silksong. It provides a small but powerful set of features for mods to use. + +This mod also adds a 'Mod Options' menu to the main Options menu by default. ## Usage From 184b825d95d0471f8c374b4b9365642bb8d3dfcd Mon Sep 17 00:00:00 2001 From: flibber-hk <76987839+flibber-hk@users.noreply.github.com> Date: Tue, 31 Mar 2026 20:28:52 +0100 Subject: [PATCH 4/4] Things that would be PR comments if I didn't get there first --- docs/docfx.json | 4 ++-- docs/toc.yml | 1 - 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/docfx.json b/docs/docfx.json index 1a9ac79..da8d754 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -11,7 +11,7 @@ } ], "dest": "api", - "filter": filterconfig.yml" + "filter": "filterconfig.yml" } ], "build": { @@ -45,4 +45,4 @@ "pdf": false } } -} \ No newline at end of file +} diff --git a/docs/toc.yml b/docs/toc.yml index 938e6f6..9a84d8e 100644 --- a/docs/toc.yml +++ b/docs/toc.yml @@ -2,4 +2,3 @@ href: articles/ - name: API Documentation href: api/ - \ No newline at end of file