HemMedia
Last Modified: 11/27/2006
Home | The Basics | File Manager | Web Stitcher | HTMLtoPDF | Share Manager | ItemWizard | HemMedia
About HemMedia plugin
Editing your STACK Later
Getting Started using HemMedia
Editing your STACK Later
Getting Started using HemMedia
HemMedia Structure
Before we start delving into the particulars of creating a HemMedia project, let's first spend some time understanding how HemMedia structures content from Hemingway.
You should already know about webs, sections and items in Hemingway. If not, please review those concepts first.
Data Structure
HemMedia creates a page of data called a CARD for each Section in a Hemingway web. On that page is all of the data relating to that Section, including the Section Description and all the Items for that Section. All the CARDs together reside in a single window called a STACK.
If an Item has an associated image, then HemMedia will also place that image on the CARD. If the image is linked to a larger image, then HemMedia will display a magnifying glass button next to the image, which when pressed will display the larger image in a separate window.
If an Item has a link to a URL associated with it, Hemingway will place a link button next to that item (unless the Show Links checkbox is turned off prior to building the HemMedia project).
HemMedia will also create a CARD for each imported web, which will have the Web Title, Web Description and any logo or splash images associated with the web. If you are using nested webs, or Portal SubPortal webs, or you don't have much information on the webpage, you may bypass it by unchecking the Render Web Settings button.
Table of Contents (TOC)
During the build process, HemMedia creates a Table of Contents for each web based upon the settings for that specific web. HemMedia can create up to a 3 level TOC (Webs, Sections, Items).
You can change what is shown in the TOC through the various Chapter Settings.
Build Process
When you press the Build HemMedia button, the data from the ZIP file is processed and placed onto different CARDS in the HemMedia window (STACK). At the same time, it generates a TOC to go with the newly generated CARDS.
Once you have successfully built a HemMedia STACK, you can perform limited editing upon it, then save it.
You should already know about webs, sections and items in Hemingway. If not, please review those concepts first.
Data Structure
HemMedia creates a page of data called a CARD for each Section in a Hemingway web. On that page is all of the data relating to that Section, including the Section Description and all the Items for that Section. All the CARDs together reside in a single window called a STACK.
If an Item has an associated image, then HemMedia will also place that image on the CARD. If the image is linked to a larger image, then HemMedia will display a magnifying glass button next to the image, which when pressed will display the larger image in a separate window.
If an Item has a link to a URL associated with it, Hemingway will place a link button next to that item (unless the Show Links checkbox is turned off prior to building the HemMedia project).
HemMedia will also create a CARD for each imported web, which will have the Web Title, Web Description and any logo or splash images associated with the web. If you are using nested webs, or Portal SubPortal webs, or you don't have much information on the webpage, you may bypass it by unchecking the Render Web Settings button.
Table of Contents (TOC)
During the build process, HemMedia creates a Table of Contents for each web based upon the settings for that specific web. HemMedia can create up to a 3 level TOC (Webs, Sections, Items).
You can change what is shown in the TOC through the various Chapter Settings.
Build Process
When you press the Build HemMedia button, the data from the ZIP file is processed and placed onto different CARDS in the HemMedia window (STACK). At the same time, it generates a TOC to go with the newly generated CARDS.
Once you have successfully built a HemMedia STACK, you can perform limited editing upon it, then save it.
Importing Webs
HemMedia should be open and a window named "Developer Mode" will be on top of the eventual HemMedia data window. This is the Developer Mode control panel. It is used for most of the configuration for HemMedia.
If you don't see the Developer Mode control panel, then Ctrl-click on the upper-left of the HemMedia window and some buttons and controls will appear at the bottom. Click the button open Developer to access Developer Mode.
The Start Over button at the top left will do just that— erase everything and start over. Press the Add HemPC ZIP file and import your recently downloaded ZIP files. You may import a single web or multiple webs. You can reorder them at any time using the MoveUp and MoveDn buttons.
HemMedia should be open and a window named "Developer Mode" will be on top of the eventual HemMedia data window. This is the Developer Mode control panel. It is used for most of the configuration for HemMedia.If you don't see the Developer Mode control panel, then Ctrl-click on the upper-left of the HemMedia window and some buttons and controls will appear at the bottom. Click the button open Developer to access Developer Mode.
The Start Over button at the top left will do just that— erase everything and start over. Press the Add HemPC ZIP file and import your recently downloaded ZIP files. You may import a single web or multiple webs. You can reorder them at any time using the MoveUp and MoveDn buttons.
Collecting Files
It is important to organize your files in the order you want them imported into HemMedia. HemMedia works by importing existing webs and rendering them to a STACK (window). You may import as many webs as you like. HemMedia only imports valid Hemingway XML webs stored in a ZIP file.
The easiest way to create these XML ZIP files is to go to the web settings for the web you want to export, choose the Web Setttings 3 tab, and click the Export Web to XML button on the bottom right. If you have a large web, it may take some time to build the ZIP file on the server. Once it is built, it will prompt you for a location to save it. Give it a name with a ".zip" extension.
When you have all the webs exported, you can then launch the HemMedia plugin by clicking the HemMedia button on the upper right section of HemPC.
The easiest way to create these XML ZIP files is to go to the web settings for the web you want to export, choose the Web Setttings 3 tab, and click the Export Web to XML button on the bottom right. If you have a large web, it may take some time to build the ZIP file on the server. Once it is built, it will prompt you for a location to save it. Give it a name with a ".zip" extension.
When you have all the webs exported, you can then launch the HemMedia plugin by clicking the HemMedia button on the upper right section of HemPC.
HemMedia Settings
There are a number of different settings which can be applied to your HemMedia STACK.
HemMedia Name
This is required and will be shown in the top of the window bar when your STACK is built. This name is not the filename, you will be prompted for that when you save your STACK.
HemMedia Chapters
This is a list of all the webs you have currently imported.
Chapter Settings
These settings only apply to the web which is highlighted in the HemMedia Chapters list.
• Render Web Settings
When this checkbox is checked, HemMedia will render a Table of Contents line item along with a separate CARD for the highlighted Web. If it is not checked, then HemMedia will bypass rendering the Web information and render only the Section information (with Items). This is useful if rendering Portal/SubPortal types of Webs where there is no information on the main Web page.
• Show Web in TOC
As mentioned previously, up to 3 levels can be shown in the TOC— one each for Web, Section and Item. If you do not choose to render the Web level (the Render Web Settings checkbox is off), you may wish to not show a TOC list item for the Web. In this case, by turning off Show Web in TOC, you are limiting the outline to only two levels: Sections and Items. This button does not prevent the Web from being rendered, only from being listed in the TOC.
• Show Sections in TOC
When turned off prevents Sections from appearing in the TOC for the designated web. This button does not prevent the Section from being rendered, only from being listed in the TOC. It's usually a good idea to keep this button checked.
• Show Items in TOC
When turned off prevents Items from appearing in the TOC for the designated web.This button does not prevent the Section from being rendered, only from being listed in the TOC. It's usually a good idea to keep this button checked.
Other Settings
• Show Links
When this button is unchecked, no links will be visible on the finished rendered CARDS. This is good when creating a finished HemMedia STACK which goes on a computer which doesn't have internet access. It's usually a good idea to keep this button checked.
• Add Logo
You can press the Add Logo button to replace the HemMedia logo with your own. If you want a perfect fit, create your logo 163 pixels wide by 43 pixels tall. If you import a JPG or PNG file which is not the same size, HemMedia will scale it to fit those same dimensions.
HemMedia Name
This is required and will be shown in the top of the window bar when your STACK is built. This name is not the filename, you will be prompted for that when you save your STACK.
HemMedia Chapters
This is a list of all the webs you have currently imported.
Chapter Settings
These settings only apply to the web which is highlighted in the HemMedia Chapters list.
• Render Web Settings
When this checkbox is checked, HemMedia will render a Table of Contents line item along with a separate CARD for the highlighted Web. If it is not checked, then HemMedia will bypass rendering the Web information and render only the Section information (with Items). This is useful if rendering Portal/SubPortal types of Webs where there is no information on the main Web page.
• Show Web in TOC
As mentioned previously, up to 3 levels can be shown in the TOC— one each for Web, Section and Item. If you do not choose to render the Web level (the Render Web Settings checkbox is off), you may wish to not show a TOC list item for the Web. In this case, by turning off Show Web in TOC, you are limiting the outline to only two levels: Sections and Items. This button does not prevent the Web from being rendered, only from being listed in the TOC.
• Show Sections in TOC
When turned off prevents Sections from appearing in the TOC for the designated web. This button does not prevent the Section from being rendered, only from being listed in the TOC. It's usually a good idea to keep this button checked.
• Show Items in TOC
When turned off prevents Items from appearing in the TOC for the designated web.This button does not prevent the Section from being rendered, only from being listed in the TOC. It's usually a good idea to keep this button checked.
Other Settings
• Show Links
When this button is unchecked, no links will be visible on the finished rendered CARDS. This is good when creating a finished HemMedia STACK which goes on a computer which doesn't have internet access. It's usually a good idea to keep this button checked.
• Add Logo
You can press the Add Logo button to replace the HemMedia logo with your own. If you want a perfect fit, create your logo 163 pixels wide by 43 pixels tall. If you import a JPG or PNG file which is not the same size, HemMedia will scale it to fit those same dimensions.
Building the HemMedia STACK
Once all the settings are made, it's time to create your project. Press the Build HemMedia button and the process will start. You will see some screen flashing while HemMedia imports all the text and images into the STACK. When it's finished, you can click on the STACK window (the titlebar will now have the name you assigned it earlier), and you can test your stack.
If you find you need to rebuild, just press the Build HemMedia button again and it will Start Over and rebuild your STACK from scratch. Once the STACK is successfully built, you can close the Developer Mode window and begin editing your HemMedia STACK.
If you find you need to rebuild, just press the Build HemMedia button again and it will Start Over and rebuild your STACK from scratch. Once the STACK is successfully built, you can close the Developer Mode window and begin editing your HemMedia STACK.
Editing your HemMedia STACK
You should go through your HemMedia TOC and check to make sure your content is formatted correctly and where you want it.
The Delete button at the bottom of the STACK allows you to delete entries from the TOC.
IMPORTANT: The delete button ONLY deletes entries from the TOC, it DOES NOT delete any content from the stack.
When you delete either a Web or a Section, you will be prompted to delete the CARD as well. You should always answer OK. Then the CARD and all the data on it (including ITEMS) will be deleted as well.
If you delete an item in the TOC, it will delete all the sublevels for that item as well. This is potentially very dangerous, so be careful. Of course, you can always start over if you make a mistake.
It is not a good idea to ever delete a Web, because it will not delete all of the associated Section CARDS. Use the Chapter Settings in the Developer Mode for not rendering the Web TOC entry.
If you delete an Item and if it prompts you to delete the Card, answer "Cancel." You should then unlock the field (uncheck the lock field button) and manually delete the item.
Note: Whenever you delete an Item, you need to make sure and manually delete the content for that Item from the respective CARD.
The Delete button at the bottom of the STACK allows you to delete entries from the TOC.
IMPORTANT: The delete button ONLY deletes entries from the TOC, it DOES NOT delete any content from the stack.
When you delete either a Web or a Section, you will be prompted to delete the CARD as well. You should always answer OK. Then the CARD and all the data on it (including ITEMS) will be deleted as well.
If you delete an item in the TOC, it will delete all the sublevels for that item as well. This is potentially very dangerous, so be careful. Of course, you can always start over if you make a mistake.
It is not a good idea to ever delete a Web, because it will not delete all of the associated Section CARDS. Use the Chapter Settings in the Developer Mode for not rendering the Web TOC entry.
If you delete an Item and if it prompts you to delete the Card, answer "Cancel." You should then unlock the field (uncheck the lock field button) and manually delete the item.
Note: Whenever you delete an Item, you need to make sure and manually delete the content for that Item from the respective CARD.
Saving your STACK
When you are finished editing your STACK, you can then press the Save Stack.. button and choose a place to save your stack. You can name it anything you like, with any extension you like (or not). Then close both the STACK window and the Developer Mode window.
Once it is closed, it is no longer editable from within HemPC. But, not to worry, the next Section will tell you how you can edit it, including repopulating it with new webs, when in standalone mode.
Once it is closed, it is no longer editable from within HemPC. But, not to worry, the next Section will tell you how you can edit it, including repopulating it with new webs, when in standalone mode.
Running your STACK
Now that you have the file saved, you'll need to get the HemMedia Player application from the Altuit website. Then place the Player and your STACK file in the same folder, and launch the Player. It will automatically launch the STACK as well.
Technology by: Altuit, Inc. | top