Editing The Thread

When you edit a Thread section's toot , the generated web page won't be automatically updated.

You can, however, update it manually by writing a "flush" command, like this:

#threadit --flush

The toot's content won't be appended to the Thread, instead it will re-generate the web page using the edited content.

The best practice is to describe the changes you made in your "flush" command's toot, so that other users can see that the Thread was updated in a later date.

(WIP) Commands

You can also write commands right after the "threadit" hashtag, like "append", "overwrite" and "flush".

To use a command you must identify the section's index (and optionally a sub-index) and write it after double dashes "--" like this:

#threadit 2:1 --append

This toot will be displayed in the web page AFTER the last appended content of the section with index "2:1", and BEFORE the index "2:2" or "3".

As of now, the only supported commands are: "append", "overwrite" and "flush".

Conditions

If you don't identify the section's index, then the command will not work properly, EXCEPT for root commands like "flush" that don't need a section identifier.

If more than one command is included in the same toot, then the commands will not work properly.

Sub-Indexes

You can also continue writing in a specific Thread's section by repeating a previous index, or identify it as a sub-index, like this:

#threadit 2:1

This section is identified now by index "2" and sub-index "1". It will be displayed in the web page after the content of index "2" or "2:0".

Sub-indexes identifies a sub-section that will be displayed in the web page after the previous sub-index (in this case it will display after the index "2").

It can also be further used with commands, such as "overwrite" and "append". We will see some commands in action in the following sections.

Conditions

Follows the same conditions previously listed for "Index".

There can be only one level of sub-index ("2:1:1" is not valid).

If the parent index wasn't identified in any other toots of this thread (in this case the index "2" or "2:0"), then it will be displayed in the web page after the parent toot's (the one you replied to) most recent reply containing the hashtag "threadit".

Indexes

You can continue writing in a Thread by writing a reply to the original toot using the hashtag "threadit", OPTIONALLY followed by an index number, like this:

#threadit 2

If the reply does not contain the hashtag "threadit", it WILL NOT be included in the generated webpage as a section after the parent's toot (the one you replied to).

The index number identifies a Thread's section and represents the order that will be displayed on the generated web page. It can be used later together with commands that can reference an index (to overwrite or append content to the section, for example).

Conditions

If the hashtag "threadit" IS included in the reply, but IS NOT followed by an index number, then the Thread's section WILL NOT be further identifiable.

Further replies to the same parent toot containing the hashtag "threadit" WITH OR WITHOUT the same index number will be displayed on the web page right after the content of the parent toot, in the same order they were posted.