DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:currentlyreading

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
plugin:currentlyreading [2021-08-04 01:28] – [Discussion] added clfewlassplugin:currentlyreading [2023-04-26 12:41] (current) Aleksandr
Line 1: Line 1:
-====== currentlyreading Plugin ======+====== Currently Reading Plugin ======
  
 ---- plugin ---- ---- plugin ----
-description: Displays a box with a book cover image that says ‘Currently Reading’ linked to a page.+description: Displays a box with a book cover image that says ‘Currently Reading’ linked to a page
 author     : Charles Fewlass author     : Charles Fewlass
 email      : curator@scrollsoflankhmar.com  email      : curator@scrollsoflankhmar.com 
 type       : syntax type       : syntax
-lastupdate : 2021-08-03+lastupdate : 2021-08-07
 compatible : Hogfather compatible : Hogfather
 depends    :  depends    : 
 conflicts  conflicts 
 similar    :  similar    : 
-tags       : books, reading+tags       : books, reading, box, image
  
-downloadurl: http://github.com/elbuagnin/dokuwiki-plugin-currentlyreading/zipball/master +downloadurl: https://github.com/elbuagnin/dokuwiki-plugin-currentlyreading/archive/refs/tags/v1.0.1.zip 
-bugtracker : http://github.com/elbuagnin/dokuwiki-plugin-currentlyreading/issues +bugtracker : https://github.com/elbuagnin/dokuwiki-plugin-currentlyreading/issues 
-sourcerepo : http://github.com/elbuagnin/dokuwiki-plugin-currentlyreading/+sourcerepo : https://github.com/elbuagnin/dokuwiki-plugin-currentlyreading/
 donationurl:  donationurl: 
  
-screenshot_img : +screenshot_img :  # https://scrollsoflankhmar.com/_media/currentlyreadingexample.png #FIXME
 ---- ----
  
 ===== Installation ===== ===== Installation =====
  
-Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.+Install the plugin using the [[extension|Extension Manager]] Plugin and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.
  
 ===== Usage ===== ===== Usage =====
-Include the markdown on a page and it will be replaced by a box containing the heading, “Currently Reading,” with below a linked title of the page, and below that an image of the book cover.+ 
 +Include the markdown on a page and it will be replaced by a box containing the heading, “Currently Reading”with below a linked title of the page, and below that an image of the book cover.
  
 The story title is pulled from the page’s metadata title, and the image comes from the page’s first image metadata. The story title is pulled from the page’s metadata title, and the image comes from the page’s first image metadata.
Line 34: Line 35:
 Spaces in the pagename will be eliminated and capitalization will be converted to lowercase when the plugin looks for an existing wiki page. However, if no page exists, spaces and capitalization will be kept when creating the displayed title. The attached link, will of course, be converted. Spaces in the pagename will be eliminated and capitalization will be converted to lowercase when the plugin looks for an existing wiki page. However, if no page exists, spaces and capitalization will be kept when creating the displayed title. The attached link, will of course, be converted.
  
-**Screenshot** +**Screenshot**FIXME 
-{{https://scrollsoflankhmar.com/_media/currentlyreadingexample.png|Screenshot}} +  {{https://scrollsoflankhmar.com/_media/currentlyreadingexample.png|Screenshot}}
  
 ===== Syntax ===== ===== Syntax =====
 +
 <code>{{reading>pagename[?width]}}</code> <code>{{reading>pagename[?width]}}</code>
  
 ==== Parameters ==== ==== Parameters ====
 +
 === pagename === === pagename ===
 +
 //required// //required//
 <code>{{reading>gatherdarkness}}</code> <code>{{reading>gatherdarkness}}</code>
Line 53: Line 56:
 <code>{{reading>comingattractions?300}}</code> <code>{{reading>comingattractions?300}}</code>
 //Width is in pixels.// //Width is in pixels.//
 +
 //Including a width will override the configuration width.// //Including a width will override the configuration width.//
  
Line 59: Line 63:
 A space preceding the pagename will cause the box to float right, at the end will float left, and at both places will float center. A space preceding the pagename will cause the box to float right, at the end will float left, and at both places will float center.
  
-<code>{{reading> smokeghost}}</code> +  * //floats right//<code>{{reading> smokeghost}}</code> 
-//floats right// +  //floats left//<code>{{reading>smokeghost }}</code> 
-<code>{{reading>smokeghost }}</code> +  //center//<code>{{reading> smokeghost }}</code>
-//floats left// +
-<code>{{reading> smokeghost }}</code> +
-//center//+
  
 ==== No Existing Page ==== ==== No Existing Page ====
 <code>{{reading>hungergames}}</code> <code>{{reading>hungergames}}</code>
-//Still displays a box with a link to a non-existing page in the wiki.// \\ +//Still displays a box with a link to a non-existing page in the wiki.//\\  
-**Resultant Title:** hungergames **Interwiki Link:** hungergames \\+**Resultant Title:** hungergames **Interwiki Link:** hungergames
  
 <code>{{reading>Hunger Games}}</code> <code>{{reading>Hunger Games}}</code>
-//Still displays a box with a link to a non-existing page in the wiki.// \\ +//Still displays a box with a link to a non-existing page in the wiki.//\\  
-**Resultant Title:** Hunger Games **Interwiki Link:** hungergames \\+**Resultant Title:** Hunger Games **Interwiki Link:** hungergames
  
 ===== Configuration and Settings ===== ===== Configuration and Settings =====
 ==== Configuration ==== ==== Configuration ====
 === Width === === Width ===
-Default width in pixels. \\+Default width in pixels.\\ 
 //Can be overriden in markdown.// //Can be overriden in markdown.//
  
 === Alternate Heading === === Alternate Heading ===
-A heading that replaces "Currently Reading." \\+A heading that replaces "Currently Reading."\\ 
 //If left blank, no replacement occurs.// //If left blank, no replacement occurs.//
  
Line 90: Line 91:
 ===== Development ===== ===== Development =====
 === Change Log === === Change Log ===
- +{{rss>https://github.com/elbuagnin/dokuwiki-plugin-currentlyreading/tags.atom}}
-  * **2021-08-03** +
-    * Initial release+
  
 === Known Bugs and Issues === === Known Bugs and Issues ===
-[[https://github.com/elbuagnin/dokuwiki-plugin-currentlyreading/issues|Github Issue Tracker]]+[[https://github.com/elbuagnin/dokuwiki-plugin-currentlyreading/issues|Github Issue Tracker]]
  
 ===== Discussion ===== ===== Discussion =====
-Please post in the DokuWiki forum under the Extensions tag and mention the plugin in the title. +[[https://forum.dokuwiki.org/|DokuWiki Forum]] or [[https://github.com/elbuagnin/dokuwiki-plugin-currentlyreading/discussions|GitHub Repo Discussion]].
  
plugin/currentlyreading.1628033337.txt.gz · Last modified: 2021-08-04 01:28 by clfewlass

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki