Creating Image Captions: Best Practice?

Hello-
I'm currently using RoboHelp to create an HTML-based internal user guide for a software product. This guide has many images and figures in it and each will need an accompanying caption. Each caption must appear centered directly beneath the accompanying image.
I need some guidance on two issues, please:
1. What is the best practice for inserting a caption along with an image?  I currently cannot find any tool or which enables a RoboHelp user to insert an image into a document and designate a caption to be displayed with that image.
2. Each image will be uniquely numbered (Figure 1, Figure 2, etc.). It may be necessary, as the document is drafted and redrafted, to remove images from and insert other images into the document. How can the numbering of images be set up so that the removal or addition of an image will automatically reset the numbering of all affected images accordingly?  I would very much like to avoid resetting dozens of image number-designations manually.
Thank you-
Michael

Hi there
As far as the captions go, I would normally include the caption as part of the image itself. If you feel you must keep the text separate, I'm guessing you will need to resort to tables. One column and two rows.
As for the numbering, that one will be pretty tough. Keep in mind that in the world of HTML, people don't typically consume content in a linear fashion as they once did when all we had was print.
Someone may pop in here with some solution I've been unaware of. But presently, I'm unaware of a way to force that type of numbering.
Cheers... Rick

Similar Messages

  • Reason for creating New Version Best practice

    Hello SAP Gurus,
    We know we are creating new version of the DIR when it is required to make a change in the original keeping in tact the Older file also for reference,
    we want to know when a new version of the document is getting created how can we specify, why and what made us to create this new Version, we would like to capture this reason in SAP so the user can easily come to know why this Version is created,
    can you please let us know, where actually are we capturing this details while creating the new version,
    i know there are lot of free entry fields like Generic object Text field, Long text field, change the description, place the text in the WR log field of the new Version,
    which is the best practice so that the user can easily come to know the reason why this new version has been created,
    may be they should see this reason details in CV04N search as well, or immediately when opening the new version.
    Thanks and regards
    Kumar

    Hello Kumar
    Hope following explanation will clarify your questions
    We have to classify our documents broadly in two category  1) Controlled document --means which under goes various level of  / Inspection / review / approval etc with in Organisation e.g. Engg Drawing , Standard Operating Procedure for business purpose, best way for this is use Engineering Change Management (ECM)Functiuon and when you make any up versions, you can track / write key docu ment history in ECM 
    also when you do up version let say in Micosoft word , you can maintain simple table to track what is purpose of change, in what location you are making chnage and its justification.
    For Engineering drawing of 2D /3D we can use Redlining functions to createt the Lawyers to know reviwers observation so that next version thopse are taken care
    2) Uncontrolled Document---Generally they are less significant from document Change Control point of view
    Hope this is useful
    Regards
    GIRISH

  • Create Test Environment - Best Practice

    HI all..
    Please, someone know which is the best practice  to create a environment test from our company DB for testing purpose?
    OUR SCENARIO:
    SAP B1 9.1 PL 6
    MSSQL 2008 R2
    Integration service activated
    WINDOWS 2008 R2 Ent Edition for client machine and server machine
    Thank's in advance
    --LUCA

    Hi Manish..
    I would like to have a copy of our company DB for testing purpose..
    It's not important integration service.
    We would like to test 9.1 PL 06 BoM new features without modify the rpoduction environment...
    Thank's
    --LUCA

  • Use MS Account or Organization Account to create Azure Account - Best Practice?

    Hi, I see that it is now possible to create Azure accounts as an org: http://azure.microsoft.com/en-us/documentation/articles/sign-up-organization/. Previously, you needed a MS Account. I also note that http://msdn.microsoft.com/en-us/library/azure/hh531793.aspx
    says “Use organizational accounts for all administrative roles”. Note the word "all" which I guess includes the main admin account itself. Is this now considered MS's best practice for organizations? I have to admit that at the moment, I can't see
    what difference it really makes in practice. Any thoughts?
    TIA.
    Mark

    Hi,
    "Mark as answer" means that the post could help you, of course, we hope our posts could give you some help, if not, please feel free unmark, if you still have issues with this topic, we welcome to post again, Thanks for your understanding.
    For this topic, as mention by Bharath Kumar P, we usually use Microsoft account for single user, you could try to sign up a one-month free trial at:
    http://azure.microsoft.com/en-us/pricing/free-trial/, here are Azure Free Trial FAQ:
    http://azure.microsoft.com/en-us/pricing/free-trial-faq/, if you have any questions, please feel free to let me know.   
    Best Regards,
    Jambor
    We are trying to better understand customer views on social support experience, so your participation in this interview project would be greatly appreciated if you have time. Thanks for helping make community forums a great place.
    Click
    HERE to participate the survey.

  • Runtime image storage best practice ?

    Hello,
    I have a question regarding the best place to store images that will be loaded at runtime. I understand the concept of having an assets folder within the project and keeping certain images as a part of the project itself, but what about storing images that are dynamic in that they not available at authoring, but are still loaded at runtime.
    The specific implementation is that I have an application that is configured by the user, and I want them to be able to assign their own images for icons on buttons (while still assigning default icon in case the image they've assigned is not found or is not compliant to the size requirements, etc). So where would be the best place to store images like this. There are a couple of other places in my project where I'll allow the user to place their own logos (such as the a control bar area etc) or other graphics withing the context of the UI so the question is not specific to buttons and icons.
    I hope my question makes sense, but I can be more specific if need be. Thanks in advance for your time.

    You could use resource bundling mechanism for your Idea, depends on how many users will you have? because this approach requires to have compiled resource modules loaded at runtime, so for each custom set of stuff for one of your users you should invoke mxmlc compiler to build it's own custom resource module. Which you can load at runtime and overlap all same named resources already used in the application.
    And all you have to worry about that your resources named matched and resource bundle names must be equal too.
    If you are interested, dig into ResourceManager class and resource bundling mechanism.
    If you feel this message answers your question or helps, please mark it respectively

  • Creating Master Image Best Practices

    Greetings!
    Soon, I will be sending a master disk to a fulfillment company for mass replication.
    I have already sold about 350 copies of my DVD (produced with Encore), which I burn on my computer (Alienware, Windows 7), and then package and ship to my customers.
    I
    I've had one guys who said it "skipped really bad", I've had a couple customers who get an "invalid or unknown file" error when they tried to play it on a DVD player, and one guy who couldn't play on a computer because of a "missing DVD decoder".
    4 or 5 errors out of 350 isn't bad, but I'm wondering if there's anything I need to know, in order to make my NTSC DVD as universally viewable as possible?
    I know not to exceed an 8mb/s bitrate, but other than that, is there anything I should know or do?
    Thank you!
    Pat

    I did indeed use Taiyo-Yudens. Since I bought 500 blanks, I got a good price on solid media.
    I'm mostly wondering if there's a software 'best practice' I need to follow, since my fulfillment center will be handling most of the heavy lifting with the hardware and media.
    Thanks, video pros..!
    Pat

  • Direct access to document image via webservice - best practice?

    Howdy,
       Rookie "Post-er".... be gentle.  I've searched and I've read... didn't find this.  I've not taken training.  I may be way off base.
    We have multiple manufacturing sites around the world with local Operator Qualification appls that want to access the enterprise SAP DMS mfg document images (stop dual maint - enterprise & local)....  without dependency on SAP ECC being up.  If we can pass them DMS meta-data via near-realtime msgs (including the document image access "key" data); then we would assume they can direclty access KPRO for the document image as needed.
    Would this be considered a "best practice"?   Webservice controlled (access only from known source).
    Is PHIO-ID the only dynamic variable needed (based on info below I found in WIKI)?
    *Alternatively, the url as below can be used to retrieve the documents from the content server[*http://<Server_Name>:<Port_No>/archive.dll?get&pVersion=<Version_No>&contRep=<Content_Rep>&docId=<PHIO_ID|http://<Server_Name>:<Port_No>/archive.dll?get&pVersion=<Version_No>&contRep=<Content_Rep>&docId=<PHIO_ID|\||]>
                <Server_Name> = Content server (IP address or name of content server)
                <Port_No> = Port No. of the server
                <Version_No> = Version No of content server (Transaction OACT)
                <Content_Rep> = content category of the server (Transaction OAC0)
                <PHIO_ID> = PHIO Id derived for each upload method

    Hello,
    This reply posted to help others who may refer this in the future.
    As Amit Maheshwari mentioned, it is possible to give access to a document stored in the Content Server even when the partner system(ECC) is down.
    As per your requirement, you want to access documents when the ECC System is down, but the content server is up and running.
    The following steps can be of help to you:
    1 - Create a program, that will create URL for the documents stored in the content server and send the URL to the external system.(Refer: FM- SDOK_PHIO_GET_URL_FOR_GET)
    The URL refers to the public IP of the Internet Server on which the content server is hosted on.
    2 - With this URL and few configurations on the Content Server (to allow access from external systems) you can fetch the file from the content server to the external system. Access privileges may vary based on your security settings.
    Note: Since the ECC system will be down, creating URL for all the documents can be a bottleneck.
    Probable Solution: While adding a document to the ECC system, the respective URL can be created and transferred to the external system along with the master details and stored there.
    This can be undertaken if it is really important for the business, as it will increase the load for the external system. The solution can be modified based on the business requirement.
    Thank you,
    Regards,
    Tamilnesan G

  • Best practice for a site with a lot of images?

    I am working on a site that will have over a hundred images
    and I wanted to see what is the best practice for designing a site
    like this. Should a go with xml(please give examples or
    explanation), a text file or just loadMovie("image1project1.jpg",
    "bottomsec") with named external images that will stay the same.
    Any help is appreciated on staying up to date with this kind of
    site.
    Thanks,
    Randy

    ok I am new please be nice - I think I want to set it up like
    this
    <project1>
    <section>Architecture</section>
    <name>New Building for CREATiVENESS</name>
    <comment>The major challenge to designing this new
    tower was the site constraints  a small 3 acre urban corner site.
    It is located adjacent to a community center to facilitate extended
    use in the evenings and weekends for the entire community.
    </comment>
    <thumb>thumbs/project1.jpg</thumb>
    <img1>images/project1img1.jpg</img1>
    <img2>images/project1img2.jpg</img2>
    <img3>images/project1img3.jpg</img3>
    <img4>images/project1img4.jpg</img4>
    </project1>
    <project2>
    <section>Interiors</section>
    <name>New Building for Me</name>
    <comment>The major challenge to designing this new
    tower was the site constraints  a small 3 acre urban corner site.
    It is located adjacent to a community center to facilitate extended
    use in the evenings and weekends for the entire community.
    </comment>
    <thumb>thumbs/project2.jpg</thumb>
    <img1>images/project2img1.jpg</img1>
    <img2>images/project2img2.jpg</img2>
    <img3>images/project2img3.jpg</img3>
    <img4>images/project2img4.jpg</img4>
    </project2>
    <project3>
    <section>Architecture</section>
    <name>New Building for You</name>
    <comment>The major challenge to designing this new
    tower was the site constraints  a small 3 acre urban corner site.
    It is located adjacent to a community center to facilitate extended
    use in the evenings and weekends for the entire community.
    </comment>
    <thumb>thumbs/project3.jpg</thumb>
    <img1>images/project3img1.jpg</img1>
    <img2>images/project3img2.jpg</img2>
    <img3>images/project3img3.jpg</img3>
    <img4>images/project3img4.jpg</img4>
    </project3>
    <project4>
    <section>Interiors</section>
    <name>New Building for that guy</name>
    <comment>The major challenge to designing this new
    tower was the site constraints  a small 3 acre urban corner site.
    It is located adjacent to a community center to facilitate extended
    use in the evenings and weekends for the entire community.
    </comment>
    <thumb>thumbs/project4.jpg</thumb>
    <img1>images/project4img1.jpg</img1>
    <img2>images/project4img2.jpg</img2>
    <img3>images/project4img3.jpg</img3>
    <img4>images/project4img4.jpg</img4>
    </project4>
    but I am not sure of the way to create the way to run through
    it to find if it is in a section to put it in the menu and then to
    call the images and text once they are in a project area. I dont
    know if the
    this.firstChild.nextSibling.childNodes[0].childNodes[2]
    is the best way to call things in the file. Any help is
    appreciated. Please let me know what are the best practices and
    easiest way to work with a large xml file.
    Thanks,
    Randy

  • Best practice for image inserts

    I am planning to create new webhelp topics and edit existing
    topics in my project. Is it the best practice to place graphics
    files in the same folder as the HTML input files?

    I personally have always avoided the use of folders, maybe
    because most of my projects were large merged projects, which
    already contain multiple project "folders." Also, renaming/deleting
    these beasties later on can be a bear, as evidenced by many
    angst-ridden threads in this forum.
    Let RH place them in its own "virtual" Images folder and
    leave it at that. Unless...do you feel lucky?
    By the way, best practice (at least mine) is to name
    everything (projects, topics, graphics) with no spaces, very brief,
    and possibly with 2- to 3-character prefixes to more easily
    identify them (possibly application features, for example). Such
    as: sa_user_cfg.gif for a screenshot of the User Configuration
    window for System Administration.
    Good luck,
    Leon

  • Best practice for image resolution

    Although my source images files are high quality and look great in photoshop etc when they are viewed within a folio on the iPad the image quality drops. I'm using JPEG high when creating the folio but it still looks pretty blurry. It's OK, but nowhere near as sharp as i feel it could be.
    There seems to be something going during the conversion process that reduces the quality.
    Given that I have some nice, sharp hi-res masters, how should I be putting them in the folios to maximise image quality. I tried creating the folio at the highest quality and there was no difference. I've resaved the images at the size that they will appear in the folio.
    (*bangs head against the wall*)
    Thanks
    M

    I personally have always avoided the use of folders, maybe
    because most of my projects were large merged projects, which
    already contain multiple project "folders." Also, renaming/deleting
    these beasties later on can be a bear, as evidenced by many
    angst-ridden threads in this forum.
    Let RH place them in its own "virtual" Images folder and
    leave it at that. Unless...do you feel lucky?
    By the way, best practice (at least mine) is to name
    everything (projects, topics, graphics) with no spaces, very brief,
    and possibly with 2- to 3-character prefixes to more easily
    identify them (possibly application features, for example). Such
    as: sa_user_cfg.gif for a screenshot of the User Configuration
    window for System Administration.
    Good luck,
    Leon

  • Best Practices for image layout and positioning using anchored frames in Framemaker 10

    Hi,
    I'm looking for the best practices in how to layout my images in Framemaker 10 so that they translate correctly to Robohelp 9. I currently have images inside of Anchored frames that "Run into" the right side of my text. I've adjusted the size of the anchored frame so that my text flows correctly around the image. Everything looks good in Framemaker! Yeah! The problem is that when I link my Framemaker document to Robohelp, the text does not flow around my image in the same manner. On a couple of Robohelp screens the image is running into the footer. I'm wondering if I should be using tables in Framemaker in order to get the page layout that I'm looking for. Also, I went back and forth...is this a Framemaker question or is this a Robohelp question. Any assistance would be greatly appreciated.

    I wish I could offer some advice, rather than simply adding to your question. I think there is something odd that happens with anchored frames.
    I have been going through fits trying to figure out why the placement of my graphics shifts when I run them through Frame 10-to-RoboHelp 9 conversion. The placement in our books is flush left to the body text area. However, when they convert, some are flush left, some are centered, and a very few are flush right. My boss is very unhappy with me, as I have been unable to figure out why this is happening. I didn't create these files, so I don't know if it's something that goes back to how the graphics were initially imported. But I can't figure out why everything looks right in Framemaker, with the frame attached to an anchor tag, etc. but the placement goes hinky when they convert.
    Any insights are appreciated. I'm wondering if it's going to come down to deleting them and recreating the graphic frame.

  • Placing Images (Screen Caps) for Callouts - Best Practice?

    Illustrator CS6, Windows 7
    I'm placing screen captures (screen images from software) in my artwork files to add callouts and create illustrations for a user manual.
    The machine I'm capturing on has a screen resolution set at 1920 x 1080 (required for software). I'm using Snagit and capturing the screens, saving files, then placing in Illustrator. I've been using images minimum 300 dpi and never upsizing in Illustrator. Still I think my results could be better.
    In the past I've used .jpg as my export filetype for placing into Illustrator. But, recent reads of postings in this community lead me to believe my practice might be flawed.
    Question: What is considered best practice for placing images from screen capture (or any source) in Illustrator? What file type from capture will get me the clearest and most adaptable results?
    My Illustrator file color mode is CMYK and my other art and callouts supporting the screen cap are working great.
    I'm creating the artwork for import to Framemaker and creating a PDF for online and print.

    What I mean is; what is the user looking at, and what are you training on?
    For example, if the application involves medical imaging, and part of your documentation covers something like evaluating medical images in the application, that would probably be a far more color-critical scenario than an application in which the user just views and manipulates data.
    Generally, you don't need anything like 300 PPI for screen captures in software documentation. The whole intent is for the image to look like the screen you are documenting, which is something like 72 or 96 PPI at actual size. You might downscale a screen capture as much as 50%, but at that size, the reader is viewing the application's text (including menus,  etc.) at half the size as viewed in the application, which is assumed to be sized for comfortable reading. Sharpness is good. You don't want the images to become blurred in pursuit of completely needless "resolution."
    Also generally speaking, software screenshots are not usually color-critical. Placing (even pasting from SnagIt) directly into the page layout app is usually just fine. PostScript knows how to separate RGB images. Such things have been done since long before anyone sweated blood over "color management." Assuming your application interface is not using garish color (which would be poor interface design; it's tiring), I dare say the conversion of RGB screenshots to CMYK at the imagesetter or press would be fine.
    How is the manual going to be printed? Unless you're talking about a large press runs, nowadays software documentation (subject to frequent updates) is often printed on on-demand presses (think glorified digital color copiers), not sheetfed presses. With software documentation, you're not usually talking coffee-table collector's books. (The exception would be something like a book on color-correction in Photoshop; thus my first question.)
    I routinely paste screenshots from SnagIt directly into InDesign pages to document software applications, and add the callouts in InDesign. Only when I need some special graphics (swooping arrows, etc.) do I assemble the callouts to the screenshots in Illustrator; and even when I do that, I also typically paste the SnagIt captures directly in to AI.
    Keeping your callouts native to the page layout program also better facilitates language translation, when you have to outsource that.
    JET

  • Best practice using clusters to create queue/notifier/bundles ?

    I have in a block diagram a queue, notifier and several instances of bundle cluster
    that all use the same data structure.   There is a cluster typedef for the data structure.
    Of course, each of these objects (define queue, define notifier, bundle)
    need to know how the cluster is defined.
    What is considered best practice?
    1) create a dummy instance of the cluster everywhere the data structure
        definition is needed (and hide them all on the FP)
    2) create only one instance and wire it to all the places it is needed
       But there is no data flow on this wire -- it's only the cluster *definition*
       that is being used, so this would seem to clutter up the BD unnecessarily.
    3) Create only one control instance of the cluster and use local variables
        everywhere else the cluster definition is needed.  It's _value_ is never
        assigned or read so there's no issue with race conditions.
    4) Some other way?
    If you had to clean up someone else's code, how would you hope to
    see this handled?
    It occurred to me in the course of writing this that where I have
    "unbundle... code ... bundle" I could wire the original bundle to 
    both "unbundle" and "bundle" -- but would this be too confusing
    and clutter the BD with unnecessary wire ?
    Thanks and Best Regards,
    -- J.
    Message Edited by JeffBuckles on 11-06-2008 03:17 PM
    Solved!
    Go to Solution.

    Discovered a rather unpleasant side-effect of using the typedef constant cluster this way. Since I'm using the typedef cluster constant only to communicate the definition of the cluster--not for dataflow--I resize it to the same size and shape as a control terminal.  This is shown in the first image, clean_cluster.jpg.   I was also careful to set "Autosizing->None" on all instances of the constant.   However, when I updated the typedef, all instances of the constant resized!  That's dozens of instances across many different VIs.   Why was "Autosizing->None" not respected?  Is there a better way to do this so that my BD doesn't get messed up if I have to update a typedef such as this one?
    Thanks and Best Regards,
    J. 
    Attachments:
    clean_cluster.png ‏2 KB
    Cluster_Updated.png ‏3 KB

  • What are the Best Practices for Optimizing Images in InDesign Files

    Is there a best practice for using images InDesign to optimize the document before converting to a PDF? Specifically, what I'm asking is, will the PDF file compress better if the images are cropped prior to placing them in Indesign? I'd like to know the answer for both creating PDF files for printing using images that are 300dpi and for creating PDF files for online delivery using images that are 72dpi. I have an employee that insists images need to be cropped to actual dimensions before placing in the InDesign document. I've never done it that way and believe that her recommended process is way too time consuming and leaves you with no leeway to tweak your page design since the images are tightly cropped.

    As for absolute cropping, I agree with your stance. Until the layout is fixed, preserving your ability to easily manipulate photo size and positioning is key.
    Some clever image management methods have been described in the discussion forums, and one that appealed most to me was the use of duplicate linked image folders. Having a high-res (CMYK) folder and a low-res (RGB) folder to switch between for different output enables you to use both to your advantage. Use the low-res images for layout, for internal proofing, and for EPUB/online PDF/HTML output. Then it's simply a quick switch to the high-res image folder for print purposes. You can easily prepare the alternate collection of images with a Photoshop batch convert script or with the Photoshop Image Processor. Save your presets!

  • Best practices for placing images in epubs

    Okay, I've read the books, I've watched the tutes and I'm still at a loss on the best way to add images to InDesign 5.5 documents that I will convert to ePub. The images are created in Photoshop at 300 dpi and sized at 800by600. And yet when I place them in InDesign and create the ePub, the images display poorly in ADE and other readers. What is the magic formula for adding images to my ePubs?
    Thanks in advance
    Chris

    Steve/Jongware:
    My thanks for your responses.
    Very good point to look at the images within the epub file. They are 72 dpi images, so it would seem that InDesign is indeed lowering the resolution. I had thought I tried every variation of the available settings within InDesign to avoid this but it would seem to not be the case. If you have any specific suggestions about what setting is causing this, that would be great.
    Viewing the images in the target device is of course ideal. I'm creating this for a wide range of online bookstores, so what device it will be viewed on can't be known. Since ADE drives more than 50 devices, I had hoped that would at least prove to be a reliable base of some sort -- disappointing to hear that ADE can not be trusted in that regard. I had assumed I could proof the book in that before converting to mobi and proofing on a Kindle.
    Why would anyone insert 300 dpi images, you ask? In its publishing guidelines, Amazon says: "To future-proof the content, save images in 300 dpi" Is this then bad advice on their part? Elizabeth Castro echoes this recommendation in her excellent book on the subject, by the way. It's rather difficult to know just what to do, I must admit. But I guess we're still in the early days of eBook creation, with best practices still being in a state of flux.
    Once again, my thanks for sharing your experience.
    Chris

Maybe you are looking for