Merge branch 'main' of gitlab.com:bashrc2/epicyon

manual/make_epub

@@ -5,6 +5,7 @@ EPUB_AUTHORS='Bob Mottram'
 EPUB_LANGUAGE='English'
 EPUB_TAGS='fediverse, activitypub, server, linux, python, smallweb'
 EPUB_COMMENTS='ActivityPub server, designed for simplicity and accessibility. Includes calendar, news and sharing economy features to empower your federated community.'
+EPUB_PUBLISHER='Fuzzy Books'
 
 if [ ! -f /usr/bin/pandoc ]; then
     echo 'pandoc command not found'
@@ -13,12 +14,12 @@ fi
 pandoc -t html -f markdown -o manual.html manual.md
 git add manual.html
 if [ -f /usr/bin/ebook-convert ]; then
-    ebook-convert manual.html manual.epub --cover manual-cover.png --authors "${EPUB_AUTHORS}" --language "${EPUB_LANGUAGE}" --tags "${EPUB_TAGS}" --comments "${EPUB_COMMENTS}" --title "${EPUB_TITLE}"
+    ebook-convert manual.html manual.epub --cover manual-cover.png --authors "${EPUB_AUTHORS}" --language "${EPUB_LANGUAGE}" --tags "${EPUB_TAGS}" --comments "${EPUB_COMMENTS}" --title "${EPUB_TITLE}" --pretty-print  --publisher "${EPUB_PUBLISHER}"
 else
     echo 'ebook-convert command not found'
     if [ -f /usr/bin/flatpak ]; then
         if ! flatpak --command="sh" run com.calibre_ebook.calibre \
-             -c "ebook-convert manual.html manual.epub --cover manual-cover.png --authors \"${EPUB_AUTHORS}\" --language \"${EPUB_LANGUAGE}\" --tags \"${EPUB_TAGS}\" --comments \"${EPUB_COMMENTS}\" --title \"${EPUB_TITLE}\""; then
+             -c "ebook-convert manual.html manual.epub --cover manual-cover.png --authors \"${EPUB_AUTHORS}\" --language \"${EPUB_LANGUAGE}\" --tags \"${EPUB_TAGS}\" --comments \"${EPUB_COMMENTS}\" --title \"${EPUB_TITLE}\" --pretty-print --publisher \"${EPUB_PUBLISHER}\""; then
             exit 2
         fi
     fi

manual/manual.html

@@ -874,6 +874,38 @@ text with a star character.</p>
 <h2 id="searching-for-emojis">Searching for emojis</h2>
 <p>To search for an emoji use its name prefixed by a colon
 character.</p>
+<h1 id="browsing-in-a-command-shell">Browsing in a command shell</h1>
+<p>Since the web interface of Epicyon only needs HTML5 and CSS, it can
+work with browsers which don’t implement javascript at all.</p>
+<p>Screenshots within the preceding sections all assume that you are
+using a common graphical web browser. However, it is also possible to
+use Epicyon from a shell browser, such as <a
+href="https://lynx.invisible-island.net">Lynx</a>. This may be better
+suited for use with screen readers, or if you want to check your social
+media while logged into a server via <em>ssh</em>.</p>
+<p>If you are using <em>Lynx</em> then you will need to ensure that it
+is configured for the <strong>utf-8</strong> character set, and that you
+have emoji fonts installed (eg. <strong>noto-fonts-emoji</strong>). Edit
+your <em>lynx.cfg</em> file (usually in <em>/etc/lynx.cfg</em>) and
+set:</p>
+<pre class="text"><code>CHARACTER_SET:utf-8</code></pre>
+<p>To avoid annoying questions you may also want to set:</p>
+<pre class="text"><code>ACCEPT_ALL_COOKIES:TRUE</code></pre>
+<p>After logging in you will see a menu, which are shortcuts to
+different screens.</p>
+<figure>
+<img src="manual-lynx-menu.png"
+alt="Menu viewed within a shell browser" />
+<figcaption aria-hidden="true">Menu viewed within a shell
+browser</figcaption>
+</figure>
+<p>Timelines will look something like the following.</p>
+<figure>
+<img src="manual-lynx-inbox.png"
+alt="Inbox viewed within a shell browser" />
+<figcaption aria-hidden="true">Inbox viewed within a shell
+browser</figcaption>
+</figure>
 <h1 id="building-fediverse-communities">Building fediverse
 communities</h1>
 <p>The great thing about running a small instance is that you can do

manual/manual.md

@@ -629,6 +629,31 @@ To search for accounts having a particular skill, prefix your search text with a
 ## Searching for emojis
 To search for an emoji use its name prefixed by a colon character.
 
+# Browsing in a command shell
+Since the web interface of Epicyon only needs HTML5 and CSS, it can work with browsers which don't implement javascript at all.
+
+Screenshots within the preceding sections all assume that you are using a common graphical web browser. However, it is also possible to use Epicyon from a shell browser, such as [Lynx](https://lynx.invisible-island.net). This may be better suited for use with screen readers, or if you want to check your social media while logged into a server via *ssh*.
+
+If you are using *Lynx* then you will need to ensure that it is configured for the **utf-8** character set, and that you have emoji fonts installed (eg. **noto-fonts-emoji**). Edit your *lynx.cfg* file (usually in */etc/lynx.cfg*) and set:
+
+```text
+CHARACTER_SET:utf-8
+```
+
+To avoid annoying questions you may also want to set:
+
+```text
+ACCEPT_ALL_COOKIES:TRUE
+```
+
+After logging in you will see a menu, which are shortcuts to different screens.
+
+![Menu viewed within a shell browser](manual-lynx-menu.png)
+
+Timelines will look something like the following.
+
+![Inbox viewed within a shell browser](manual-lynx-inbox.png)
+
 # Building fediverse communities
 The great thing about running a small instance is that you can do things in whatever manner you prefer. What follows is a few guidelines which may help.
 

webapp_create_post.py

@@ -516,7 +516,8 @@ def html_new_post(media_instance: bool, translate: {},
         extra_fields += '</div>\n'
         extra_fields += '<div class="container">\n'
         city_or_loc_str = translate['City or location of the shared item']
-        extra_fields += edit_text_field(city_or_loc_str + ':', 'location', '')
+        extra_fields += edit_text_field(city_or_loc_str + ':', 'location', '',
+                                        'https://www.openstreetmap.org/#map=')
         extra_fields += '</div>\n'
         extra_fields += '<div class="container">\n'
         extra_fields += \
@@ -581,7 +582,8 @@ def html_new_post(media_instance: bool, translate: {},
         extra_fields += '</div>\n'
         extra_fields += '<div class="container">\n'
         city_or_loc_str = translate['City or location of the wanted item']
-        extra_fields += edit_text_field(city_or_loc_str + ':', 'location', '')
+        extra_fields += edit_text_field(city_or_loc_str + ':', 'location', '',
+                                        'https://www.openstreetmap.org/#map=')
         extra_fields += '</div>\n'
         extra_fields += '<div class="container">\n'
         extra_fields += \