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

site/index.html

@@ -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>
+        <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>
-            <li>
+        <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>
-                <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.
+        <pre>uvx --from git+https://code.randogoth.com/randogoth/mews.page.git mews-quickstart mysite
-            </li>
+cd mysite
-            <li>
+uv run pelican content</pre>
-                <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.
+        <p>The pages land in <code>output/</code> as plain HTML that any web
-            </li>
+        server will serve as valid <em>mews</em> pages.</p>
-            <li>
+        <h2>Get in touch</h2>
-                <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.
+	        <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>
-            </li>
+          <address>smol://randogoth@smol.place/olrtb3y4xr73w3gxgslejz4c6klgiawdu63ms2vm3nxekonqxk3a</address>
-        </ul>
+          <hr />
-        <p>So: write something. Link to a neighbour. Leave the light on.</p>
+          <p>So: write something. Link to a neighbour. Leave the light on.</p>
-        <address>trl(at)posteo(dot)net</address>
+        
     </body>
 </html>