diff --git a/astro.config.mjs b/astro.config.mjs index 34d7f35..6cb5b8b 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -1,12 +1,18 @@ -import { defineConfig } from 'astro/config'; +import { defineConfig } from "astro/config"; -import mdx from '@astrojs/mdx'; +import mdx from "@astrojs/mdx"; -import tailwind from '@astrojs/tailwind'; - -import starlight from '@astrojs/starlight'; +import starlight from "@astrojs/starlight"; // https://astro.build/config export default defineConfig({ - integrations: [mdx(), tailwind(), starlight()] -}); \ No newline at end of file + integrations: [ + starlight({ + title: "My delightful docs site", + customCss: [ + './src/styles/custom.css', + ], + }), + mdx(), + ], +}); diff --git a/src/content/config.ts b/src/content/config.ts new file mode 100644 index 0000000..31b7476 --- /dev/null +++ b/src/content/config.ts @@ -0,0 +1,6 @@ +import { defineCollection } from 'astro:content'; +import { docsSchema } from '@astrojs/starlight/schema'; + +export const collections = { + docs: defineCollection({ schema: docsSchema() }), +}; diff --git a/src/content/docs/docs/index.md b/src/content/docs/docs/index.md new file mode 100644 index 0000000..3da1b57 --- /dev/null +++ b/src/content/docs/docs/index.md @@ -0,0 +1,33 @@ +--- +title: The search for the perfect ed25519 key pair +template: splash +--- + +Todo write intro to catch attention + +### Why care about ed25519 key pairs? + +Ed25519 is a cryptographic algorithm for generating +a pair of keys, a public one that can be shared with anyone +and a private one that is kept as a secret. + +### The ssh public key format + +If you have ever accessed a remote server it was most likely by +ssh-ing into it. +You have also most likely had to copy paste something similar to this: + +```pub +ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIBSSj+yfJLWEb+Df4r4603TOFAUBREYS43qQB+c9i9UW +``` + +Let's break it down: + +- The first part `ssh-ed25519` is the algorithm type, other common algorithms are `ssh-rsa` and `ssh-ecdsa` +- The second part is a base64-encoded binary format consiting of: + * the length of the algorithm string, for ed25519 it's always 11 (4 bytes long) + * the algorithm type, for ed25519 it's always `ssh-ed25519` in binary (11 bytes long) + * the length of the key, 32 bytes for ed25519 (4 bytes long) + * the actual ed25519 key (32 bytes long) + + diff --git a/src/content/docs/docs/test.md b/src/content/docs/docs/test.md new file mode 100644 index 0000000..f8e3832 --- /dev/null +++ b/src/content/docs/docs/test.md @@ -0,0 +1,23 @@ +--- +title: My dakdkadkadk a +description: EEEEEE akd ak dka kdak ak dka kdka dk ak +template: splash +--- + +# My oadkadkakd + +## Secondary + +Testing some content with multiline thing + +```go example.go +package main + +import "fmt" + +func main() { + fmt.Println("Hello, World!") +} +``` + +Hmm diff --git a/src/content/docs/docs/test2.md b/src/content/docs/docs/test2.md new file mode 100644 index 0000000..02b9fbd --- /dev/null +++ b/src/content/docs/docs/test2.md @@ -0,0 +1,66 @@ +--- +title: My docs +description: Learn more about my project in this docs site built with Starlight. +template: splash +--- + +# My Title + +## Secondary + +### Test + +#### 4 + +##### 5 + +###### 6 + +####### 7 Should be normal + +Testing some content with multiline thing +let's see what happens if this wraps +This should be super close + +This should be far + +- Some bullets +- Adka kda kd ak +- d kakd akd ka k + +- [ ] Check me +- [x] Already checked + +## Smaller header + +How about code blocks + +```go example.go +package main + +import "fmt" + +func main() { + fmt.Println("Hello, World!") +} +``` + +Hmm + +> ![INFO] +> Does this work + +This is `highlighting` I think is what it's called + +:::caution +If you are not sure you want an awesome docs site, think twice before using [Starlight](/). +::: + +:::danger +Your users may be more productive and find your product easier to use thanks to helpful Starlight features. + +- Clear navigation +- User-configurable colour theme +- [i18n support](/guides/i18n/) + +::: diff --git a/src/pages/test.astro b/src/pages/test.astro index af39d74..e11b196 100644 --- a/src/pages/test.astro +++ b/src/pages/test.astro @@ -1,12 +1,13 @@ --- import Prose from '../components/Prose.astro'; import MarkdownLayout from '../layouts/MarkdownLayout.astro'; +import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro'; import { getEntry } from 'astro:content'; const entry = await getEntry('blogs', 'blog-1'); const { Content } = await entry.render(); --- - + diff --git a/src/styles/custom.css b/src/styles/custom.css new file mode 100644 index 0000000..e8750d5 --- /dev/null +++ b/src/styles/custom.css @@ -0,0 +1,7 @@ +:root { + width: 70%; + margin: auto; +} +p { + font-size: 1.625rem; +}