Differences

This shows you the differences between two versions of the page.

--- en:contribute [2024/02/19 19:44] – created Richardn
+++ en:contribute [2024/03/22 12:51] (current) – Richardn
@@ Line 1: / Line 1: @@
-===== Contributing to This Wiki =====
+====== Contributing to This Wiki ======
-==== Edit Rights ====
+===== Edit Rights =====
 Logged in users have edit rights to almost all pages. Currently, an account can be automatically registered by logging in with Discord.
@@ Line 7: / Line 7: @@
 > and Discord only. Sorry for the dependency, but this is an easy way to fight off some spam, and most of us are on Discord anyways.
-==== Copyrights =====
+===== Copyrights ======
 By contributing to here, you thereby license content you provided to the public for reuse under CC BY-NC-SA, with license details linked down below.
-==== Translation ====
+===== Creating Pages =====
+Though you are strongly suggested to check [[doku>page]] first, TL;DR is, in Dokuwiki, any link ''<base_url>/what-ever-page'' is a "valid" wiki page, even if no one has ever created it. By navigating to that link, you will be provided instructions on how to create that page.
+However, this is usually NOT the way one should create a page, because a page created this way, on creation, will be only accessible from the sitemap or the exact link, which will not be accessed by most users, effectively creating an "orphaned" page.
+Now that every link is "valid", populated at least by the instructions to create a page represented by the link, the proper way to create a page is simply, in an already existing page, put a link to the to-be-created page, like ''<nowiki>[[nonexistent|this]]</nowiki>'' [[nonexistent|this]]. Then one can follow the link and proceed to create the page.
+===== Namespaces =====
+Similar to filesystems where files are organized by ''path/to/file'', in Dokuwiki we represent such hierarchical structure by [[doku>namespaces]]. ''<base_url>/namespace1:namespace2:page'', that's it. And for this example, the "current" namespace for ''page'' is ''namespace2''.
+The nicest thing about namespaces is that, a link to a page created within a page, is by default resolved relative to the current namespace. ''<nowiki>[[link|page]]</nowiki>'' in ''<base_url>/ns1:ns2:blah'' is referring to ''<base_url>/ns1:ns2:link''. That way, within a namespace one can freely create links to future pages, without worrying about conflicting with other pages in other namespaces.
+Following Dokiwiki conventions, we use ''namespace:start'' as the first and indexing page for ''namespace''.
+Normally you will not be needing to create new namespaces. In many cases a new page under the current namespace, instead of a new namespace with the content put into the start page of the new namespace, is a better idea. You are welcome to consult the admins before creating namespaces. And even if you decide on yourself that you want to create a namespace, this won't cause too much problems even if you did it wrongly, as admins have nice tools to move pages and rebuild indexes :).
+===== Translation =====
 On any page with a sidebar, by selecting a language with the drop-down, you will be navigated to the same page, but in the target language. If the page appears to not exist, that means you are the first translator of that page in that language. Simply create the page following the instructions shown. On creation, your editor will be populated with the English version of the page.
@@ Line 17: / Line 35: @@
 If you cannot find a language in the drop-down, that means the language is not yet enabled. Join the Discord server and express your intent to begin translation into a new language, and admins will set things up.
-==== Misc ====
+Experimental translation status tracker [[:translationbuddy|here]].
+==== Internals ====
+If you are smart enough, you may realize by now that the translation framework is basically powered by the namespace system. Under the root namespace are namespaces representing different languages, named by ISO language codes. As everything is relative, within a language namespace everything is nicely linked together, and switching language is simply done by switching the language namespace at the very front of the page link.
+==== Sidebar ====
+If you are the first translator of a language, you <del>may</del> will notice that the sidebar on the pages in your language is missing. This brings an exception to the page creation convention: You should be entering ''<base_url>/<language code>:sidebar'' in your browser and create the sidebar. (For updating existing sidebar, also navigate to the sidebar in this way.) Use the default English [[:en:sidebar|sidebar]] as a reference.
+Due to some weird translation plugin internals, links to wiki pages on the sidebar should start with a ''.'', to ensure correct linking to the page in your language. ''<nowiki>[[contribute]]</nowiki>'' will lead to ''<base_url>/contribute'' (which is non-existent, as it is under root, instead of a language namespace), while ''<nowiki>[[.contribute]]</nowiki>'' will do the trick.
+===== Misc =====
 You can find the Dokuwiki syntax manual in the sidebar.
+==== Icons ====
+Most icons appearing in Inochi2D software are Google's [[https://github.com/google/material-design-icons|Material Icons]]. This wiki has the original [[https://materialdesignicons.com|Material Design Icons]] installed. Use this table for reference if you want to use some icons during wiki writing.
+^  Icon  ^  Meaning  ^  Syntax  ^  Codepoint (Google)  ^
+|  {{icon>lock}}  |  Lock  |  <nowiki>{{icon>lock}}</nowiki>  |  ''E897''  |
+|  {{icon>lock-open}}  |  Unlock  |  <nowiki>{{icon>lock-open}}</nowiki>  |  ''E898''  |
+|  {{icon>file-tree}}  |  Node  |  <nowiki>{{icon>file-tree}}</nowiki>  |  ''E97A''  |
+|  {{icon>palette}}  |  Part  |  <nowiki>{{icon>palette}}</nowiki>  |  ''E40A''  |
+|  {{icon>folder-multiple-image}}  |  Composite  |  <nowiki>{{icon>folder-multiple-image}}</nowiki>  |  ''E3B6''  |
+|  {{icon>content-cut}}  |  Mask  |  <nowiki>{{icon>content-cut}}</nowiki>  |  ''E14E''  |
+|  {{icon>chart-timeline-variant}}  |  SimplePhysics  |  <nowiki>{{icon>chart-timeline-variant}}</nowiki>  |  ''E922''  |
+|  {{icon>video}}  |  Camera  |  <nowiki>{{icon>video}}</nowiki>  |  ''E04B''  |
+|  {{icon>billiards-rack}}  |  Meshgroup  |  <nowiki>{{icon>billiards-rack}}</nowiki>  |  ''E886''  |
+|  {{icon>white-balance-sunny}}  |  Enable Post-processing  |  <nowiki>{{icon>white-balance-sunny}}</nowiki>  |  ''E430''  |
+|  {{icon>sync-alert}}  |  Reset Physics  |  <nowiki>{{icon>sync-alert}}</nowiki>  |  ''E629''  |
+|  {{icon>flip-horizontal}}  |  Flip Pairing  |  <nowiki>{{icon>flip-horizontal}}</nowiki>  |  ''E3E8''  |
+|  {{icon>cached}}  |  Reset Parameters  |  <nowiki>{{icon>cached}}</nowiki>  |  ''E86A''  |
+|  {{icon>pencil}}  |  Edit Puppet  |  <nowiki>{{icon>pencil}}</nowiki>  |  ''F097''  |
+|  {{icon>transition}}  |  Edit Animation  |  <nowiki>{{icon>transition}}</nowiki>  |  ''E71C''  |
+|  {{icon>cube-scan}}  |  Gizmos  |  <nowiki>{{icon>cube-scan}}</nowiki>  |  ''E9FE''  |
+|  {{icon>scatter-plot}}  |  Vertices  |  <nowiki>{{icon>scatter-plot}}</nowiki>  |  ''E268''  |
+|  {{icon>crop-square}}  |  Bounds  |  <nowiki>{{icon>crop-square}}</nowiki>  |  ''E3C1''  |
+|  {{icon>delete-outline}}  |  Delete  |  <nowiki>{{icon>delete-outline}}</nowiki>  |  ''E92E''  |
+|  {{icon>stop}}  |  Stop  |  <nowiki>{{icon>stop}}</nowiki>  |  ''E047''  |
+|  {{icon>play}}  |  Play  |  <nowiki>{{icon>play}}</nowiki>  |  ''E037''  |
+|  {{icon>pause}}  |  Pause  |  <nowiki>{{icon>pause}}</nowiki>  |  ''E034''  |
+|  {{icon>refresh}}  |  Reset Viewport  |  <nowiki>{{icon>refresh}}</nowiki>  |  ''E5D5''  |

Unofficial Inochi2D Wiki

User Tools

Site Tools

Differences

Page Tools