Wordsmithing. Merge Institute.
authorMatt Birkholz <matt@birchwood-abbey.net>
Mon, 11 Mar 2024 23:35:23 +0000 (18:35 -0500)
committerMatt Birkholz <matt@birchwood-abbey.net>
Mon, 11 Mar 2024 23:35:23 +0000 (18:35 -0500)
Institute
README.html
README.org

index 07607b9a071a812daf99d3972a51ef8069ca91a4..13f9490138e5a6629413d2ed55f1d46c804c830b 160000 (submodule)
--- a/Institute
+++ b/Institute
@@ -1 +1 @@
-Subproject commit 07607b9a071a812daf99d3972a51ef8069ca91a4
+Subproject commit 13f9490138e5a6629413d2ed55f1d46c804c830b
index 79adba6b7aac19cad475370381f8e52c3069edbe..7001467933a25228bc8831c4f97217ac5d5d417d 100644 (file)
@@ -3,7 +3,7 @@
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
 <head>
-<!-- 2024-03-09 Sat 10:14 -->
+<!-- 2024-03-11 Mon 17:33 -->
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <title>Birchwood Abbey Networks</title>
@@ -64,7 +64,7 @@ map is very similar, with differences mainly in terminology,
 philosophy, attitude.
 </p>
 
-<pre class="example" id="org19dba2a">
+<pre class="example" id="org4281e1c">
                 |                                                   
                 =                                                   
               _|||_                                                 
@@ -136,8 +136,8 @@ with Apache2, spooling email with Postfix and serving it with
 Dovecot-IMAPd, and hosting a VPN with OpenVPN.
 </p>
 </div>
-<div id="outline-container-org044dad2" class="outline-3">
-<h3 id="org044dad2"><span class="section-number-3">3.1.</span> Install Emacs</h3>
+<div id="outline-container-org69d7b4c" class="outline-3">
+<h3 id="org69d7b4c"><span class="section-number-3">3.1.</span> Install Emacs</h3>
 <div class="outline-text-3" id="text-3-1">
 <p>
 The monks of the abbey are masters of the staff (bo) and Emacs.
@@ -337,12 +337,11 @@ Apache configurations.
 Like the suggested per-user rewrite rule in the <code>gitweb(1)</code> manual
 page, the second <code>RewriteRule</code> specifies the root directory of the
 user's public Git repositories via the <code>GITWEB_PROJECTROOT</code>
-environment variable.  It makes <code>http://www/~dick/gitweb.cgi</code> run
+environment variable.  It makes <code>http://www/~dick/git</code> run
 Gitweb with the project root <q>~dick/Public/Git/</q>, the same directory
 the <code>git-daemon</code> makes available.  The first <code>RewriteRule</code> directs
-URLs with no user name to the default.  Thus <code>http://www/gitweb.cgi</code>
-lists the repositories found in <q>/var/www/git/</q>.  The match patterns
-of both rules recognize <q>/gitweb</q> as well as <q>/gitweb.cgi</q>.
+URLs with no user name to the default.  Thus <code>http://www/git</code>
+lists the repositories found in <q>/var/www/git/</q>.
 </p>
 
 <div class="org-src-container">
@@ -352,10 +351,10 @@ Alias /gitweb-static/ /usr/share/gitweb/static/
     Options MultiViews
 &lt;/Directory&gt;
 RewriteEngine on
-RewriteRule ^/gitweb(\.cgi)?(/.*)?$ \
-            /cgi-bin/gitweb.cgi$2 [QSA,L,PT]
-RewriteRule ^/\~([^\/]+)/gitweb(\.cgi)?(/.*)?$ \
-            /cgi-bin/gitweb.cgi$3 \
+RewriteRule ^/git(/.*)?$ \
+            /cgi-bin/gitweb.cgi$1 [QSA,L,PT]
+RewriteRule ^/\~([^\/]+)/git(/.*)?$ \
+            /cgi-bin/gitweb.cgi$2 \
             [<span class="org-type">QSA,E=GITWEB_PROJECTROOT:/home/$1/Public/Git/,L,PT</span>]
 </pre>
 </div>
@@ -696,7 +695,7 @@ certificate is a terminal session affair (with prompts and lines
 entered as shown below).
 </p>
 
-<pre class="example" id="org8acfe85">
+<pre class="example" id="org148554f">
 $ sudo apt install python3-certbot-apache
 $ sudo certbot --apache -d birchwood-abbey.net
 ...
@@ -915,8 +914,8 @@ with Postfix and Dovecot, and providing essential localnet services:
 NTP, DNS and DHCP.
 </p>
 </div>
-<div id="outline-container-org167a44e" class="outline-3">
-<h3 id="org167a44e"><span class="section-number-3">4.1.</span> Include Abbey Variables</h3>
+<div id="outline-container-org6615595" class="outline-3">
+<h3 id="org6615595"><span class="section-number-3">4.1.</span> Include Abbey Variables</h3>
 <div class="outline-text-3" id="text-4-1">
 <p>
 In this abbey specific document, most abbey particulars are not
@@ -1114,8 +1113,8 @@ The abbey uses the Apt-Cacher:TNG package cache on Core.  The
 </div>
 </div>
 </div>
-<div id="outline-container-orga4f8ac2" class="outline-3">
-<h3 id="orga4f8ac2"><span class="section-number-3">4.8.</span> Use Cloister Apt Cache</h3>
+<div id="outline-container-org4d680ac" class="outline-3">
+<h3 id="org4d680ac"><span class="section-number-3">4.8.</span> Use Cloister Apt Cache</h3>
 <div class="outline-text-3" id="text-4-8">
 <p>
 Core itself will benefit from using the package cache.
@@ -1769,8 +1768,8 @@ clients: Android, Debian and Campus.  The last type never roams, and
 is not associated with a member of the small institute.
 </p>
 </div>
-<div id="outline-container-org4d680ac" class="outline-3">
-<h3 id="org4d680ac"><span class="section-number-3">6.1.</span> Use Cloister Apt Cache</h3>
+<div id="outline-container-org73a6192" class="outline-3">
+<h3 id="org73a6192"><span class="section-number-3">6.1.</span> Use Cloister Apt Cache</h3>
 <div class="outline-text-3" id="text-6-1">
 <p>
 The Apt-Cacher:TNG program does not work well on the frontier, so is
@@ -1840,8 +1839,8 @@ Raspberry Pis (architecture <code>aarch64</code>) only.
 </div>
 </div>
 </div>
-<div id="outline-container-org69d7b4c" class="outline-3">
-<h3 id="org69d7b4c"><span class="section-number-3">6.3.</span> Install Emacs</h3>
+<div id="outline-container-orge174712" class="outline-3">
+<h3 id="orge174712"><span class="section-number-3">6.3.</span> Install Emacs</h3>
 <div class="outline-text-3" id="text-6-3">
 <p>
 The monks of the abbey are masters of the staff and Emacs.
@@ -1908,7 +1907,7 @@ Listing them (e.g. running <code>owdir /26.nnnnnnnn</code> or <code>owdir
 below.  A test session is shown below.
 </p>
 
-<pre class="example" id="orge3426d6">
+<pre class="example" id="orgfb960ba">
 monkey@new$ owdir
 ...
     /26.2153B6000000/
@@ -2344,8 +2343,8 @@ described in the final section, <a href="#org1115114">Configure Cameras</a>, bel
 </p>
 </div>
 </div>
-<div id="outline-container-orgb786582" class="outline-3">
-<h3 id="orgb786582"><span class="section-number-3">8.4.</span> Include Abbey Variables</h3>
+<div id="outline-container-org1fd0c9c" class="outline-3">
+<h3 id="org1fd0c9c"><span class="section-number-3">8.4.</span> Include Abbey Variables</h3>
 <div class="outline-text-3" id="text-8-4">
 <p>
 Private variables in <q>private/vars-abbey.yml</q> are needed, and included
@@ -2725,7 +2724,7 @@ of area broadcasts.
 <p>
 The Abbey TVR Role installs the MythTV backend and the MythWeb web
 interface on the master server.  It configures the Apache web server
-to serve MythWeb pages at e.g. <code>http://NEW/mythweb/</code>.
+to serve MythWeb pages at e.g. <code>http://new/mythweb/</code>.
 </p>
 </div>
 <div id="outline-container-orge6089d9" class="outline-3">
@@ -2771,8 +2770,8 @@ machine simply by adding it to the <code>tvrs</code> group.
 </p>
 </div>
 </div>
-<div id="outline-container-org6615595" class="outline-3">
-<h3 id="org6615595"><span class="section-number-3">9.3.</span> Include Abbey Variables</h3>
+<div id="outline-container-orgd150c94" class="outline-3">
+<h3 id="orgd150c94"><span class="section-number-3">9.3.</span> Include Abbey Variables</h3>
 <div class="outline-text-3" id="text-9-3">
 <p>
 Private variables in <q>private/vars-abbey.yml</q> are needed, as in the
@@ -2869,7 +2868,7 @@ following.
 
 <p>
 The tasks above install runtime and compile-time requisites during the
-"first" run of e.g. <code>./abbey config NEW</code>.  The "first" run can be
+"first" run of e.g. <code>./abbey config new</code>.  The "first" run can be
 repeated until successful.  The remaining tasks are skipped until
 MythTV is built and installed.
 </p>
@@ -2879,7 +2878,7 @@ MythTV is built and installed.
 <h3 id="org64aabf5"><span class="section-number-3">9.5.</span> Build and Install MythTV</h3>
 <div class="outline-text-3" id="text-9-5">
 <p>
-After a successful "first" run of e.g. <code>./abbey config NEW</code>, the
+After a successful "first" run of e.g. <code>./abbey config new</code>, the
 target machine is prepared to build (and install) MythTV.  The
 following commands are used.
 </p>
@@ -3168,7 +3167,7 @@ addressed, MythTV Setup (the <code>mythtv-setup</code> program) can be run.  It
 must be run by the <code>mythtv</code> user, whose home directory will contain
 the MythTV (and XMLTV) configuration files.  The program is best run
 remotely (unless there is a graphical desktop on the server) by a
-command like <code>ssh -X mythtv@NEW mythtv-setup</code>.
+command like <code>ssh -X mythtv@new mythtv-setup</code>.
 </p>
 
 <p>
@@ -3317,7 +3316,7 @@ the list of "inputs" available in a postal code typically ends with
 the OTA (over the air) broadcasts.
 </p>
 
-<pre class="example" id="org47edab2">
+<pre class="example" id="org56157fc">
 $ tv_grab_zz_sdjson --configure --config-file .mythtv/Mr.Antenna.xmltv
 Cache file for lineups, schedules and programs.
 Cache file: [/home/mythtv/.xmltv/tv_grab_zz_sdjson.cache]
@@ -4822,7 +4821,7 @@ to <q>private/db.campus_vpn</q>.)
 </div>
 <div id="postamble" class="status">
 <p class="author">Author: Matt Birkholz</p>
-<p class="date">Created: 2024-03-09 Sat 10:14</p>
+<p class="date">Created: 2024-03-11 Mon 17:33</p>
 <p class="validation"><a href="https://validator.w3.org/check?uri=referer">Validate</a></p>
 </div>
 </body>
index 97034ec9cde01ba33bbb5b887e10b5c9f1f668da..fc962ff322ef9467c7c5f2635cf9fc334161eb33 100644 (file)
@@ -2335,7 +2335,7 @@ of area broadcasts.
 
 The Abbey TVR Role installs the MythTV backend and the MythWeb web
 interface on the master server.  It configures the Apache web server
-to serve MythWeb pages at e.g. ~http://NEW/mythweb/~.
+to serve MythWeb pages at e.g. ~http://new/mythweb/~.
 
 ** Building MythTV and MythWeb
 
@@ -2452,13 +2452,13 @@ index 7a1a0bc..26ba782 100644
 #+END_SRC
 
 The tasks above install runtime and compile-time requisites during the
-"first" run of e.g. ~./abbey config NEW~.  The "first" run can be
+"first" run of e.g. ~./abbey config new~.  The "first" run can be
 repeated until successful.  The remaining tasks are skipped until
 MythTV is built and installed.
 
 ** Build and Install MythTV
 
-After a successful "first" run of e.g. ~./abbey config NEW~, the
+After a successful "first" run of e.g. ~./abbey config new~, the
 target machine is prepared to build (and install) MythTV.  The
 following commands are used.
 
@@ -2695,7 +2695,7 @@ addressed, MythTV Setup (the ~mythtv-setup~ program) can be run.  It
 must be run by the ~mythtv~ user, whose home directory will contain
 the MythTV (and XMLTV) configuration files.  The program is best run
 remotely (unless there is a graphical desktop on the server) by a
-command like ~ssh -X mythtv@NEW mythtv-setup~.
+command like ~ssh -X mythtv@new mythtv-setup~.
 
 Patience is required.  The ~mythtv-setup~ program was not written for
 X11 and the X11 adapter has a difficult job.  It is often hard to