Show online document using Google Docs Viewer Service or browser Plug-In
Compatible with DokuWiki
Adora Belle, Weatherwax, Binky, 2014-05-05 "Ponder Stibbons", 2016-06-26
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
This plugin uses and depends on Google's Service. Please check and see first the Google Docs Viewer Terms of Service.
By using this service you acknowledge that you have read and agreed to the Google Docs Viewer Terms of Service. — Google Docs Viewer - Additional Terms of Service
Search and install the plugin using the Extension Manager. Refer to plugin installation instructions on how to install plugins manually.
If your have set userewrite option to “1
” in order to get nicer URLs for your DW page, you do not need to do any more. The Google Docs Viewer Service will accept url of DW media document file ( for example: http://example.com/_media/ns:document.pdf ).
Otherwise, you need to prepare a virtual (sub)directory named “_media” in the same place where 'doku.php' file exists. You might setup it by one of following measures:
Show a given online document such as PDF documents or PowerPoint presentations in your DokuWiki page using Google Docs Viewer service. Please refer to Google site to know detail on supported file types.
Let's suppose you have a link (with small fileicon) to given online document in your page source:
{{:ns:document.pdf}}
To show the document in the embedded viewer, change it as follows:
{{gview>:ns:document.pdf}}
Some more complex example:
{{gview 50%,200px > :ns:document.pdf}} {{gview 400px> :ns:document.pdf|title}} {{gview noreference> http://example.com/path/to/document.pdf|title }}
{{gview [size] [noembed] [noreference] > id|title }}
100%,300px
, which means 100% width and 300px height.{{
and }}
is used as a link text.There is another experimental trick syntax available. The markup key is “obj:” instead of “gview”.
{{obj:[class] [size] [noembed] [noreference] > id|title }}
which will embed media resource in html using HTML5 object tag. If you do not like to use google service, please try this usage. The {{gview ... > ... }}
is simplified markup of {{obj:gview ... > ... }}
.
There are no configuration options for this plugin.
The class obj_container_gview is available for selector of html element. Border settings for embedded viewer found in style.css.
en, ja, de
This is first trial to develop my own plugin.
I have just started github.
{{gview [size] [noembedded] [noreference] > id|title }}
in order to quickly get back to genuine DW syntax ({{id|title}
) by text replacement of .txt file using sed command via terminal shell. → done at releaee 2013-05-26[discussions should ideally be deleted and turned into FAQ entries along the way]
Great plugin! It would be good to be able to support the likes of the BOX viewer (HTML5). As it stands the correct height can be adjusted, but the width stays locked to 100%, even when changed to something else, i.e:
{{obj: 50%, 600px noreference > https://view-api.box.com/1/sessions/7b8e51cb284a407ba5bec7a7fa2ba1b2/view?theme=light |Test}}
The viewer works correctly though, it is just the width adjustment.
Thanks for this plugin!
It would be great, to view pdf documents stored in DW media directory. Joe, 2013-03-20
Thanks for your comment. It was my original objectives of this plugin. New release 2013-03-22 supports DW media docs with some prerequisite. I have tested CentOS6-Apache 2-Adora Belle and Win2003S-IIS6-Weatherwax RC1. — s.sahara 2013-03-22
I actually have my DW site protected by .htaccess, which prevents gview from displaying the files.
If I rename .htaccess everything works fine.
Do you have some hints how to modify .htaccess for using with gview? This would be great.
I tried a lot of hints from the web, but nothing worked. e.g.:
RewriteEngine on RewriteCond %{HTTP_REFERER} !^http(s)?://(www\.)?yourdomain.com [NC] RewriteCond %{HTTP_REFERER} !^http(s)?://(www\.)?docs.google.com [NC] RewriteRule \.(pdf)$ - [NC,F,L]
Working under debian linux with ln -s /path/to/data/media _media
Joe, 2013-09-02