Differences

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

--- wiki:shortsyntax [2024/10/24 09:31] – hqi-admin
+++ wiki:shortsyntax [2024/10/25 08:51] (current) – teacher
@@ Line 1: / Line 1: @@
-====== Wiki Quick Guide ======
+====== Wiki Guide ======
+First of all: if you want to add or edit articles you will have to be logged into the wiki. If you don't have the credentials do contact the tutors of the the workshop.
 ===== How to Make A New Article? =====
 To make a new Article you have 2 options:
   - Go to your URL-bar and add the ''Title'' for your article like this ''ekawiki2.yesss.fun/doku.php/wiki:__Your-Title-Here__''
-  - Create a link to a non-existing article in an existing entry (for example in the [[wiki:toc|Table of Contents]] and then click it.
+  - Create a link to a non-existing article in an existing entry (for example in the [[wiki:toc#user|Table of Contents]] and then click it.
@@ Line 15: / Line 18: @@
 So if you click this then you can start editing your new article.
-===== How to Format An Article? =====
+===== How to Edit An Existing Article? =====
+If you want to edit an existing article you can find it by using the search bar or whatever link you used for it in your URL-bar.
+Then you have two options. You can either edit a section of the article by clicking thislittle button:
+{{:wiki:images:tutorial:ekawiki-edit-section.png?nolink&800|}}
+or you can edit the entire article by clicking the the little document icon you find here:
+{{:wiki:images:tutorial:ekawiki-edit-article.png?nolink&800|}}
+===== How to Format Your Article? =====
 For a complete guide on how to create / edit an article please consult the [[https://www.dokuwiki.org/manual#using_dokuwiki|Doku Wiki Manual Section 3. Using Doku Wiki]].
@@ Line 22: / Line 35: @@
 ==== Simple Article Editing ====
-First of all – whether you edit an existing article or have created a new one – you will probably be confronted with with this text editing interface:
+Whether you edit an existing article or have created a new one – you will probably be confronted with with this text editing interface:
 {{:wiki:images:tutorial:ekawiki-emptypage-view.png?nolink&800|}}
 which is mostly pretty self explanatory.
@@ Line 31: / Line 45: @@
 [[https://www.dokuwiki.org/syntax|And Here]] you can find a detailed explanation of all the syntax to style your text, create headlines, link images, add links and so on.
+=== Adding Text Styling ===
+These buttons:
+{{:wiki:images:tutorial:ekawiki-text-styling.png?nolink&600|}}
+are for text styling there are some more options available that you can see in the [[wiki:syntax|syntax sheet]].
+These buttons:
+{{:wiki:images:tutorial:eka-wiki-headline-styling.png?nolink&600|}}
+are there to insert headlines. They are especially important because your headlines are defining the sections of your article and give it structure! You can use the buttons to create headlines and sub-headlines.
+Little description from left to right:
+  - Create headline on the same level as the one before.
+  - Create headline one level down from the one before.
+  - Create headline one level up from the one before.
+  - Gives you a dropdown menu to chose with level of headline you want to use with ''H1'' being the highest and ''H5'' being the lowest level.
+=== Uploading Media ===
+First of all – a list of all currently allowed file extensions:
+''jpg, jpeg, gif, png, webp, ico, mp3, ogg, wav, webm, ogv, mp4, vtt, tgz, tar, gz, bz2, zip, rar, 7z, pdf, ps, rpm, deb, doc, xls, ppt, rtf, docx, xlsx, pptx, sxw, sxc, sxi, sxd, odc, odf, odg, odi, odp, ods, odt, svg''
+Uploading and embedding media is quite easy. All you have to do is to click this button:
+{{:wiki:images:tutorial:eka-wiki-image-button.png?nolink&600|}}
+and the ''Media Files Window'' will open:
+{{:wiki:images:tutorial:eka-wiki-file-upload.png?nolink&800|}}
+where you can upload all of the media-types specified above.
+If you want to upload a file into a specific subfolder you can create this by doing the following:
+  * Navigate to the folder you want to upload into through the Media Files Side bar:
+{{:wiki:images:tutorial:eka-wiki-sidebar.png?nolink&600|}}
+(You can use the little plus symbol to see the subfolders inside the directory.)
+  * You can see which folder you are currently in here:
+{{:wiki:images:tutorial:eka-wiki-file-pathview.png?nolink&600|}}
+  * To create a new folder in the one you are currently in you can do this by putting '':MyFolder:'' before the filename after selecting your file (see example below).
+{{:wiki:images:tutorial:eka-wiki-file-newnamespace.png?nolink&600|}}
+(Please note that you might have to close and reopen the ''Media Files Window'' for your subfolder to show up properly!)
+This tutorial will be updated on a rolling basis. If you have any more questions feel free to drop by the GD MA Studio and ask a question.
+== Adding a caption to your images ==
+If you want to add a cation to your images and have it displayed together in a nice box (like on the real wikipedia) you can do so in the following way:
+If this is your normal way to embed an image: ''<nowiki>{{:wiki:images:tutorial:YourImageFileName.png?nolink&300}}</nowiki>'' \\
+you can just add this bracket ''['' before and this '']'' after the image link. To then add a caption you can just put a pipe character ''|'' after the link and add your caption after that.
+After that total your link should now look something like this: \\
+''<nowiki>[{{:wiki:images:tutorial:YourImageFileName.png?nolink&300|Example image produced for demonstration purposes}}]</nowiki>''.
+This should result in some thing like this:
+[{{:wiki:images:tutorial:YourImageFileName.png?nolink&300|Example image produced for demonstration purposes}}]
+===== Add Article To The Sidebar =====
+If you want add an article to the sidebar just click the [[:sidebar?do=edit|Edit Sidebar]] link here or in the sidebar itself. If you go to edit the ''Sidebar Article'' you can just add a link to your Article there and it should show up.