Site Tools


en:contribute

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
en:contribute [2024/02/20 00:11] – Namespaces explanation. Richardnen:contribute [2024/03/22 12:51] (current) Richardn
Line 23: Line 23:
 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''. 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. ''[[link|page]]'' 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.+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''. Following Dokiwiki conventions, we use ''namespace:start'' as the first and indexing page for ''namespace''.
Line 34: Line 34:
  
 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. 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.
 +
 +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 ===== ===== Misc =====
  
 You can find the Dokuwiki syntax manual in the sidebar. 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''  |
en/contribute.1708405887.txt.gz · Last modified: 2024/02/20 00:11 by Richardn