From 00f4bbb5f0fed428bb759a2baaeb554d54fe3867 Mon Sep 17 00:00:00 2001 From: "N0\\A" Date: Wed, 1 Apr 2026 12:34:05 +0200 Subject: [PATCH] docs: quickstart.md --- .../the deepest depths/blobfish/blobfish.md | 2 ++ site/docs/quickstart.md | 32 +++++++++++++++++++ site/index.md | 3 +- 3 files changed, 35 insertions(+), 2 deletions(-) create mode 100644 site/docs/quickstart.md diff --git a/site/depths/deeper depths/deeper deeper depths/the deepest depths/blobfish/blobfish.md b/site/depths/deeper depths/deeper deeper depths/the deepest depths/blobfish/blobfish.md index 6c08011..5ab61b2 100644 --- a/site/depths/deeper depths/deeper deeper depths/the deepest depths/blobfish/blobfish.md +++ b/site/depths/deeper depths/deeper deeper depths/the deepest depths/blobfish/blobfish.md @@ -2,6 +2,8 @@ ![the greatest drawing of a blobfish in the world](blobfish.bmp) + + ![mine turtle hello](hello.mp3) Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus malesuada lacus eu ligula semper pharetra. Cras viverra volutpat massa nec sagittis. Aliquam fringilla quam ut tincidunt ultricies. Aliquam erat volutpat. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Sed id sagittis nisi. Aenean vitae urna justo. Vivamus dictum eros ac mi convallis, blandit hendrerit nunc sagittis. Mauris feugiat neque quis justo molestie, vel pulvinar diam faucibus. Ut tempus magna sit amet ex pharetra mollis. Ut elementum metus metus, id consectetur est tempor eget. Proin sed nibh tincidunt, porttitor elit non, blandit ligula. Ut condimentum accumsan lobortis. Nullam nec tempus leo, sit amet iaculis erat. Donec rutrum, orci in elementum varius, nisl elit rutrum nunc, in lacinia lorem enim non enim. diff --git a/site/docs/quickstart.md b/site/docs/quickstart.md new file mode 100644 index 0000000..980c27f --- /dev/null +++ b/site/docs/quickstart.md @@ -0,0 +1,32 @@ +--- +title = "Quickstart" +--- +# Quickstart + +## Creating a site + +```sh +kewt --new mysite +cd mysite +``` +This creates a directory with a `site.conf`, `template.html`, and `index.md`. + +## Writing content + +Edit `index.md` (or any `.md` file) and just write markdown as usual. Files in subdirectories are added to the navigation automatically. + +## Building + +```sh +kewt src out # Replace with the directories you want +``` +Reads from `src` and writes static HTML to `out`. + +## Previewing + +```sh +kewt --serve +``` +Builds the site and starts a local HTTP server. Use `--watch` with `--serve` to rebuild automatically on file changes. + +## That's it, if you want to do anything more, look at [the documentation](/docs) \ No newline at end of file diff --git a/site/index.md b/site/index.md index c0bab4b..2240028 100644 --- a/site/index.md +++ b/site/index.md @@ -41,5 +41,4 @@ It's meant to be a static site generator, like _[kew](https://github.com/uint23/ *** -> [!WARNING] -> The base that all of this is built upon was coded at night, while sleepy and a bit sick, and after walking for about 4 hours around a forest, so... +## [Quickstart guide](/docs/quickstart.html) \ No newline at end of file