Publish docs

Author: joepio

.dagger/src/index.ts

@@ -10,6 +10,7 @@ import {
 } from "@dagger.io/dagger";
 
 const NODE_IMAGE = "node:24";
+const RUST_IMAGE = "rust:bookworm";
 
 @object()
 export class AtomicServer {
@@ -103,6 +104,42 @@ export class AtomicServer {
       .stdout();
   }
 
+  @func()
+  docsPublish(
+    @argument({ defaultPath: "/docs" }) source: Directory,
+    @argument() netlifyAuthToken: Secret
+  ): Promise<string> {
+    return dag
+      .container()
+      .from(NODE_IMAGE)
+      .withExec(["npm", "install", "-g", "netlify-cli"])
+      .withSecretVariable("NETLIFY_AUTH_TOKEN", netlifyAuthToken)
+      .withDirectory("/html", this.docsFolder(source.directory(".")))
+      .withWorkdir("/html")
+      .withExec([
+        "sh",
+        "-c",
+        "netlify link --name atomic-docs --auth $NETLIFY_AUTH_TOKEN",
+      ])
+      .withExec(["netlify", "deploy", "--dir", ".", "--prod"])
+      .stdout();
+  }
+
+  @func()
+  docsFolder(@argument({ defaultPath: "/docs" }) source: Directory): Directory {
+    const docsContainer = dag
+      .container()
+      .from(RUST_IMAGE)
+      .withExec(["cargo", "install", "mdbook"])
+      .withExec(["cargo", "install", "mdbook-linkcheck"]);
+    // We skip installing mdbook-sitemap-generator because it's broken
+    return docsContainer
+      .withDirectory("/docs", source)
+      .withWorkdir("/docs")
+      .withExec(["mdbook", "build"])
+      .directory("/docs/book/html");
+  }
+
   @func()
   typedocPublish(
     @argument({ defaultPath: "/browser" }) source: Directory,

CONTRIBUTING.md

@@ -69,8 +69,8 @@ Then you can run the commands from the `.dagger/src/index.ts` file, e.g. `dagger
 Add `-i` to the command to run in interactive mode, add `--output` to save the output to a folder.
 You can pass secrets / ENVS to dagger like so:
 `dagger call typedoc-publish --netlify-auth-token="env://NETLIFY_AUTH_TOKEN"`
+If Dagger is taking up a lot of storage, run `dagger core engine local-cache prune`.
 Note that the camelCase functions in the `index.ts` file are converted to kebab-case commands in the Dagger API.
-
 Check out the [Dagger docs](https://docs.dagger.io/) for more information.
 
 ### Compilation using Earthly

docs/src/SUMMARY.md

@@ -38,9 +38,9 @@
       - [Image](svelte/image.md)
     - [@tomic/template](create-template/atomic-template.md)
     - [@tomic/cli](js-cli.md)
-  - [Rust](rust-lib.md)
-    - [Rust lib](rust-lib.md)
-    - [Rust CLI](rust-cli.md)
+  - [Rust](rust.md)
+    - [CLI](rust-cli.md)
+    - [Lib](rust-lib.md)
 
 # Guides
 

docs/src/rust.md

@@ -0,0 +1,7 @@
+{{#title Rust libraries & tools for Atomic Data}}
+# atomic-lib: Rust libraries & tools for Atomic Data
+
+We have a [CLI] and a [library] for Rust.
+
+[CLI]: rust-cli.md
+[library]: rust-lib.md