From b6004a79f07806550e507adb99b98742903d0e15 Mon Sep 17 00:00:00 2001 From: Andrzej Ressel Date: Sun, 10 Mar 2024 17:43:47 +0100 Subject: [PATCH] Docs --- .github/workflows/docs.yml | 30 +++++++++++++++++++ docs.ps1 | 1 + docs.sh | 1 + docs/.gitignore | 1 - .../{pulumi-wasm => Internal}/Data passing.md | 0 docs/{pulumi-wasm => Internal}/Output.md | 0 .../Serialization formats.md | 0 docs/index.md | 1 + mkdocs.yml | 13 ++++++++ 9 files changed, 46 insertions(+), 1 deletion(-) create mode 100644 .github/workflows/docs.yml create mode 100644 docs.ps1 create mode 100755 docs.sh delete mode 100644 docs/.gitignore rename docs/{pulumi-wasm => Internal}/Data passing.md (100%) rename docs/{pulumi-wasm => Internal}/Output.md (100%) rename docs/{pulumi-wasm => Internal}/Serialization formats.md (100%) create mode 100644 docs/index.md create mode 100644 mkdocs.yml diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml new file mode 100644 index 000000000..7ddccf79e --- /dev/null +++ b/.github/workflows/docs.yml @@ -0,0 +1,30 @@ +name: ci +on: + push: + branches: + - master + - main + - docs +permissions: + contents: write +jobs: + deploy: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - name: Configure Git Credentials + run: | + git config user.name github-actions[bot] + git config user.email 41898282+github-actions[bot]@users.noreply.github.com + - uses: actions/setup-python@v5 + with: + python-version: 3.x + - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV + - uses: actions/cache@v4 + with: + key: mkdocs-material-${{ env.cache_id }} + path: .cache + restore-keys: | + mkdocs-material- + - run: pip install mkdocs-material + - run: mkdocs gh-deploy --force \ No newline at end of file diff --git a/docs.ps1 b/docs.ps1 new file mode 100644 index 000000000..37c2c9330 --- /dev/null +++ b/docs.ps1 @@ -0,0 +1 @@ +docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material \ No newline at end of file diff --git a/docs.sh b/docs.sh new file mode 100755 index 000000000..37c2c9330 --- /dev/null +++ b/docs.sh @@ -0,0 +1 @@ +docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material \ No newline at end of file diff --git a/docs/.gitignore b/docs/.gitignore deleted file mode 100644 index 0c5b2bed5..000000000 --- a/docs/.gitignore +++ /dev/null @@ -1 +0,0 @@ -/.obsidian diff --git a/docs/pulumi-wasm/Data passing.md b/docs/Internal/Data passing.md similarity index 100% rename from docs/pulumi-wasm/Data passing.md rename to docs/Internal/Data passing.md diff --git a/docs/pulumi-wasm/Output.md b/docs/Internal/Output.md similarity index 100% rename from docs/pulumi-wasm/Output.md rename to docs/Internal/Output.md diff --git a/docs/pulumi-wasm/Serialization formats.md b/docs/Internal/Serialization formats.md similarity index 100% rename from docs/pulumi-wasm/Serialization formats.md rename to docs/Internal/Serialization formats.md diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 000000000..3d7219c52 --- /dev/null +++ b/docs/index.md @@ -0,0 +1 @@ +# Getting started \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 000000000..6bf71be4f --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,13 @@ +site_name: Pulumi WASM +theme: + palette: + scheme: slate + name: material + search: true + +markdown_extensions: + - pymdownx.superfences: + custom_fences: + - name: mermaid + class: mermaid + format: !!python/name:pymdownx.superfences.fence_code_format \ No newline at end of file