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

docs: show the quickstart commands and real contact details on the index

Browse source
This commit is contained in:
randogoth 2026-10-11 21:16:45 +03:00
parent 2ea4f461d3
commit ba99b3034a
1 changed files with 15 additions and 15 deletions
Download patch file Download diff file Expand all files Collapse all files

30
site/index.html
View file

@ -2,7 +2,7 @@
<!DOCTYPE html PUBLIC "-//WAPFORUM//DTD XHTML Mobile 1.2//EN" "http://www.openmobilealliance.org/tech/DTD/xhtml-mobile12.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>Mews</title>
<title>the mews</title>
<meta name="mews-profile" content="0.1"/>
<meta name="viewport" content="width=device-width"/>
<meta name="description" content="A quiet corner of the web, built on a standard that was already cut back: XHTML Mobile Profile 1.2."/>
@ -24,7 +24,7 @@
</p>
<p><strong>Authors provide structure. Readers control presentation.</strong></p>
<p>
For viewing Mews pages in regular web browsers let's allow exactly one stylesheet, reduced colour palette, sane defaults, optimized for legibility, and you don't write it: host your own copy of <a href="/mews-0.1.css" accesskey="4">mews-0.1.css</a> on your own site and leave it alone. Dedicated reading apps let readers customize fonts and colours to suit their preferences, so they can enjoy <em>your</em> content in the way that works best for <em>them</em>.
For viewing <em>mews</em> pages in regular web browsers let's allow exactly one stylesheet, reduced colour palette, sane defaults, optimized for legibility, and you don't write it: host your own copy of <a href="/mews-0.1.css" accesskey="4">mews-0.1.css</a> on your own site and leave it alone. Dedicated reading apps let readers customize fonts and colours to suit their preferences, so they can enjoy <em>your</em> content in the way that works best for <em>them</em>.
</p>
<h2>How the directory works</h2>
<p>
@ -56,18 +56,18 @@
</li>
</ul>
<h2>From the repo</h2>
<ul>
<li>
<a href="https://code.randogoth.com/randogoth/mews.page/src/branch/main/sample/sample.html" accesskey="5">A sample page</a>, with one of everything a page can hold.
</li>
<li>
<a href="https://code.randogoth.com/randogoth/mews.page/src/branch/main/md2mews.py" accesskey="6">md2mews.py</a>, which turns Markdown into a Mews page.
</li>
<li>
<a href="https://code.randogoth.com/randogoth/mews.page/src/branch/main/pelican-mews" accesskey="7">pelican-mews</a>, for a site with more pages than you want to write by hand.
</li>
</ul>
<p>So: write something. Link to a neighbour. Leave the light on.</p>
<address>trl(at)posteo(dot)net</address>
<p>In our repo you can find a <a href="https://code.randogoth.com/randogoth/mews.page/src/branch/main/sample/sample.html" accesskey="5">sample page</a>, with one of every element a mews page can hold. There's also <a href="https://code.randogoth.com/randogoth/mews.page/src/branch/main/md2mews.py" accesskey="6">md2mews.py</a>, a script that turns Markdown into a <em>mews</em> page.</p>
<p>To get started from scratch with a real blog with more pages than you want to write by hand, here's a quickstart script for you. It writes the project, installs the <a href="https://getpelican.com/">Pelican</a> static site generator together with our <a href="https://code.randogoth.com/randogoth/mews.page/src/branch/main/pelican-mews" accesskey="7">pelican-mews</a> plugin, and leaves you a first post to edit:</p>
<pre>uvx --from git+https://code.randogoth.com/randogoth/mews.page.git mews-quickstart mysite
cd mysite
uv run pelican content</pre>
<p>The pages land in <code>output/</code> as plain HTML that any web
server will serve as valid <em>mews</em> pages.</p>
<h2>Get in touch</h2>
<p>Bug reports, arguments about the spec, and sites that ought to be listed and aren't, <a href="mailto:trl(ät)posteo(punkt)net">mail me</a> or even better, send me a <a href="https://smol.place">smolmail</a>:</p>
<address>smol://randogoth@smol.place/olrtb3y4xr73w3gxgslejz4c6klgiawdu63ms2vm3nxekonqxk3a</address>
<hr />
<p>So: write something. Link to a neighbour. Leave the light on.</p>
</body>
</html>