docs: hello, docsite (#136)

.github/workflows/publish_docs.yml

@@ -0,0 +1,40 @@
+name: Publish docs
+on:
+  push:
+    branches:
+      - main
+  paths:
+    - "docs/**"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # To push a branch
+      pages: write # To push to a GitHub Pages site
+      id-token: write # To update the deployment status
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Install latest mdbook
+        run: |
+          tag=$(curl 'https://api.github.com/repos/rust-lang/mdbook/releases/latest' | jq -r '.tag_name')
+          url="https://github.com/rust-lang/mdbook/releases/download/${tag}/mdbook-${tag}-x86_64-unknown-linux-gnu.tar.gz"
+          mkdir mdbook
+          curl -sSL $url | tar -xz --directory=./mdbook
+          echo `pwd`/mdbook >> $GITHUB_PATH
+      - name: Build Book
+        run: |
+          cd docs
+          mdbook build
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          # Upload entire repository
+          path: "book"
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/release.yml

@@ -5,6 +5,8 @@ on:
     branches:
       - main
       - next
+  paths-ignore:
+    - "docs/**"
 
 permissions:
   contents: read # for checkout

.gitignore

@@ -19,6 +19,7 @@ out/
 .eslintcache
 .nyc_output
 coverage/
+docs/book/
 
 # Configuration
 .eslintcache

docs/book.toml

@@ -0,0 +1,7 @@
+[book]
+authors = ["William Killerud"]
+language = "en"
+multilingual = false
+src = "src"
+title = "Documentation for Some Sass"
+description = "Some Sass is an extension for Visual Studio Code as well as a standalone LSP server for SCSS. It provides code suggestions, hover information with SassSoc and code navigation for SCSS. It has full support for @use and @forward, including prefixes and hide/show."

docs/src/README.md

@@ -0,0 +1,3 @@
+# Some Sass
+
+Hello, World

docs/src/SUMMARY.md

@@ -0,0 +1,3 @@
+# Summary
+
+[Introduction](README.md)