Lone Wolf Development Forums  

Go Back   Lone Wolf Development Forums > Realm Works Forums > Realm Works Discussion

Notices

Reply
 
Thread Tools Display Modes
Farling
Senior Member
 
Join Date: Mar 2013
Location: Greater London, UK
Posts: 2,623

Old January 21st, 2018, 08:56 AM
Since the existing community output tool at http://forums.wolflair.com/showthread.php?t=57418 has been discontinued, I have started work on a tool which will convert the RWoutput format into other presentation formats.

NOTE: This tool will NEVER be able to export "protected" content, such as material sold on the Content Market (since that data is never present in the RWoutput file generated by Realm Works).

The file can be downloaded from https://github.com/farling42/RWoutpu...-installer.exe

Donations for efforts can be made via any of Ko-Fi or Paypal

Instructions for Use

1a. Within Realm Works, from the "Share" tab of the ribbon, select "Manage Exports", enter some data and then select "Compact Output". This will generate a file in your "Realm Works\Output" folder whose name ends with ".rwoutput".

1b. For generation of Markdown, you should select "Full Export", which will generate a file in your "Realm Works\Export" folder whose name ends with ".rwexport".

2. Launch the RWoutput tool, press the "LOAD Realm Works FILE" button and select the file created in step 1a or 1b.

3. If a separate web page is desired for each topic, then ensure that the "Separate Topic Files" option is selected.

4. If you want to restrict the width of images to something more suitable for web pages, then choose the width in the "Max. Width (pixels)" menu. Optionally choose the "apply reveal mask" if your export should hide unrevealed parts of maps.

5. Choose one of the output options: only one set of options will be available, depending upon whether you loaded an rwoutput file or an rwexport file.

5.1 Create HTML file(s) will create XHTML files containing lots of formatting. (Word does not support importing XHTML files, see HTML4 below).

5.2 Create PDF file - experimental, and might not always work.

5.3 Print - print the output to a printer, you could choose the "print to PDF" printer on windows 10 for a more reliable PDF output.

5.4 Create HTML4 file - this is the intermediate file for printing and PDF generation; so why not have it available. This format can also be imported into Word (and possibly other editors).

5.5 Create Markdown file - this will generate a set of markdown files in the named folder.

Uninspiring, but Simple Interface


Farling

Author of the Realm Works Import tool, Realm Works Output tool and Realm Works to Foundry module

Donations gratefully received via Patreon, Ko-Fi or Paypal

Last edited by Farling; January 8th, 2022 at 01:18 AM. Reason: Change link to always download latest release
Farling is offline   #1 Reply With Quote
Farling
Senior Member
 
Join Date: Mar 2013
Location: Greater London, UK
Posts: 2,623

Old January 21st, 2018, 08:56 AM
Release Notes

v4.13
Provides support for creating Markdown files from your realm works topics.

v2.7
All links within web pages will now contain additional information in their tooltip, gleaned from the first section of the linked topic.

v2.6
Map pin tooltips will auto-populate from the linked topic if they aren't already defined to have some contents and/or gm-directions.

v2.5
There is now a dialog box in which you can specify your own map pin format, just in case you don't like the default format.

v2.4
The tooltip on pins on smart images now displays the name, description and GM directions in one nice simple layout.

v2.3
Display pins on smart images; this will help locate where you have to click to follow the link.
Also display the pin's name as a tooltip when you hover over a pin - at the moment this is limited to plain text, so lots of fancy formatting might look a little wierd.
This only works with the "Create HTML file(s)" output option.

v2.2
Initial support for generating PDF documents and for printing.
Some RWOUTPUT files might just lock the tool up forever, rather than completing the conversion.

v2.1
The 64-bit installation should now work properly.
(The correct version of quazip.dll is now provided in the installation program.)

v2.0
Update the tool to use Qt 5.12.0 and MinGW 64-bit (i.e. it is now a 64-bit program).
This is a permanent change, and should allow any size of realm to be exported to HTML.
Generates error 0x000007b when trying to start.)

v1.20
Provide a simple bar of the bottom of each HTML5 page providing Prev/Next/Up/Top navigation buttons.

v1.19
Register to open from RWOUTPUT files, not RWEXPORT files.
Disable the PDF and PRINT buttons since they don't appear to work.
Slight speed improvements.

v1.18
You can now click on a file in Windows Explorer and open the file with the Realm Works Output Formatter. You should find it available in "open with" -> "Choose Another App".

v1.17
Provide more output options.
- if a single HTML file is requested then each topic will be marked to be printed on a separate page, so if you load the HTML into Word (or print it) then you will have a nice page per topic.
- PRINT is currently a better method of generating a PDF (by choosing the windows 10 "print to pdf" printer) than using the PDF button.

This include early prototyping of PDF generation directly from the tool.
The maximum size of images can also be specified; with the picture being scaled down to not exceed the requested width.
Both the PDF and the PRINT options go via a subset of HTML4, so there is an output choice for HTML4 as well.
Memory should be managed better, so less likely to crash with large realms (2000 topics uses up around 777MB of RAM).

v1.16
Put all assets inline inside the HTML file instead of storing in separate files.
Add some experimental code for generating multiple HTML pages using multiple threads.
Ensure the quazip.dll and zlib1.dll are always put into the installation executable.

v1.15
Stat Blocks are now provided in-line in the HTML output.
Both Hero Lab portfolio files and Realm Works Statblock snippets are used to extract this information.
To do this work means that we now also use the ZLIB and QUAZIP open source libraries.

v1.14
A global collapse/expand button now appears at the top of the navigation pane of the index page.
Each topic ends with a "Child Topics" section which links to the direct children of the topic.
Topic aliases are placed immediately below the topic title.
Provide additional export information as meta items in the head of the main page.
Replace individual style definitions with reference to a locally created CSS style (called rwStyleX), but keep the Realm Works snippet styles (Read_Aloud, Callout, Flavor, Handout) as named classes.

v1.13
Re-instate the option to put everything into a single file.
When putting everything into a single file, put the theme.css inline into the same file.
Fix the CSS so that section numbering works properly again.

v1.12
Entries in the contents list are ordered alphabetically within each category.
You can now choose to have a navigation pane on each topic page (placed on the left by default).

v1.11
The index page now arranges top-level topics under their appropriate category.
Both categories and topics with children can now be collapsed to hide their children (this doesn't work on Edge because Edge doesn't support full HTML5 - search for <details> and <summary> support).
The tool will always generate separate topic files.
The version number of the application is displayed in the bottom status bar when first started.
The installer has been changed to NSIS - the end result is that the file is smaller and the version more reliable.
This version returns to being a 32-bit application, since the loading of the RWoutput file has been optimised (the 900MB file will only take up 900MB of memory instead of 1900MB).

v1.10
The parsing of all the formatting in snippets should now work properly.

v1.9
This version is 64-bit only (it uses the microsoft compiler) to allow for converting MASSIVE RWoutput files (like 900 MB size!)
There is a slight change to the detection of snippet text so that more embedded formatting is converted successfully (although some tables are still causing problems).

v1.8
Topic prefix and suffix added to topic title (configurable via CSS).
Add a title to each pin on a smart image.
Add numbering of sections within a topic (via CSS).
Calculate smart image mask properly.
Improve formatting of the summary page.
Fix low-level handling of HTML inside snippets.
Convert output to be XHTML instead of just HTML.

v1.7
GM snippets now have their own CSS style, and they look like the GM snippets in Realm Works.
External links are now put into the output properly (previously the rest of the snippet was truncated).

v1.6
Read all <p> that appear inside a snippet instead of only the first.
Simplify the HTML output by removing the individual spans (unless they involve style changes).
Provide an option as to whether smart images should have the reveal mask displayed, or not.
Create new "snippetLabel" class for CSS.
Prepend "GM" as a snippetLabel of GM snippets.
Change CSS to use class instead of style definitions: every topic title has a class of topic; every section has a class of sectionX; each level of summary has a class of summaryX
Update the GUI to be more logical.

v1.5
Smart Images now have their reveal mask applied to the final image.
Smart Images also have their pins mapped to links - there is no PIN drawn on the map, but the link is present (in the Firefox web browser the mouse cursor changes to a hand when hovering over a link).

v1.3
Most snippet types are now converted into HTML.
Where required, separate files will be generated from the external objects, herolab portfolio files, or any other sort of object which isn't a simple picture or smart image.

v1.2
The HTML output can be saved in separate files, one topic per file.
A summary sheet (index.html) is produced which lists all the topics in their containing hierarchy.
A CSS style sheet (theme.css) is also created (this file is overwritten each time the output is performed into the same directory).
There is also an option to reduce the size of images - it uses a binary scaling, so the image will be 1/2, 1/4, 1/8 original size, depending on which fraction is required to get the image under the chosen limit.

v1.1
The HTML output has been re-written to be more efficient.
Acenoid's realm now loads (93MB) and saves as an HTML file (73MB) without error.
Status reports during loading and saving of files has been added to the main window.
There's still plenty of progress to go in many ways, but this provides the core implementation on which to build.

v1.0
The initial release converts an RWoutput file into a single HTML document.
Any images in the RWoutput data will be converted into inline images.
Any internal realm links that exist in the RWoutput data will be converted into HTML links.
The topic and section headers will be converted into the relevant nested HTML header tag.
The HTML file can be loaded into a conventional web browser, or could be loaded into Word (or any other text editor) in order to further refine the output's contents.
Printing is possible from within a web browser, although later versions will provide more formatting options.

Farling

Author of the Realm Works Import tool, Realm Works Output tool and Realm Works to Foundry module

Donations gratefully received via Patreon, Ko-Fi or Paypal

Last edited by Farling; January 8th, 2022 at 01:20 AM.
Farling is offline   #2 Reply With Quote
Valyar
Senior Member
 
Join Date: Jul 2017
Posts: 347

Old January 21st, 2018, 09:00 AM
Some screens to share from the alpha?
I am desperate for options to print to .pdf or similar... This feature is so required especially for custom worlds.

The past is a rudder to guide us, not an anchor to hold us back.
Valyar is offline   #3 Reply With Quote
Farling
Senior Member
 
Join Date: Mar 2013
Location: Greater London, UK
Posts: 2,623

Old January 21st, 2018, 09:14 AM
Quote:
Originally Posted by Valyar View Post
I am desperate for options to print to .pdf or similar... This feature is so required especially for custom worlds.
You can print to PDF using the Windows print dialogue. :-)

Farling

Author of the Realm Works Import tool, Realm Works Output tool and Realm Works to Foundry module

Donations gratefully received via Patreon, Ko-Fi or Paypal
Farling is offline   #4 Reply With Quote
kbs666
Senior Member
 
Join Date: Oct 2014
Location: Chicago, IL
Posts: 1,690

Old January 21st, 2018, 09:30 AM
Rather than starting from scratch I would hope people interested in such would continue work on EightBitz's project.
http://forums.wolflair.com/showthread.php?t=57418

my Realm Works videos
https://www.youtube.com/channel/UCZU...4DwXXkvmBXQ9Yw
kbs666 is offline   #5 Reply With Quote
Farling
Senior Member
 
Join Date: Mar 2013
Location: Greater London, UK
Posts: 2,623

Old January 21st, 2018, 10:15 AM
Quote:
Originally Posted by kbs666 View Post
Rather than starting from scratch I would hope people interested in such would continue work on EightBitz's project.
http://forums.wolflair.com/showthread.php?t=57418
I took his project as inspiration, but his project is PowerShell based and so is quite restricted in its ability to perform powerful data manipulations.

(Also, I try to avoid any languages or development which are specifically tied to only one operating system.)

Farling

Author of the Realm Works Import tool, Realm Works Output tool and Realm Works to Foundry module

Donations gratefully received via Patreon, Ko-Fi or Paypal

Last edited by Farling; January 21st, 2018 at 10:28 AM.
Farling is offline   #6 Reply With Quote
Parody
Senior Member
 
Join Date: Jan 2013
Location: Rochester, MN
Posts: 1,515

Old January 21st, 2018, 11:05 AM
Quote:
Originally Posted by Farling View Post
You can print to PDF using the Windows print dialogue. :-)
Windows 7 does not include a PDF printer, FWIW.

Parody is offline   #7 Reply With Quote
Dark Lord Galen
Senior Member
 
Join Date: Jul 2012
Location: Texas
Posts: 707

Old January 21st, 2018, 11:55 AM
an alternative approach might be to do something with or similar to PDF Writer, which simulates an actual printer but converts the printer out cue to a file..... Just a thought.


http://cutepdf.com/

D&D> Pre 1e White Box Edition, 1e, 2e, 3.5 Currently, Set in the World of Greyhawk (The first, longest running and Best Campaign Setting)
Software>Extensive use of all forms of MS Products, Visual Studio 2012, DAZ 3d, AutoCAD, Adobe Products.
Gaming Specific>Campaign Cartographer, D20 Pro Alpha & BattleGrounds Beta Tester, World Builder, Dungeon Crafter, LWD Hero Lab, Realm Works, Inkwell Ideas Citybuilder & Dungeon Builder, Auto-Realm, Dundjinni
Contributing Writer for TSR, WOC, & Canonfire
Dark Lord Galen is offline   #8 Reply With Quote
EightBitz
Senior Member
 
Join Date: May 2013
Posts: 1,458

Old January 21st, 2018, 12:08 PM
Quote:
Originally Posted by Parody View Post
Windows 7 does not include a PDF printer, FWIW.
You can find free PDF printers. Here's one example: http://www.primopdf.com/

Be careful when downloading and installing that. If I recall correctly, it has some piggy-back stuff that you'll most likely want to deselect, so read the options carefully.

As long as you're careful about that, though, it works fine.
EightBitz is offline   #9 Reply With Quote
EightBitz
Senior Member
 
Join Date: May 2013
Posts: 1,458

Old January 21st, 2018, 12:17 PM
Quote:
Originally Posted by Farling View Post
Since the existing community output tool at http://forums.wolflair.com/showthread.php?t=57418 has been discontinuted, I have started work on a tool which will convert the RWoutput format into other presentation formats.

The file can be downloaded from https://github.com/farling42/RWoutpu...0/RWoutput.exe

Instructions for Use

1. Within Realm Works, from the "Share" tab of the ribbon, select "Manage Exports", enter some data and then select "Compact Output". This will generate a file in your "Realm Works\Output" folder whose name ends with ".rwoutput".

2. Launch the RWoutput tool, press the "LOAD RWOUTPUT" button and select the file created in step 1.

3. Press the "SAVE HTML" button and pick a location and enter the name of the HTML file to be generated.

4. The HTML file will be created immediately.

Uninspiring, but Simple Interface



Further Work

v1.0 provides only an initial simple program which implements the reading of the RWoutput file and the generation of a basic HTML file. This initial work provides the basis for further improvements to the data output.
I got a runtime error on one of the Realms that's been challenging for my script.

--
Runtime Error!

Program: C:\Program Files (x86)\RWout\RWout.exe

This application has requested the Runtime to terminate in an unusual way.
Please contact the application's support team for more information."
---

I can't share the realm file, because it's not mine. It's Acenoid's Shadowrun realm.
EightBitz is offline   #10 Reply With Quote
Reply

Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump


All times are GMT -8. The time now is 06:29 PM.


Powered by vBulletin® - Copyright ©2000 - 2024, vBulletin Solutions, Inc.
wolflair.com copyright ©1998-2016 Lone Wolf Development, Inc. View our Privacy Policy here.