Table of Contents

How to Export Google Docs to Dokuwiki

ُThis document explains solutions for exporting content from Google Docs to Dokuwiki pages.

<html><span class='marketingParagraph'></html>This document is intended for the bSup development team. If you are interested in Wiki solutions, please contact us through the Web Application Services page. For Google Docs solutions, please feel free to contact us through the G Suite Services page.<html></span></html>

Step 1 - Convert Google Docs Text to Dokuwiki Markup Language

DokuWiki supports some simple markup language. First, Google Docs content should be converted to Dokuwiki language. Different solutions can be used for conversion. We suggest using Docs to Markdown Addon to convert Google Docs to Markdown language. Then use Pandoc to convert Markdown to Dokuwiki Markup thru command-lines, for example

<html><span class='codeline'></html>pandoc googledocs.md -f markdown -t dokuwiki -s -o dokuwiki.txt<html></span></html>

Step 2 - Special Characters

Some characters in Google Docs may need some special treatment. For example, quotation marks in Google Docs seem a little bit different from regular quotation marks. The unicode value of a single regular quotation mark is 00039. But the unicode value of a single (left) quotation mark in Google Docs is 08216. In this step, convert some characters, if necessary.

Step 3 - Commit Files to Dokuwiki

Pandoc generates a text file which, in this step, is committed to Dokuwiki, as follow

  1. Put the file populated by Pandoc in the dokuwiki root folder > data > tmp folder.
  2. Connect to SSH and change the directory to the root directory of Dokuwiki.
  3. Run the commit command, <html><span class='codeline'></html>php bin/dwpage.php commit -m “some-comment” data/tmp/source-file.txt destination-namespace:destination-page<html></span></html>. For more information about committing, please refer to the Dokuwiki CLI. The above command line consists of
    1. php : php command
    2. bin/dwpage.php : the path to dwpage.php
    3. -m “some-comment” : committing a page requires a comment. Use -m to set a comment
    4. data/tmp/source-file.txt : the path to the text file generated by Pandoc.
    5. destination-namespace:destination-page : the address of the page which is populated by the text file.

Why commit files? You can directly use FTP to replace the pages in Dokuwiki. Dokuwiki pages are simply .txt files and they can easily be replaced. However, by replacing the txt files, the revision history of pages may be lost. Committing files by bin/dwpage.php updates the revision history.