HOWTO

A user-friendly guide to adding and editing content on the IEEE Smart Village DokuWiki.

]]

</code>

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.

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.