mirror of https://gitgud.io/fatchan/jschan.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
296 lines
13 KiB
296 lines
13 KiB
extends ../layout.pug
|
|
include ../mixins/post.pug
|
|
|
|
block head
|
|
title Frequently Asked Questions
|
|
|
|
block content
|
|
h1.board-title FAQ
|
|
include ../includes/stickynav.pug
|
|
.table-container.flex-center.mv-5
|
|
.anchor
|
|
table
|
|
tr
|
|
th Frequently Asked Questions
|
|
tr
|
|
td.post-message
|
|
b General
|
|
ul.mv-0
|
|
li: a(href='#whats-an-imageboard') What is an imageboard?
|
|
li: a(href='/rules.html') What are the rules?
|
|
li: a(href='#contact') How can I contact the administration?
|
|
b Making posts
|
|
ul.mv-0
|
|
li: a(href='#name-formatting') How do names, tripcodes and capcodes work?
|
|
li: a(href='#post-styling') What kind of styling options are available when making a post?
|
|
li: a(href='#post-info') What is the file size limit?
|
|
b Boards, users & permissions
|
|
ul.mv-0
|
|
li: a(href='#make-a-board') How do I make my own board?
|
|
li: a(href='#antispam') What do the board settings for antispam do?
|
|
li: a(href='#archive-reverse-url-format') What is the archive/reverse image search link url format?
|
|
.table-container.flex-center.mv-5
|
|
.anchor#whats-an-imageboard
|
|
table
|
|
tr
|
|
th: a(href='#whats-an-imageboard') What is an imageboard?
|
|
tr
|
|
td
|
|
p
|
|
| An imageboard is a type of discussion board where users share images and text about various topics.
|
|
p
|
|
| The primary difference between imageboards and traditional forums is that anybody can make a post without registering
|
|
| an account or providing any personal information. This lowers the barrier to entry, protects user identities and focuses on what is said, rather than who says it.
|
|
.table-container.flex-center.mv-5
|
|
.anchor#name-formatting
|
|
table
|
|
tr
|
|
th: a(href='#name-formatting') Name formatting
|
|
tr
|
|
td.post-message
|
|
p When posting, you can format the name field to include a name, tripcode , capcode, any combination of the three including leaving the field completely blank. Instead of a blank name, "Anonymous" is used, however this depends on board-specific configuration. The optional components are explained below.
|
|
|
|
b Format
|
|
p
|
|
| Names should be input like:
|
|
input(disabled='true' spellcheck='false' type='text' value='Name##Tripcode## Capcode')
|
|
| . Tripcode and capcode are optional components. Please note the whitespace before capcodes is significant.
|
|
p Valid examples:
|
|
ol.mv-0
|
|
li name
|
|
li #tripcode
|
|
li ##tripcode
|
|
li ## capcode
|
|
li name#tripcode
|
|
li name##tripcode
|
|
li name## capcode
|
|
li name#tripcode## capcode
|
|
li name##tripcode## capcode
|
|
li #tripcode## capcode
|
|
li ##tripcode## capcode
|
|
li ##
|
|
p The last example is considered a blank capcode and can be used as a shortcut to display your role. Additionally, if a user has multiple aplicable roles (e.g. a board owner, but the user is also global staff) capcodes will default to their lowest role. To show the higher role, you must be explicit and precede any capcode with the role name e.g. ## Global Staff or ## Global Staff capcode
|
|
p Each component can be used in combination or independently. In a post number 9 would look like:
|
|
-
|
|
const examplePost = {
|
|
"date" : new Date("2019-08-02T09:48:44.180Z"),
|
|
"name" : "name",
|
|
"board" : "example",
|
|
"tripcode" : "!!X8NXmAS44=",
|
|
"capcode" : "##Board Owner capcode",
|
|
"message" : "Hello, world!",
|
|
"nomarkup" : "Hello, world!",
|
|
"thread" : 1,
|
|
"password" : null,
|
|
"email" : "",
|
|
"spoiler" : false,
|
|
"banmessage" : null,
|
|
"files" : [ ],
|
|
"reports" : [ ],
|
|
"globalreports" : [ ],
|
|
"quotes" : [ ],
|
|
"backlinks" : [ ],
|
|
"postId" : 123
|
|
}
|
|
+post(examplePost)
|
|
p The name appears bold in the top left, followed by the tripcode in regular weight with a !! prefix, then the capcode in a different color, bold and with a ## prefix. The colours may vary between themes but are generally distinct from each other
|
|
|
|
b Name
|
|
p The name is simply what name you want to be shown alongside your post. Other users can post with the same name so there is nothing preventing impersonation. This is not related to your username (for registered users).
|
|
|
|
b Tripcode
|
|
p A tripcode is a password of sorts, which users can provide in the tripcode component of their name. This tripcode is used in conjunction with a server-known secret to generate a unique* tripcode portion of the name. Long, unique tripcodes can be used as a form of identity. It is important that you keep tripcodes secret if you use them for some form of identity. A compromised tripcode can be used for impersonation and cannot be revoked in any way. Single # before tripcodes will use the traditional (what is now sometimes known as "insecure") tripcode algorithm shared by many imageboard softwares and websites. Double # before tripcodes will use a sha256 hash with server-side secret for a more secure, non-portable tripcode.
|
|
|
|
b Capcode
|
|
p A capcode is a component of the name field only available to authenticated users. This includes admins, global staff, board owners and board staff. If there is no text after the ##, the role will be displayed alone. Leaving a space and putting custom text will be prefixed by the role name. This way, the role is always shown to prevent role impersonation.
|
|
.table-container.flex-center.mv-5
|
|
.anchor#post-styling
|
|
table
|
|
tr
|
|
th(colspan=2): a(href='#post-styling') Post styling
|
|
tr
|
|
th Input
|
|
th Output
|
|
tr
|
|
td >greentext
|
|
td
|
|
span.greentext >greentext
|
|
tr
|
|
td <pinktext
|
|
td
|
|
span.pinktext <pinktext
|
|
tr
|
|
td ==title==
|
|
td
|
|
span.title title
|
|
tr
|
|
td ''bold''
|
|
td
|
|
span.bold bold
|
|
tr
|
|
td __underline__
|
|
td
|
|
span.underline underline
|
|
tr
|
|
td ~~strikethrough~~
|
|
td
|
|
span.strike strikethrough
|
|
tr
|
|
td ||spoiler text||
|
|
td
|
|
span.spoiler spoiler text
|
|
tr
|
|
td **italic**
|
|
td
|
|
span.em italic
|
|
tr
|
|
td (((detected)))
|
|
td
|
|
span.detected ((( detected )))
|
|
tr
|
|
td ##2%9+3
|
|
td
|
|
img(src='/file/dice.png' height='16' width='16')
|
|
span.dice (##2%9+3) = 10
|
|
tr
|
|
td https://example.com
|
|
td: a(href='#!') https://example.com
|
|
tr
|
|
td
|
|
| [Board Rules](https://your.imageboard/a/custompage/rules.html)
|
|
small (staff only)
|
|
td: a(href='#!') Board Rules
|
|
tr
|
|
td >>123
|
|
td: a(class="quote" href="#!") >>123
|
|
tr
|
|
td >>>/b/
|
|
td: a(class="quote" href="#!") >>>/b/
|
|
tr
|
|
td >>>/b/123
|
|
td: a(class="quote" href="#!") >>>/b/123
|
|
tr
|
|
td `inline monospace`
|
|
td
|
|
span.mono inline monospace
|
|
tr
|
|
td
|
|
| [code]language
|
|
br
|
|
| int main() {...}
|
|
br
|
|
| [/code]
|
|
td
|
|
span.code int main() {...}
|
|
tr
|
|
td
|
|
pre
|
|
| [code]aa
|
|
| ∧＿∧
|
|
| ( ・ω・) Let's try that again.
|
|
| [/code]
|
|
td
|
|
pre.aa
|
|
| ∧＿∧
|
|
| ( ・ω・) Let's try that again.
|
|
tr
|
|
td(colspan=2)
|
|
| Supported languages for code block syntax highlighting:
|
|
a(rel='nofollow' referrerpolicy='same-origin' target='_blank' href='https://github.com/highlightjs/highlight.js/blob/master/SUPPORTED_LANGUAGES.md') https://github.com/highlightjs/highlight.js/blob/master/SUPPORTED_LANGUAGES.md
|
|
| .
|
|
| If you do not specify a language, a subset of languages is supported for auto-detection: #{codeLanguages.join(', ')}.
|
|
| If the language is "plain", an unsupported value, or the auto-detect confidence is too low, highlighting is disabled for the code block.
|
|
| If the language is "aa", the font will be adjusted for Japanese Shift JIS art.
|
|
.table-container.flex-center.mv-5
|
|
.anchor#post-info
|
|
table
|
|
tr
|
|
th: a(href='#post-info') What is the file size limit?
|
|
tr
|
|
td
|
|
p Max size of form data per-post is #{postFilesSize}. Because other fields e.g. name, message, etc contribute to this, the maximum size of file uploads will be very slightly smaller than this.
|
|
.table-container.flex-center.mv-5
|
|
.anchor#moderation
|
|
table
|
|
tr
|
|
th: a(href='#moderation') How does moderation work?
|
|
tr
|
|
td.post-message
|
|
b Local vs. Global reports
|
|
p
|
|
| There exists the concept of "local" and "global" reports. Reporting a post locally will show the post along with reports on the report page for that particular board, and the reports
|
|
| may be actioned upon by the board staff. Reporting a post globally will show the post along with reports on the global manage page available only to global staff and may be actioned upon by global staff.
|
|
| Global reports should be used to flag posts that violate global rules such as illegal content or spam, in contrast to local reports which are for posts that abide by global rules but break
|
|
| board-specific rules (which may be made arbitrarily by board staff). It is also possible to be banned from a board or globally for abuse of the report system.
|
|
b Batch processing of posts
|
|
p
|
|
| Each post has a checkbox in the top left to select it for moderation actions. Multiple posts may be selected to allow batch processing e.g. reporting multiple offending posts in one request.
|
|
| The same is present in moderation interfaces. Some actions for example bans (which are based on IP) may also be handled in batches. Selecting multiple posts and using the ban action will
|
|
| apply a single ban for each unique IP of the selected posts.
|
|
b Time format in moderation interfaces
|
|
p
|
|
| Some moderation interfaces, for example the ban duration when moderating posts, or the ban duration for post filtering use a shorthand for times/length. This format supports years, months, weeks, days, hours, minutes and seconds.
|
|
| An input of "3mo" would mean 3 months and "1y2mo3w4d5h6m7s" would mean 1 year, 2 months, 3 weeks, 4 days, 5 hours, 6 minutes and 7 seconds. Units of time should be in descending order, so "2w1mo" is invalid.
|
|
| However you may use "6w" for example to input 6 weeks, and are not required to use "1mo2w".
|
|
.table-container.flex-center.mv-5
|
|
.anchor#make-a-board
|
|
table
|
|
tr
|
|
th: a(href='#make-a-board') How do I make my own board?
|
|
tr
|
|
td
|
|
p
|
|
a(href='/register.html') Register
|
|
| an account, then
|
|
a(href='/create.html') create a board
|
|
|. Please avoid making excessive amounts of boards, duplicate or boards similar to an existing one unless you expect that many users will migrate to the new board for whatever reason e.g. tyrannical moderation.
|
|
.table-container.flex-center.mv-5
|
|
.anchor#antispam
|
|
table
|
|
tr
|
|
th: a(href='#antispam') What do the board settings for antispam do?
|
|
tr
|
|
td
|
|
p Lock Mode: Choose to lock posting new threads or all posts.
|
|
p Captcha Mode: Choose to enforce captchas for posting threads or all posts.
|
|
p PPH Trigger Threshold: Trigger an action after a certain amount of PPH.
|
|
p PPH Trigger Action: The action to trigger.
|
|
p TPH Trigger Threshold: Trigger an action after a certain amount of TPH.
|
|
p TPH Trigger Action: The action to trigger.
|
|
p Trigger Reset Lock Mode: If a trigger threshold was reached, reset the lock mode to this at the end of the hour.
|
|
p Trigger Reset Captcha Mode: If a trigger threshold was reached, reset the captcha mode to this at the end of the hour.
|
|
p Early 404: When a new thread is posted, delete any existing threads with less than #{early404Replies} replies beyond the first 1/#{early404Fraction} of threads.
|
|
p Disable anonymizer file posting: Prevent users posting images through anonymizers such as Tor hidden services, lokinet SNApps or i2p eepsites.
|
|
p Blocked Countries: Block country codes (based on geo Ip data) from posting.
|
|
.table-container.flex-center.mv-5
|
|
.anchor#filters
|
|
table
|
|
tr
|
|
th: a(href='#filters') What do the filter options do?
|
|
tr
|
|
td
|
|
p Filters: Newline separated list of words or phrases to match in posts. Checks name, message, email, subject, and filenames.
|
|
p Strict Filtering: More aggressively match filters, by normalising the input compared against the filters.
|
|
p Filter Mode: What to do when a post matches a filter.
|
|
p Filter Auto Ban Duration: How long to automatically ban for when filter mode is set to ban. Input the duration in time format described in the #[a(href='#moderation') moderation section].
|
|
.table-container.flex-center.mv-5
|
|
.anchor#archive-reverse-url-format
|
|
table
|
|
tr
|
|
th: a(href='#archive-reverse-url-format') What is the archive/reverse image search link url format?
|
|
tr
|
|
td
|
|
p
|
|
| Put a link with
|
|
span.mono %s
|
|
| where the url of the page/file should go for reverse image search or archive links. For example
|
|
span.mono https://tineye.com/search?url=#[span.bold %s]
|
|
| .
|
|
.table-container.flex-center.mv-5
|
|
.anchor#contact
|
|
table
|
|
tr
|
|
th: a(href='#contact') How can I contact the administration?
|
|
tr
|
|
td
|
|
p Example
|
|
|