Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
en:wiki:newcomer [2024-09-02 16:29] – [5. Practice with DokuWiki formatting] Anatoly Belaychuken:wiki:newcomer [2024-09-02 21:07] (current) – Anatoly Belaychuk
Line 7: Line 7:
 ===== 1. Start liking ===== ===== 1. Start liking =====
  
-Please note a prompt "Was this page helpful?" at the top of (almost) every page.+Please note a prompt ''Was this page helpful?'' at the top of (almost) every page.
 Press like or dislike icon and the counter will change. Press like or dislike icon and the counter will change.
 This will help authors better understand the value of their content. This will help authors better understand the value of their content.
-The sidebar on the left displays the "Top-10" - the ten pages with the highest rating.+The sidebar on the left displays the ''Top-10'' - the ten pages with the highest rating.
  
 You don't need to register to like/dislike a page. You don't need to register to like/dislike a page.
Line 23: Line 23:
 This step is optional but your content will get more attention if you introduced yourself to the community. This step is optional but your content will get more attention if you introduced yourself to the community.
  
-Find "Home Page" in the drop-down menu in the upper right corner.+Find the ''Home Page'' in the drop-down menu in the upper right corner.
 Click the link to create a page. Click the link to create a page.
  
-The home page is where you can introduce yourself.+The home page is the place to introduce yourself.
 Information about experience and achievements is most welcome. Information about experience and achievements is most welcome.
  
 ===== 4. Upload avatar ===== ===== 4. Upload avatar =====
  
-If you want your avatar to appear in comments, upload a file named //username//.jpg or //username//.png to your personal space (user///username//).+If you want your avatar to appear in comments, upload a file named ''//username//.jpg'' or ''//username//.png'' to your personal space (''user///username//'').
  
 ===== 5. Practice with DokuWiki formatting ===== ===== 5. Practice with DokuWiki formatting =====
Line 39: Line 39:
  
   * [[en:wiki:syntax]]   * [[en:wiki:syntax]]
-  * [[en:wiki:good_style]]+  * [[doku>tips:good_style|Hints on good style]]
  
 Probably the shortest way to learn formatting language is to find a page that implements what you need, copy & paste the source code. Probably the shortest way to learn formatting language is to find a page that implements what you need, copy & paste the source code.
  
-Use your home page as a sandbox, or (better) create a page under your home page: user///username/somepage//. +Use your home page as a sandbox, or (better) create a page under your home page, e.g. ''user///username///playground''.
- +
-:!: Note that the content of your home page will be visible to other (registered) users. Subpages are visible only to you.+
  
 ===== 6. Start commenting ===== ===== 6. Start commenting =====
Line 51: Line 49:
 Found a typo? Need explanations? Want to discuss? Found a typo? Need explanations? Want to discuss?
  
-Scroll to the bottom of the page to the "Discussion" section and leave a comment.+Scroll to the bottom of the page to the ''Discussion'' section and make a comment.
  
   * you can use all markup features ​​in comments, including drawing BPMN diagrams   * you can use all markup features ​​in comments, including drawing BPMN diagrams
Line 58: Line 56:
 ===== 7. Start suggesting edits ===== ===== 7. Start suggesting edits =====
  
-If you are able to improve an existing page, find the "Edit this page" button and go ahead!+If you are able to improve an existing page, find the ''Edit this page'' button and go ahead!
  
 Don't be afraid to screw something up - previous versions of the page are stored anyway. Don't be afraid to screw something up - previous versions of the page are stored anyway.
Line 69: Line 67:
 You can create a new page in three ways: You can create a new page in three ways:
  
-  * Use the "Page Tools" button in the top menu. Select the namespace from the drop-down list and enter the name of the page.+  * Use the ''Page Tools'' button in the top menu. Select the namespace from the drop-down list and enter the name of the page.
   * Enter the address of a non-existent page in the command line.   * Enter the address of a non-existent page in the command line.
   * Create a link on an existing page. Save the page and follow the link to create the new page. This method is preferable because not only a new page is created, but it's linked to existing content.   * Create a link on an existing page. Save the page and follow the link to create the new page. This method is preferable because not only a new page is created, but it's linked to existing content.
Line 75: Line 73:
 Usually, a website displays error messages when you enter the address of a non-existent page. Usually, a website displays error messages when you enter the address of a non-existent page.
 Wiki sites are different - they consider this isn't an error but a (yet) unwritten page, and invite you to create it. Wiki sites are different - they consider this isn't an error but a (yet) unwritten page, and invite you to create it.
-Find the "Create this page" button in the menu on the right and start editing.+Find the ''Create this page'' button in the menu on the right and start editing.
  
 When created, the page obtains headings structure from the template - preserve them for pages of the same type to have the same structure. When created, the page obtains headings structure from the template - preserve them for pages of the same type to have the same structure.
  
-To translate a page into another language, use the "Translate]ions of this page" drop-down menu at the top.+To translate a page into another language, use the ''Translate]ions of this page'' drop-down menu at the top.