plugin:bookcreator
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
plugin:bookcreator [2018-06-18 10:14] – dds00hs | plugin:bookcreator [2024-02-08 00:14] (current) – Klap-in | ||
---|---|---|---|
Line 6: | Line 6: | ||
email : klapinklapin@gmail.com # previous: l.micco@tiscali.it | email : klapinklapin@gmail.com # previous: l.micco@tiscali.it | ||
type : action, syntax | type : action, syntax | ||
- | lastupdate : 2016-08-11 | + | lastupdate : 2024-02-07 |
- | compatible : Hrun, Ponder Stibbons, Detritus, | + | compatible : Elenor Of Tsort, Frusterick Manners, Greebo, Hogfather, Igor, Jack Jackrum, Kaos |
depends | depends | ||
conflicts | conflicts | ||
similar | similar | ||
- | tags : export, pdf, books | + | tags : export, pdf, odt, books |
- | screenshot_img : http:// | + | |
securitywarning: | securitywarning: | ||
Line 20: | Line 19: | ||
sourcerepo : https:// | sourcerepo : https:// | ||
donationurl: | donationurl: | ||
+ | |||
+ | screenshot_img : https:// | ||
---- | ---- | ||
- | |||
- | :!: In August 2016 this plugin is updated. It is now using browsers localStorage for storing the page selection. However the page selection is now performed via javascript, which is not backward compatible (yet..). | ||
- | A previous version is: [[https:// | ||
===== Description ===== | ===== Description ===== | ||
- | The **bookcreator** plugin allows the user to select some pages from a wiki and then export them to create a little PDF book or text (like a similar [[wp> | + | |
+ | The **bookcreator** plugin allows the user to select some pages from a wiki and then export them to create a little PDF book or text (like a similar [[wp> | ||
First you initialize a book by clicking an interface button. Nextly, a toolbar at the top of the pages appear to add/remove more pages to the book. Also you can jump to the bookmanager (at a preconfigured page) that let you sort and finish the selections for your book, and export it to screen(html) and when the required plugins are installed: to pdf-file, odt-file or text on screen. | First you initialize a book by clicking an interface button. Nextly, a toolbar at the top of the pages appear to add/remove more pages to the book. Also you can jump to the bookmanager (at a preconfigured page) that let you sort and finish the selections for your book, and export it to screen(html) and when the required plugins are installed: to pdf-file, odt-file or text on screen. | ||
The bookmanager let you save and load saved selections for later use. You can use drag and drop to change the order and move pages in and out. | The bookmanager let you save and load saved selections for later use. You can use drag and drop to change the order and move pages in and out. | ||
- | | + | |
- | To work the PDF export required [[plugin: | + | The bookcreator supports the following export formats, if you install respectively plugin: |
+ | * To work the PDF export required [[plugin: | ||
+ | * the ODT export required [[plugin: | ||
+ | * the Text export required the [[plugin: | ||
===== Usage ===== | ===== Usage ===== | ||
Line 41: | Line 43: | ||
| | ||
In the bookmanager can show and manage your list of selected pages | In the bookmanager can show and manage your list of selected pages | ||
- | | + | |
- | * Exclude/ | + | * Exclude/ |
- | * View the excluded pages and " | + | * View the excluded pages and " |
- | * Drag and drop to change exporting order of page and remove/add page to the selection. | + | * Drag and drop to change exporting order of page and remove/add page to the selection. |
- | * Set a title for the PDF document | + | * Set a title for the PDF document |
- | * Create the PDF book on selected pages | + | * Create the PDF book on selected pages |
- | * Create a printable version of selected pages | + | * Create a printable version of selected pages |
- | * Extract only text of selected pages | + | * Extract only text of selected pages |
- | * Save and restore selections on a specific namespace (use ACL's rights) | + | * Save and restore selections on a specific namespace (use ACL's rights) |
== Example == | == Example == | ||
Line 58: | Line 60: | ||
</ | </ | ||
And __after__ you mark at least one page for inclusion in the book, the bookmanager appears. | And __after__ you mark at least one page for inclusion in the book, the bookmanager appears. | ||
- | {{http://img37.imageshack.us/img37/2496/bookcreatorbookmanager.png?500}} | + | {{https://trello.com/ |
==== Initiate a book==== | ==== Initiate a book==== | ||
- | {{ http://img17.imageshack.us/img17/9830/bookcreatorpagetoolsadd.png?150}} | + | {{ https://trello.com/ |
Use the // | Use the // | ||
After selecting the first page, a toolbar appears on every page that let you add or remove additional pages. This toolbar refers also to the book manage tool. | After selecting the first page, a toolbar appears on every page that let you add or remove additional pages. This toolbar refers also to the book manage tool. | ||
- | {{http://img703.imageshack.us/img703/9973/bookcreatortoolbar.png?500}} | + | {{https://trello.com/ |
The book manage tool that you created above (default on '' | The book manage tool that you created above (default on '' | ||
Line 74: | Line 76: | ||
Below the bookmanager is a listed displayed with saved selections. You can also display with ''< | Below the bookmanager is a listed displayed with saved selections. You can also display with ''< | ||
- | | + | |
- | * Optionally you can specify the number of selections to display and the order: | + | * Optionally you can specify the number of selections to display and the order: |
- | * '' | + | * '' |
- | * '' | + | * '' |
- | * a //number// limits the number of displayed selections | + | * a //number// limits the number of displayed selections |
Default is 10 items ordered by date (last updated are sorted first). Each entry links also to the wiki page where their selection is saved. Per page only one list of saved selections is displayed. | Default is 10 items ordered by date (last updated are sorted first). Each entry links also to the wiki page where their selection is saved. Per page only one list of saved selections is displayed. | ||
Line 85: | Line 87: | ||
== Example == | == Example == | ||
+ | |||
+ | {{ https:// | ||
Lists 5 selections, sorted by date | Lists 5 selections, sorted by date | ||
< | < | ||
~~ARCHIVEBOOK: | ~~ARCHIVEBOOK: | ||
</ | </ | ||
- | {{http://img59.imageshack.us/img59/ | + | |
+ | ==== Direct export a saved selection ==== | ||
+ | |||
+ | To create a link, which initiates an export to respectively pdf, text, html or odt-file, you can use: | ||
+ | (FIXME: ODT format have to receive the update yet, little patience please) | ||
+ | < | ||
+ | ~~EXPORTPDF: | ||
+ | ~~EXPORTTEXT: | ||
+ | ~~EXPORTHTML: | ||
+ | ~~EXPORTODT: | ||
+ | </code> | ||
+ | |||
+ | To change link title shown in wiki page: | ||
+ | < | ||
+ | |||
+ | Add url parameters to export url: | ||
+ | < | ||
+ | ~~EXPORTPDF: | ||
===== Installation ===== | ===== Installation ===== | ||
- | Since the August 2016 update | + | Search and install |
==== ' | ==== ' | ||
- | When you are using the newest | + | When you are using the default template of DokuWiki, the " |
==== other templates ==== | ==== other templates ==== | ||
+ | |||
Other templates will probably not be supported that good yet. Please request at the issue tracker. | Other templates will probably not be supported that good yet. Please request at the issue tracker. | ||
- | |||
- | |||
===== Changing the order of wiki pages ===== | ===== Changing the order of wiki pages ===== | ||
Line 119: | Line 139: | ||
* [[: | * [[: | ||
- | You can also manually create a book from scratch by using the same format. | + | You can also manually create a book from scratch by using the same format. |
- | * Take care of prefixing of links by '':'' | + | * Take care of prefixing of links by '':'' |
* To create a book from scratch, start a new page such as // | * To create a book from scratch, start a new page such as // | ||
- | =====Configuration===== | + | ===== Configuration ===== |
Available configuration options. | Available configuration options. | ||
^Name | ^Name | ||
Line 131: | Line 152: | ||
|save_namespace |Namespace where the book manager will save selections. | |save_namespace |Namespace where the book manager will save selections. | ||
|skip_ids | |skip_ids | ||
+ | |||
+ | ==== Modifying the generated file ==== | ||
+ | |||
+ | If you like to configure/ | ||
===== Version history ===== | ===== Version history ===== | ||
Line 138: | Line 163: | ||
{{rss> | {{rss> | ||
- | In August 2016 the plugin uses browsers localStorage in stead of cookies. Selection is now using javascript, which is not backward compatible with ''? | ||
- | | ||
This plugin was the former Pdfbook Plugin. | This plugin was the former Pdfbook Plugin. | ||
- | =====Bug reports and feature requests===== | + | ===== Bug reports and feature requests ===== |
Please refer to the [[https:// | Please refer to the [[https:// | ||
Line 148: | Line 171: | ||
===== FAQ ===== | ===== FAQ ===== | ||
- | * This plugin is almost what I am looking for. Is there a way to add a title page / cover page? (I am using it with dw2pdf to also include a table of contents. I'd be fine with having a wiki page as "title page" before the TOC.) | + | * This plugin is almost what I am looking for. Is there a way to add a title page / cover page? (I am using it with dw2pdf to also include a table of contents. I'd be fine with having a wiki page as "title page" before the TOC.)\\ **reaction**: |
plugin/bookcreator.1529309669.txt.gz · Last modified: 2018-06-18 10:14 by dds00hs