follow-toots/about.html at master · hcschuetz/follow-toots · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Follow Toots - About</title>
  <link rel="stylesheet" href="src/style.css">
</head>
<body>
  <nav id="nav"></nav>

  <h1>Follow Toots - About</h1>

  <h2>What is this good for?</h2>
  <p>
    Occasionally you see a toot on mastodon and you are interested
    in the (direct and indirect) replies to that toot.
    Somebody might have asked an interesting question and you want to see the
    answers given by other users.
    Or somebody makes a joke and you expect funny replies.
    Or ...
  </p>
  <p>
    Mastodon clients display the current "toot tree".
    If you want to see future replies, you can open the toot in a
    separate browser tab and reload it occasionally.
    But then you have to search the tree manually for new toots,
    which soon becomes tedious.
  </p>
  <p>
    This application makes it more comfortable to "follow" a toot,
    or actually the replies to it.
  </p>
  <h2>Basic Usage</h2>
  <p>
    If you want to follow a toot, copy its URL to the field
    "URL of a toot to follow" in the <a href=".">overview page</a>
    and add it to your list of followed toots.
    (This could be made more convenient if your favorite Mastodon client
    provided a button or link to automate this.
    But you can get similar convenience by using the bookmarklet provided on
    the <a href="config.html">configuration page</a>.)
  </p>
  <p>
    Select one of the list entries to see the corresponding tree.
  </p>
  <p>
    Initially all the toots in a tree are in state "unseen" and will be
    displayed completely.
    You can mark toots as seen by checking the checkbox,
    which hides the toot body.
    Newly incoming toots will be "unseen" and will thus be displayed completely.
    This way you find new replies quickly without the need
    for searching through a tree again and again.
  </p>
  <p>
    Actually the previous paragraph just describes the default behavior.
    It is possible to change what is being displayed by the menus
    in the header of the tree page.
  </p>
  <p>
    Important parts of the application state are persisted by your browser:
  </p>
  <ul>
    <li>the toots you follow (together with their ancestors and descendants),</li>
    <li>which toots you have marked as seen,</li>
    <li>and configuration choices.</li>
  </ul>
  <p>
    This state data survives the closing and re-opening of pages
    and even a browser restart.
  </p>

  <h2>More Notes</h2>
  <ul>
    <li>
      The application does not poll for tree updates regularly.
      You have to click a "reload" button to get the latest data.
    </li>
    <li>
      On the other hand, reloads from one page (for example a tree page)
      will also be used by other pages (such as the overview page).
    </li>
    <li>
      You can view the descendants of a toot in hierarchical mode (as a tree)
      and in chronological mode (as a list).
      In the latter mode it is also possible to hide seen toots completely.
      <br>
      By the way, the hierarchical view detects threads and displays them
      without indentation but with numbered toots.
    </li>
    <li>
      The toot display does not yet support all the possible features of a toot,
      but it should cover the most important cases.
      And (at least for now) it is read-only.
      But if you want to interact with a toot or user,
      it is easy to navigate back to another mastodon web client.
    </li>
  </ul>
  <script type="module" src="src/nav.ts"></script>
</body>
</html>