diff --git a/manual/make_epub b/manual/make_epub index ebbf0c784..43a3ce145 100755 --- a/manual/make_epub +++ b/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 diff --git a/manual/manual-lynx-inbox.png b/manual/manual-lynx-inbox.png new file mode 100644 index 000000000..601a4998c Binary files /dev/null and b/manual/manual-lynx-inbox.png differ diff --git a/manual/manual-lynx-menu.png b/manual/manual-lynx-menu.png new file mode 100644 index 000000000..18a57ed0c Binary files /dev/null and b/manual/manual-lynx-menu.png differ diff --git a/manual/manual.epub b/manual/manual.epub index 8031951c4..a00fae144 100644 Binary files a/manual/manual.epub and b/manual/manual.epub differ diff --git a/manual/manual.html b/manual/manual.html index 73c0fee05..95d91a62a 100644 --- a/manual/manual.html +++ b/manual/manual.html @@ -874,6 +874,38 @@ text with a star character.

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. 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:

+
CHARACTER_SET:utf-8
+

To avoid annoying questions you may also want to set:

+
ACCEPT_ALL_COOKIES:TRUE
+

After logging in you will see a menu, which are shortcuts to +different screens.

+
+ + +
+

Timelines will look something like the following.

+
+ + +

Building fediverse communities

The great thing about running a small instance is that you can do diff --git a/manual/manual.md b/manual/manual.md index 692b237c7..1d2e15ecf 100644 --- a/manual/manual.md +++ b/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. diff --git a/webapp_create_post.py b/webapp_create_post.py index 53b991782..3bb172511 100644 --- a/webapp_create_post.py +++ b/webapp_create_post.py @@ -516,7 +516,8 @@ def html_new_post(media_instance: bool, translate: {}, extra_fields += '\n' extra_fields += '

\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 += '
\n' extra_fields += '
\n' extra_fields += \ @@ -581,7 +582,8 @@ def html_new_post(media_instance: bool, translate: {}, extra_fields += '
\n' extra_fields += '
\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 += '
\n' extra_fields += '
\n' extra_fields += \