Differences

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

Link to this comparison view

Next revision		Previous revision
playground:howto [2025/11/15 07:05] – Imported from DOCX rahulplayground:howto [2025/11/15 07:36] (current) – rahul
Line 1: Line 1:
 +====== HOWTO ======
 +
 A user-friendly guide to adding and editing content on the IEEE Smart Village DokuWiki. A user-friendly guide to adding and editing content on the IEEE Smart Village DokuWiki.
 +
 +{{pdfjs 800,600>:playground:howto.pdf|?page-width}}
  
 ==== Getting Started: Creating a New Page ==== ==== Getting Started: Creating a New Page ====
Line 19: Line 23:
 **Bold and Italic**: **Bold and Italic**:
  
-For **bold** text, wrap it in double asterisks: **text**+For **bold** text, wrap it in double asterisks: ''%%**text**%%''
  
-For //italic// text, wrap it in double slashes: //text//+For //italic// text, wrap it in double slashes: ''%%//text//%%''
  
-For **underlined** text, wrap it in double underscores: __text__+For **underlined** text, wrap it in double underscores: ''%%__text__%%''
  
 **Headlines**: Use the equals sign = to create headlines. More equals signs create smaller headlines. **Headlines**: Use the equals sign = to create headlines. More equals signs create smaller headlines.
 +<code>
 ====== Large Heading ======  ====== Large Heading ====== 
  
Line 32: Line 36:
  
 ==== Small Heading ==== ==== Small Heading ====
 +</code>
  
 **Lists**: **Lists**:
Line 43: Line 48:
 **Internal Links**: To link to another page within the wiki, use double square brackets. **Internal Links**: To link to another page within the wiki, use double square brackets.
  
-[[page_name]] will create a link to "page_name".+''%%[[page_name]]%%'' will create a link to "page_name".
  
-[[page_name|link text]] will create a link to "page_name" with the text "link text".+''%%[[page_name|link text]]%%'' will create a link to "page_name" with the text "link text".
  
 **External Links**: To link to an external website, simply paste the full URL. **External Links**: To link to an external website, simply paste the full URL.
  
-http://www.example.com will create a link to that URL.+''%%http://www.example.com%%'' will create a link to that URL.
  
-[[http://www.example.com|link text]] will create a link with custom text.+''%%[[http://www.example.com|link text]]%%'' will create a link with custom text.
  
 ==== Adding Images ==== ==== Adding Images ====
Line 59: Line 64:
 **Embed the image**: To embed an image into a page, use double curly braces. **Embed the image**: To embed an image into a page, use double curly braces.
  
-{{image.jpg}}+''%%{{image.jpg}}%%''
  
 ==== Saving Your Work ==== ==== Saving Your Work ====
  
 Once you are finished editing, you will see a "Save" button. Click this to save your changes. It's a good practice to also use the "Preview" button to see how your changes will look before saving. Once you are finished editing, you will see a "Save" button. Click this to save your changes. It's a good practice to also use the "Preview" button to see how your changes will look before saving.
 +
 +Here is a guide on how to embed PDFs and import content from Microsoft Word files into your DokuWiki pages.
 +
 +==== Embedding PDF Files ====
 +
 +While DokuWiki doesn't natively display PDFs directly on the page, you can link to them. A common way to embed a PDF is by using the pdfjs plugin, which displays the PDF in a viewer within the wiki page.
 +
 +**Upload the PDF**: First, use the "Media Manager" to upload your PDF file to the wiki.
 +
 +**Embed the File**: To embed the uploaded PDF, insert the following syntax into your page, replacing your_file.pdf with the name of your uploaded file: ''%%{{pdfjs>your_file.pdf}}%%''
 +
 +This will display the PDF with a default width of 100% and a height of 300px.
 +
 +**Customizing the Viewer Size**
 +
 +You can customize the height and width of the PDF viewer.
 +
 +To set only the height (e.g., to 500 pixels): ''%%{{pdfjs>your_file.pdf|500}}%%''
 +
 +To set both width and height (e.g., 800 pixels wide by 600 pixels high): ''%%{{pdfjs>your_file.pdf|800,600}}%%''
 +
 +==== Adding Content from Microsoft Word ====
 +
 +When dealing with content from .docx files, especially troublesome ones, you can use the "Paste from Word" feature available in the CKEditor.
 +
 +**Using the "Paste from Word" Button**
 +
 +**Copy from Word**: Select and copy the content from your Microsoft Word document.
 +
 +**Click in the Editor**: In the DokuWiki editor, you must first click inside the text window where you want the content to go.
 +
 +**Paste from Word**: Locate the "Paste from Word" button on the far right of the CKEditor toolbar and click it. This will open a dialog box.
 +
 +**Paste and Insert**: Paste your content into the text window of the dialog box and click "OK."
 +
 +**Limitations and Tips**
 +
 +Be aware of the following limitations when pasting from Word:
 +
 +**Basic Lists Only**: The tool currently has basic support for lists.
 +
 +Only one list can be inserted at a time.
 +
 +Nested (multi-level) lists are not supported.
 +
 +**Cleaning Complex Lists**: For complex lists, it is best to paste them directly into the main CKEditor window first. Then, select the pasted list with your mouse and open the "Paste from Word" dialog. The list will load into the text window, and clicking "OK" will clean up the formatting for DokuWiki.
 +
 +**Precise Selections**: For both lists and tables, try to make your selection as exact as possible in the Word document before copying.