randogoth/mews.page
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: move the tool instructions to a getting started page and publish every site page

Browse source
This commit is contained in:
randogoth 2026-10-13 13:04:25 +03:00
parent 060d4e00fd
commit 2bc69c039f
5 changed files with 56 additions and 31 deletions
Download patch file Download diff file Expand all files Collapse all files

15
site/content/pages/index.md
View file

@ -4,7 +4,7 @@ Description: A quiet corner of the web, built on a standard that was already cut
# the mews
[Directory](/directory)  ·  [Specification](/spec/0.1)
[Directory](/directory) · [Get started](/quickstart) · [Specification](/spec/0.1)
The web is a loud place now. Pages track you, shout at you, and weigh magnitudes more than the words they carry.
@ -18,18 +18,7 @@ The [IndieWeb](https://indieweb.org/), small web, and alternative protocols like
To get listed, publish a site that conforms to the doctype, avoids script tags, nested tables, divs, and other unsupported elements and only embeds the <a href="/mews-0.1.css" accesskey="4">mews-0.1.css</a> stylesheet. Validate and submit it [here](/check). Done.
## Get started
Check this [sample page](https://code.randogoth.com/randogoth/mews.page/src/branch/main/sample/sample.html) with one of every element a mews page can hold and the [validator](/check) that tells you for any address exactly what it breaks and why.
For a simple way to create compatible content there's a [Python script](https://code.randogoth.com/randogoth/mews.page/src/branch/main/quickstart/md2mews.py) that converts from a Markdown file. If you want a real blog engine, here's a [uvx](https://github.com/astral-sh/uv) powered quickstart script that writes a project folder, installs the [Pelican](https://getpelican.com/) static site generator together with our [pelican-mews](https://code.randogoth.com/randogoth/mews.page/src/branch/main/pelican-mews) plugin, and leaves you a first post to edit:
<pre>uvx --from git+https://code.randogoth.com/randogoth/mews.page.git#subdirectory=quickstart \
mews-quickstart mysite
cd mysite
uv run pelican content</pre>
The pages land in `output/` as plain HTML that any web server will serve as valid *mews* pages.
A quickstart guide on how to create content can be found on our [Get started](/quickstart) page.
## Get in touch