Sidehistorik
Hide children |
---|
Tip | ||
---|---|---|
| ||
2018-01-03: Added Extraction of EXIF Tags - for GPS Position purpose - Read Extraction EXIF data from my Images 2015-09-20: Changed input for makeThumbs. |
...
sh to key=value usage and added orientation magic into it 2015-01-04: Changed input to key=value usage 2014-07-15 : Added the blazy javascript to my site. This makes thumbnail load and display when needed instead of all thumbnails loaded when rendering a page (rendering 2000 small images takes a heck of time) - Read the Adding blazy to the Mos-Eisley Gallery page 2014-01-16 : Upgraded to permanent multipage (1 for each subdir and 1 to include all), ThumbSize as command line argument and minor fixes to the code 2013-09-15 : Putting ThumbSize and DisplaySize in the macro call, so these can be changed without breaking older pages |
Requirements
Software
Atlassian CLI (Notice the 3.X versions are not free, last free download versions at Atlassian CLI
Imagick and ffmpegthumbnailer installed , exiftool and ffmpegthumbnailer installed, this can typically be done with a package manager for the OS.
A Ligthbox, this is optional, as the build-in can be used, but a custom one can be installed as in Installing Javascript libraries or frameworks in Confluence
Scripts
Gallery Configurations (config.txt)
Script for making thumbnail images (makeThumbs.sh)
Script for importing linking images into a Confluence page (updateGallery.sh)
Optional: Script for refreshing Confluence pages (refreshPages.sh)
Files
Get the latest files https://bitbucket.org/moseiseydk/confluence-gallery
User Macros
...
User Macro: me-video - Linking to a Video file
One of these Lighboxes:User Macros If You have selected a custom lighbox (Installing Javascript libraries or frameworks in Confluence):
User Macro: me-image - Image lightbox with prettyPhoto
User Macro: me-image - Image lightbox with Floatbox
User Macro: me-image - Image lightbox with Slimbox2
User Macro: me-image - Image lightbox with OrangeBox
User Macro: me-image - Image lightbox with fancybox
Or use the one in Confluence:
User Macro: me-image - Image lightbox with Confluence style
...
Config Tomcat to support symbolic links (see this currently unsolved issue regarding special UTF-8 characters)
Link from Confluence to the MediaRoot (here called /data/images) - The "media" in the link is used in the "me-image" macro, these must match if changed.
Kodeblok |
---|
ln -s /data/images $CONFLUENCE_HOME/confluence/media |
Create a Script directory and place the 3 scripts and the config.txt files into them
Edit the config.txt to fit Your installation
Create the User Macro me-image in Your Confluence installation (remember to set parameters ThumbSize and DisplaySize to the same as i config.txt)
Start adding pictures to Your installation using the updategallery.sh and optional refreshpages.sh scripts
The workings
All content (Pictures and Video) are place on the servers filesystem in a Tree Structure, from a Basic root (called ContentRoot MediaRoot in the config.txt file) All the top directories under the ContentRoot are linked - This Root is symlinked into the Confluence installation by the makesymlinks.sh script)base Url
For each top directory, a subdirectory or one or more phrases, a collection of content can be placed on a Confluence Page with the updategallery.sh script
...
- Creates thumbnails for the content (image or video) in a subdir subdirectory called something with "thumbs"
- Adds a macro onto the specified Confluence page to show (render) the content (image or video)
- Created a short link to the image - this link is md5 sum based, so even if the file changes name, the link will still work
- Finally, saves the page into Confluence
Architecture
Gliffy Diagram | ||
---|---|---|
|
...
http://www.server.dk/links/6594565645694564056 will serve the regular file /data/images/Familiebilleder/2012/CIM2000.jpg and
http://www.server.dk/thumbs/200/6594565645694564056 will serve the regular file /data/images/Familiebilleder/2012/thumbs/200pxHigh/CIM2000.jpg
Questions and Answers
Q: Is there a manuel maintenance between the config.txt and the me-image macro?
A: Yes, the ThumbnailSize ThumbSize and DisplaySize numbers must match in the file and macro, otherwise the imagelinks images will give a 404 Error
Q: My Thumbnail Image is not displayed?
...
- Tomcat Linking is allowed:
The server.xml file has to be changed adding the allowedLinked parameter:
<Context path=
""
docBase=
"../confluence"
debug=
"0"
reloadable=
"false"
useHttpOnly=
"true"
allowLinking=
"true"
>
- The Paths etc in the macro on the Confluence Page - does it exist in the filesystem
- Permissions on the filesystem
...
Q: Images are so slow...why?
A: This can be bandwith, server hardware, memory - or the DisplaySize parameter - hence how large an image that must be fetched. 800 is default.
Q: Why does the me-image macro have both an parth/image-name and md5 sum parameterA: The path/imageMy image just opens in a new window, not popped up or via jQuery
A: Either the ligtbox is not loaded, or the class and/or id on each images is wrong, consult the Lightbox documentation and Installing Javascript libraries or frameworks in Confluence-name is pure legacy, the md5 is the future workings, as this better supports moving images around in dirs, or renaming them.