diff --git a/help/en/attachment.myco b/help/en/attachment.myco index 714a8bd..39ce297 100644 --- a/help/en/attachment.myco +++ b/help/en/attachment.myco @@ -1,29 +1,29 @@ -# Help: Attachment += Help: Attachment In hyphae, an **attachment** is some content represented by something that is not [[/help/en/mycomarkup | Mycomarkup]]. Usually, an image, a video, or an audio. -## Supported attachment types +== Supported attachment types You can upload any file, but only those listed below will be displayed on the website. You can download unsupported attachments, though. * **Images:** jpg, gif, png, webp, svg, ico * **Video:** ogg, webm, mp4 * **Audio:** ogg, webm, mp3 -## How to add an attachment? +== How to add an attachment? For non-existent hyphae, upload a file in the //Upload a media// section. For any hyphae, upload a file in the //Manage attachment// tab. -## Attachment management +== Attachment management Every hypha has the //Manage attachment// section. Click it to see what is out there. You can upload a new file, you can //delete// the attachment (it is called //unattaching//) and see some file stats (size and type). -## On naming hyphae with attachments +== On naming hyphae with attachments The hypha name should not just copy the file name in most cases. If you are uploading a photo of a rose, do not call it `rose.jpg`, no. Call it `photo of rose` or `rose photo` or whatever. You rarely need to think of file extensions when using Mycorrhiza Wiki. This is not a rule, of course, just a convention. -## What to put in the text part? +== What to put in the text part? If a hypha has an attachment, here is what the text part might be about: * A textual description or representation of the picture. * A transcript of the song. diff --git a/help/en/feeds.myco b/help/en/feeds.myco index 204b2cf..916c1cd 100644 --- a/help/en/feeds.myco +++ b/help/en/feeds.myco @@ -1,8 +1,8 @@ -# Help: Feeds += Help: Feeds Mycorrhiza Wiki has RSS, Atom, and JSON feeds to track the latest changes on the wiki. These feeds are linked on the [[/recent-changes | recent changes page]]. -## Options +== Options These feeds have options to combine related changes into groups: * { **period** Can be set to lengths of time like `5m`, `24h`, etc. @@ -19,7 +19,7 @@ These feeds have options to combine related changes into groups: If none of these options are set, changes will never be grouped. -## Examples +== Examples URLs for feeds using these options look like this: * { `/recent-changes-rss?period=1h` diff --git a/help/en/hypha.myco b/help/en/hypha.myco index 93aa7cf..27d1a8c 100644 --- a/help/en/hypha.myco +++ b/help/en/hypha.myco @@ -1,33 +1,33 @@ -# Help: Hypha += Help: Hypha A **hypha** (//plural:// hyphae) is the main content unit used in Mycorrhiza Wiki. -## The structure of hypha +== The structure of hypha A hypha consists of two parts: * **Attachment.** Some form of media. There is only one attachment. See [[/help/en/attachment | Attachment]] for more information about attachments. * **Text part.** Either a description of the attachment or a stand-alone text unit such as an article, a diary or a poem. It is written in a special markup, called [[/help/en/mycomarkup | Mycomarkup]]. Both parts are optional. You can have a picture without description, an article without an attachment, etc. You can have them both. You must have at least one part, though. -## How to create a hypha? +== How to create a hypha? Some links on wiki are red. It means that they link a hypha that does not exist yet. If you follow this link, you will see a special page where you can upload an attachment or open the text editor. This is how you create hyphae. You can create such red links and follow them to create hyphae. Alternatively, you can edit your address in browser to jump to such pages directly. -## Hypha names +== Hypha names Hypha names are case-insensitive. It means that names //amanita muscaria// and //Amanita Muscaria// are the same. Also, space and underscore are also the same (//amanita muscaria// = //amanita_muscaria//). Canonical names are all lowercase and underscored. There are some characters that cannot be part of a hypha name: `?!:#@><*|"'&%{}\\` Others can be used. -## Genealogy +== Genealogy A **subhypha** is a hypha that has a name starting with a name of a different hypha, followed by a slash and by the rest of the name. For example, hypha //Fruit/Apple// is a subhypha of hypha //Fruit//. There can be as many subhyphae as you want. Subhyphae can have subhyphae themselves. Thus, a **superhypha** is a reverse of subhypha: //Fruit// is the superhypha of //Fruit/Apple//. There can be only one superhypha. **Sibling hyphae** are hyphae that are subhyphae of the same hypha. For example, //Fruit/Apple// and //Fruit/Pear// are sibling hyphae. -## Word +== Word Read the word //hypha// as /ˈhaɪfə/. The plural form is //hyphae//. Read it as /ˈhaɪfi/. The word is taken from mycology, the study of fungi. In a fungus, hyphae are thin white threads from which the mycelium is made. See [[https://en.wikipedia.org/wiki/Hypha | this Wikipedia article]] for more information about real hyphae. diff --git a/help/en/lock.myco b/help/en/lock.myco index f9fe718..1deb3aa 100644 --- a/help/en/lock.myco +++ b/help/en/lock.myco @@ -1,9 +1,9 @@ -# Lock += Lock //This article is intended for wiki administrators.// Sometimes, you may want to let only authorized users to view your wiki. This is when **lock** comes in handy. -## Enabling +== Enabling In `config.ini`, set `Locked` to `true` to enable. `UseAuth` must also be `true`. ```ini ... @@ -15,7 +15,7 @@ Locked = true Restart your wiki. -## Usage +== Usage When unauthorized people visit your wiki, they will see something like this: img { https://mycorrhiza.wiki/binary/release/1.3/lock_screenshot @@ -23,5 +23,5 @@ https://mycorrhiza.wiki/binary/release/1.3/lock_screenshot If they log in, they will be able to navigate the wiki. They are not able to register, though. [[/help/en/telegram | Telegram]] authorization is supported. -## See also +== See also => /help/en/whitelist Whitelist \ No newline at end of file diff --git a/help/en/mycomarkup.myco b/help/en/mycomarkup.myco index ee30f12..b5b1391 100644 --- a/help/en/mycomarkup.myco +++ b/help/en/mycomarkup.myco @@ -1,11 +1,11 @@ -# Mycomarkup += Mycomarkup **Mycomarkup** is Mycorrhiza Wiki's own markup language. It is the only supported markup, there is no support for Markdown, Creole, etc. A Mycomarkup document (which is most often a hypha's text part) consists of //blocks//. There are different blocks for different purposes. -## Table of contents +== Table of contents => /help/en/mycomarkup#Paragraph Paragraph => /help/en/mycomarkup#Inline_link Inline link => /help/en/mycomarkup#Rocket_link Rocket link @@ -18,7 +18,7 @@ A Mycomarkup document (which is most often a hypha's text part) consists of //bl => /help/en/mycomarkup#Table Table => /help/en/mycomarkup#Transclusion Transclusion -## Paragraph +== Paragraph **Paragraphs** are the most ubiquitous blocks. You will use them a lot. To create a paragraph, just write text. Paragraphs are separated by empty lines. @@ -64,8 +64,8 @@ Just a paragraph with a couple of [[https://example.org | links]] leading [[nowh ```} * Just a paragraph with a couple of [[https://example.org | links]] leading [[nowhere]]. -## Link -### Inline link +== Link +=== Inline link **Inline links** are part of a paragraph. External links can be placed verbatim if they have protocol specified. These links are called autolinks. It may not work as expected sometimes. Supported protocols for autolinks are https, http, gemini, gopher, ftp. @@ -88,7 +88,7 @@ Links to [[hypha | a Hypha]] and [[https://example.org | some website]]. Since hypha names are case-insensitive, these links are basically the same: `[[hypha]]`, `[[Hypha]]`, `[[HYPHA]]`. -### Rocket link +=== Rocket link **Rocket links** are special links. They take up a whole line. They are not consistent with usual inline links. They were taken from [[https://gemini.circumlunar.space/docs/gemtext.gmi | gemtext]]. The display text is written after the first space, not `|`. If you want to link a hypha with spaces in it, replace the spaces with _. @@ -106,7 +106,7 @@ The display text is written after the first space, not `|`. If you want to link => https://example.org Display text } -### Relative link addressing +=== Relative link addressing You don't have to write the full hypha name in every link, you can use **relative** links. Consider you are editing a hypha called //fruit/apple//. @@ -115,12 +115,12 @@ To link //fruit/pear// (a sibling hypha) you can write `[\[../pear]]`. To link / There is also a way to link the wiki's non-hypha pages. For example, to link the Recent changes page, you can write `[\[/recent-changes]]`. You should use that rather than write the site's full URL because it may change in the future. -### Link colors +=== Link colors Links come in several colors. Blue links are links to //existing// resources, while red links are links to //non-existent// resources. All external links are considered existing, therefore they are blue. Internal hypha links are always checked for existence. Note that visited blue links are colored purple but are still called blue links. Moreover, blue links are yellow in the default dark theme. -## Heading +== Heading There are four levels of **headings**. They consist of some equal signs followed by a space and the heading itself. You can format the heading like a paragraph. Feel free to start with `= level 1`, because it actually translates into HTML's `