Importing MS Word into RoboHelp HTML / TOC Creation/ CHM output?
Hello,
I am a newbie to RoboHelp 8 and am trying out the Adobe Technical Communication Suite 2.5, and have a Windows 7 (64 Bit) OS.
At the moment, I have a single 40 page word document (MS Word 2010) that I would like to bring into RoboHelp 8.
With that said, I create a blank project, and then import the document. But, when I try to generate and view a help file, I am not seeing the table of contents. I have even done the AUTO TOC and verify that the links correspond to sections and sub-sections etc. - but still no TOC.
In addition, for some reason it brought in each of my figures twice, so that I have two figure 1s, two figure twos and so on.
Finally, it gave me an error message and was complaining about WidgetMax:
"Compilation failed while compiling http:\www.widgetmax.com."
I am not sure what that is about either.
Okay, one more question. Is there an easy way to break up all the sections/sub-sections into unique topics before or during inport into RoboHTML? It seems that RH 8 really needs to have multiple topics versus one long topic, containing what was formerly a MS Word document. What is the best approach to making that happen?
Overall, I am looking for a nice automated system, whereby I can take developer created documents (from protected MS Word templates) and bring them into RoboHelp HTML (version 8). Hopefully, I will not have to break apart the entire MS Word document first, before bringing it into RH 8.
Thanks for taking the time to answer the questions from a newbie.
-J
Hi there
My own guess is that you created a project using one of the supplied templates. Specifically, the Application Help template. This template already has a CHM window defined that contains a link to the WidgetMax.com site. When a link to a web site is defined in a CHM window, the compiler will squawk about it because it cannot resolve the link to a local HTML page. So you may safely ignore the message.
As for importing the Word content, you have some decisions to make. How do you want to edit the content after you get it into RoboHelp?
After you import you will abandon Word and make any changes to the documentation only using RoboHelp HTML.
You will continue to maintain the Word document using Microsoft Word and you will want to update RoboHelp HTML to reflect the changes
Depending on the avenue you wish to take, you will have different options for splitting the Word content into individual topics. Once we know which option you wish to use we can offer more guidance.
Cheers... Rick
Helpful and Handy Links
RoboHelp Wish Form/Bug Reporting Form
Begin learning RoboHelp HTML 7 or 8 moments from now - $24.95!
Adobe Certified RoboHelp HTML Training
SorcererStone Blog
RoboHelp eBooks
Similar Messages
-
Import InDesign files into RoboHelp HTML
Hello,
My company is moving toward online help. We currently use InDesign to author our manuals and then export them to pdf for publication. I've been on the phone with Adobe trying to see if there's a way to easily import InDesign into RoboHelp. We're on an older version of RoboHelp, so I'm told this is possible, but I can't get any help until we buy RoboHelp9. I know that we can import our pdfs into RoboHelp--I'm just wondering if there's a way to import InDesign files directly into RoboHelp. Has anyone tried to do this? Anyone have any suggestions? It seems these two programs should play nice together, doesn't it?
LouleyHi there
To my knowledge it is not possible to accomplish. I've been using RoboHelp since 1992 and I've never seen it done.
The only way I can fathom it working would be if InDesign could save as an HTML page. Then import the HTML. Or possibly produce a PDF from InDesign, then import that. But even importing the PDF may not give you the results you want.
Cheers... Rick
Helpful and Handy Links
RoboHelp Wish Form/Bug Reporting Form
Begin learning RoboHelp HTML 7, 8 or 9 within the day!
Adobe Certified RoboHelp HTML Training
SorcerStone Blog
RoboHelp eBooks -
Problems importing a Word doc into Robohelp HTML
I have a 116-page Word document with 13 chapters. When I
import this document into Robohelp HTML as a winhelp output file,
only two topics are created, rather than 13. On the Conversion
Options window, I select to have new topics created by Word style
"Heading 1" which are my chapter titles. Why doesn't Robohelp
create the topics, and what should I change to faciliate that?
Also, why don't my numbered lists from Word stay numbered in
Robohelp? Is there a way to automate numbered lists?Thanks for your reply.
When I insert .gif files JDeveloper ends with a message saying "Process exited with exit code 0". I then go and check in the database and I find the image added to the table.
With a word doc, JDeveloper does not give that message. No message at all regarding what the status of the process is. And the document is not added to the database. No error messages too. Could this be an issue with Oracle? -
Importing pdf into RoboHelp HTML 8.
I get an "unsupported or corrupted file" error when trying to import a pdf as a topic into RoboHelp HTML 8. The file opens fine in Acrobat.
I've done that also. However, one of my help projects consists solely of pdfs from other sources. I've found that the print method works best for me.
Thanks for the tip, however. It's good to know that someone looks at the responses.
Holly
Holli Angell
Business Analyst II
Blue Cross and Blue Shield of North Carolina
Madison Park Operations
336-201-4520
>>> NorBec <[email protected]> 11/6/2009 4:27 PM >>>
What about importing the pdf in your baggage files? The trick here is getting the project manager to display the Baggage Fle folder. Toggle the icons at the top of the Project Manager window until they display. See this thread below for the import instructions.
http://forums.adobe.com/message/2068543#2068543 -
Converting RoboHelp for Word to RoboHelp HTML (v8)
I have a RoboHelp for Word (started at v6, converted to v7, and now at v8) project that I want to convert to a RoboHelp HTML v8 project.
The RoboHelp for Word V8 looks good, works great and builds good looking WebHelp and MS Html Help finished outputs! But, I can't seem to figure out how to embed Captivate App Demos (SWF) into the project. Another post in these forums indicated that this is easy with RoboHelp HTML; and after some testing, indeed it is! Great.
Now - the question is, how do I get my existing (looks good, feels great) RoboHelp for Word V8 project imported into RoboHelp HTML V8?
I made a copy of my RHWord project directory (so as not to screw anything up) and then opened RHHTML and chose to import an existing HPJ project. When asked whether to keep the project file XPJ or go to HHP, I chose HHP.
During the conversion, I get lots of "images not valid; invalid chars" on GIF files that RHWord has no problem with. It will not display nor publish these GIF files. Actually, it does display some of the GIFs in the RHHTML dev env, but then doesn't publish them!
Also, during the conversion, it asks if you want a single CSS for each file or one CSS based on one of the WORD docs from the RHWord project. The default was the former, so I chose it. After the conversion, many of the topics have CSS data that appears at the top (e.g. long list of font names) that end up getting published also. So why did this happen?
Also, after the conversion, many of the topics have non-displayable characters that do not show up in the RHWord version; source or published version.
So - my question is, how do I correctly go from a RHWord project that seems to edit and publish just fine to a RHHTML project cleanly?
I have tried to be as detailed as possible on each of these issues, but if more is required, let me know.
Thanks much for your assistance,
Jeff
Message was edited by: jonestechThe original post included a complaint:
"After the conversion, many of the topics have CSS data that appears at the top (e.g. long list of font names) that end up getting published also"
I didn't spot an answer to this part of the problem. I may have missed it
I see this also in importig a RH8 WinHelp project for conversion to WebHelp. It's no big deal to just delete the font list in projects that have just a single original Word doc, but I have a number of projects that each contain hundreds of Word docs, and the font list is inserted tt the top of each converted htm file.
So I am motivated to find a solution...
Any ideas RH troops??? -
Adobe Technical Communications Suite - Importing Framemaker Files into Robohelp
We have just started using the Adobe Technical Communications
Suite to import our Framemaker files into Robohelp. (We have about
a year’s experience of taking Framemaker files into Web Works
Publisher, with good results so we were hoping for a similar
experience with Robohelp).
Please can you help us with the following two problems:
1. Importing FM files into Robohelp has posed some immediate
table formatting problems. We imported the FM files by reference
according to the instructions but cannot format the tables, ie.
Colors etc.
2. Can you also tell us if there is a way to set up our
graphics in Framemaker to import into Robohelp without first having
to run them through a batch file scenario to change the size for
online help. Also, can you explain why the imported graphics are
being put into separate folders in Robohelp – is there a
system option where we can stop this from occurring.
We are a little frustrated because we are long-time users of
Robohelp and Framemaker and are finding some of the new features of
TCS are not as helpful as we first thought. I am sending these
questions after spending several hours going through the Robohelp
Help and the Adobe website and not finding the answers.
Thanks for your help,
Asra S.I have purchased the Technical Communications Suite and am
working with it now. I am finding several short comings in the
product – 60% great product and 40% not so great. I have been
using FrameMaker and RoboHelp for about 11 years and also I am a
Webworks (ePublisher) user. I was expecting (at a minimum) to have
the same functionality as ePublisher in TCS - ePublisher works
seamlessly with FrameMaker. Quadralay worked with me the first
month to answer my questions to ensure I was pleased with the
product - and welcomed/appreciated my feedback. In some cases they
provided me with scripts to accommodate my needs. I am finding on
message boards and forums that a lot of users as very disappointed
with your product so far. Are there any plans on
improving/enhancing the product to accommodate our basic requests?
The standard answer we get concerning graphics and tables is
to use conditional text. This is not single-sourcing and is a
horrible recommended work-around – a hack if you will. We use
conditional text to handle differences in program functionality. I
understand there is some set up required when you create a new
project in RoboHelp, but after that I would like to run the Batch
File process to simply generate my newly updated FM files to online
help. How efficient is that? VERY!
I have provided a list of the basic missing
functionality/oversights that would greatly improve the product and
satisfy a lot of your current users. Some of these issues may be
user misunderstanding and in that case I seek guidance on what
I’m doing wrong. Take the other issues into consideration
because these are not just my issues, but a TON of your users.
Hopefully you are user focused and are as concerned as we are.
Please welcome this feedback as a way to improve the product.
- No Breadcrumbs supported with MS HTML Help - supported in
your other outputs and is available in ePublisher, so it must be
possible.
- Table formats are not configurable – why? Sometimes
the converted table format from FM isn’t 100%.
- Imported file structure (folder for each chapter) totally
hoses my fix to poor graphic rendering. Currently I use a batch
file to run a Photoshop macro/action on my graphic source files to
reduce the file size by 50% and sharpen. I replace the graphics
with my graphics and they look marvelous in online help. I copy my
source graphics back into my “graphics folder” imported
into FM at 260 dpi for my printed docs. Can we have the option on
the structure for imported FM files to put them all into one
folder?
- Text entered into the Auto numbering field is not converted
when importing by reference. It is when just doing a straight
import. This is used for standardizing my inserted tables with
pre-populated column titles– Troubleshooting, If/Then, etc.
- Too many CSS issues. It would be nice to have one main
template that we can sync to when the master template is changed.
- Can’t specify a default template to apply to all FM
files when imported.
- My output .chm file is not picking up my Project Settings.
It will not display Favorites, My Window Size, it’s not
showing the TOC.
- Cross-references – sometimes they work and sometimes
they don’t.
- Markers – we use markers for glossary terms and the
character tagging carries forward throughout the rest of the
sentence.
I started testing the product four days ago and these are the
major issues that are keeping me from moving forward with my
overall plan to move to structured FM. I’m now between a rock
and a hard place because now my department does not have the
software to do their job. Do I go to management and tell them that
I made the wrong decision in my tool selection? I choose your TCS
over the updated Quadralay ePublisher that works with FM8…
Maybe they went up on their price because the knew their former
users would come back and be willing to pay the increased price for
their software that generates online help with just a click of a
button.
Thank you for taking the time to read this and for your help
in advance. Please direct these concerns to those in charge of
enhancing the product (Product Evangelist). A reply and technical
support is greatly appreciated.
Director of Technical Publications - Horizon Software
International, LLC
Nikki Bridwell -
When I try to import .pdf forms into RoboHelp 11, the fields get garbled.
Is there any way around this?Hello again
Okay, you first open or give focus to the Project Manager pod. Once there, you will either be in Global View (where you see all files combined - CSS, Images, HTM and others) or you will be in Classic view. Classic View has separate folders, One for HTML files, another for CSS, another for Baggage, etc. See image below for reference.
If you are in Global view, just right-click somewhere inside the Project Files and choose New > Baggage File. If you are in Classic view, right-click the Baggage Files folder and choose New > Baggage File.
Then you navigate to where the Baggage File exists and you add it to the project. When you generate, the Baggage File should be automatically copied to the output folder with the other files.
To link to the Baggage File, you generally select the text or image the user will click to display the file, then click and drag the file from the Project Manager pod to the selected image or text.
Or, if you wish to leave the PDF where it is on the web, just determine the URL that would open it. Create a hyperlink from an image or text that will open the file.
Cheers... Rick -
Importing Adobe Captivate into Robohelp 6
When I try to import Captivate files into RoboHelp it seems
like the import was successful, but when I try to view it the
screen is blank. I any new to working on Captivate as well, but I
beleive everything is ok on that end.
Any ideas?Hey Colum,
Thanks for your help, but I still seem to be having
difficulty.
I am using RoboHelp HTML 6 for my project.
Here is what I have done:
Created my Captivate file & saved it.
Imported the Captivate file in my Baggage Folder.
Problems are:
When I double click on the file in Baggage it opens up
Captivate.
I then tried to import the same clip into a New Topic, but
again all I get is a text box saying Flash Movie File. I compiling
the porject, but when I try to click on the topic with the
Captivate file, but the page freezes. When I mouse over the text
box it says "Click to activate & use this control."
Any help would be great.
Thanks -
Missing spaces between words after importing Word document into RoboHelp HTML version 8
I created a 400+ page document in Word 2007 and imported it into RoboHelp 8 (HTML, not RoboHelp for Word). In many places, the space between a bold word and a non-bold word is no longer there. I would like to avoid having to go through the entire RH document to replace the spaces manually. Did I import incorrectly?
Looks perfect, works terribly...
Things to consider:
Chances are, the different treatments of the space are due to whether the space was included in the bolding of the word in MS Word.
Additionally, since Word files contain much underlying binary code (macros and such), your security settings might or might not be playing well with the Word stuff.
Are you importing the Word file from a network location, or from your local machine? Network traffic might be partially impacting the import, too.
Bottom line? You'll probably need to clear all formatting in the Word file and redo the formatting properly. To test this, cut a couple of pages into a new Word file, clear and redo the formatting in Word, import the Word file into another RH project, and see what results you get.
To clear the formatting:
Select text.
On the Home tab, in the Font group, click Clear Formatting.
Redo the formatting, being careful to not format the spaces.
Good luck,
Leon -
Hi,
I am using Robohelp for the first time. I want to generate help pages for an application. I have all the contents prepared in Word document. I tried to import the word document into robohelp, however the whole content gets inported into single page. Is there any way this gets separated out in separate pages, or is it that I would need to prepare separate documents so that they are imported accordingly. Has anybosy faced this issue. I am using the 30 day trial version of Robohelp 8. Has anybody an idea about this and the possible solution for this.
Thanks,
PallaviYou need to click the Edit button when you import, as shown in the first image.
The document will then be scanned and the next screen will be displayed, as in the second image.
One by one, highlight the styles on which topics are to be created and tick the Pagination field.
When you import, you will then have separate topics.
See www.grainge.org for RoboHelp and Authoring tips -
Hi all,
In the past when importing a word doc I was able to select to
import each topic as a seperate html file. I'm not seeing that now
and I am also missing the option to create topics based on
Heading3. Which is funny because it has Heading 1,2,4 and 5 listed,
but not 3? Any thoughts as to why this may be happening or how to
fix?
Thanks,
JRHi JR
Nah, looks like the right area to me.
Besides, most of us that participate here already watch ALL
the areas, just in case. So the odds of a post not being answered
because they are in the "wrong area" are lower than whale poop. And
that's about as low as I can think of.
Well, aside from the bottom of the Dead Sea.
Cheers... Rick -
Why Pick RoboHelp for Word vs RoboHelp HTML?
Getting started with RoboHelp. Everyone in our office knows
how to write in Word. Are there big advantages or disadvantages to
choosing to use RH Word vs RH HTML to work in? I want to avoid
kicking myself two months down the road.Welcome to our community, WJohanRadGuy
I suppose I would counter that with:
Why drive a truck when you can drive a car?
Here's what I mean. Think of the output you are planning on
creating. Most of the output today falls into the HTML category.
Assuming that's the case for you, you would be well advised to use
a tool designed for working with HTML. So just as I wouldn't use my
car to haul plywood when a truck is more suited to the job, I would
opt for RoboHelp HTML over RoboHelp for Word.
I know it's seductive. Most everyone thinks they know how to
use Word. But if you are creating any type of HTML output, you will
likely find yourself hamstrung with making things behave as you
want using RoboHelp for Word where they are easy to accomplish
using RoboHelp HTML.
Also consider that the RoboHelp for Word user base is
shrinking daily as more folks move away from it (because it is the
only RoboHelp product that creates WinHelp systems) and toward
RoboHelp HTML. Vista prompted much of that exodus when Microsoft
announced WinHelp would no longer be supported in Vista. Yet it
lives on and I digress.
Hopefully I've not muddied the waters here.
Cheers... Rick -
"RoboHelp for Word" vs "RoboHelp HTML"
Hi all,
I note there are two flavors for RoboHelp (wrt also working
with Word + importing + exporting):
- RoboHelp for Word
- RoboHelp HTML
Questions:
1. Am I right that it seems you can do everything with
RoboHelp HTML that you can do with RoboHelp for Word?
2. If not (1, above), what are the relative advantages and
disadvantages of each for starting a new RoboHelp project?
3. Is there a reason for ever trying to change application
for an existing RoboHelp project, and would there be expected any
particular conversion problems?
Tia,
- aviWelcome to our community, Avi
I see you posted the question here as well as the TechShoret
list. I further see you have at least one reply over on TechShoret.
Here are my thoughts. Yes, you can do most of what RoboHelp
for Word can do using RoboHelp HTML. I say "Most" here because
there are a couple of things you can't do. You can't easily create
a .HLP file using RoboHelp HTML. RoboHelp HTML doesn't offer tabs
like you can use with RoboHelp for Word.
Now I realize that may sound a bit as if I'm saying that
RoboHelp for Word is superior to RoboHelp HTML. I'm not. As with
anything in life, there are trade offs and things to consider. In
this case, I would say you should consider the output type.
Most everything is moving away from WinHelp (.HLP files) and
toward an HTML based format. I noted the TechShoret reply mentioned
that with RoboHelp for Word, everything is stored in a single Word
file, vs having multiple HTML files with RoboHelp HTML. While this
is true, I would say that if your output is going to be HTML based,
you should seriously consider using an editor that was designed
from the ground up to support HTML. Let's face it. Anything HTML
coming from Word is a kludge, as Word was designed for print. There
are also some things that will constantly frustrate you if you
elect to use RoboHelp for Word and are creating HTML output.
So while it may seem an attractive option to use, I'd suggest
avoiding RoboHelp for Word and going with RoboHelp HTML.
Sincerely... Rick -
Trouble incorporating Captivate movies into RoboHelp HTML projects
This is for RH 7 HTML.
I have been trying for quite a while now to add some Captivate tutorial-type videos to my help projects. I have recently been able to do this, however, the video additons greatly increased the size of my help file (it went from probably 7 or 8 MB up to 29 MB).
Here's how I added the movies.
Created a new topic just for the multimedia movie
Inserted the video (which was saved as an .SWF - Flash - file, since this is what the help file instructs you to do) and added it to the new topic
Created a link to this new topic in the topic from which I wanted to launch the video and chose to have the video open in a new window
Saved everything and tested it out to make sure the video would run when called
The video runs OK, though it is a little on the large side and is still a bit blurry/fuzzy. I've also had to provide special instructions to any users who wish to view the videos (maximize the RH display window, make sure the resolution on the monitor is set to at least 1024 x 768, choose to allow blocked content if prompted, etc) So, the main questions I have are,
What's the best way to add these videos to a help file without having the file size go through the roof and so they'll still display properly (clear and legible)?
Is there a smaller, more compressed format that can be used that will still allow for a clear display?
Should I embed the videos in the actual help file or place them somewhere else and link to them externally?
I would greatly appreciate any insight, advice, and expertise in this area, since my manager is a huge proponent of having these videos incorporated into the help files.
Thanks very much in advance for any guidance you can provide.
Sincerely,
DaveHi Dave
Hopefully Willam won't mind my chiming in here.
When you publish a project from Captivate as SWF, you also have an option to allow Captivate to create an HTML page for you. In fact, the option is typically enabled by default and you have to specifically disable it. At that point Captivate warns you that the movie may not display correctly if you do this.
So if you want the HTML page all set up, you just leave that option selected in Captivate. Then in RoboHelp, you import both the Captivate created HTML page as well as any files such as SWF or FLV you need.
Hopefully this helps... Rick
Helpful and Handy Links
RoboHelp Wish Form/Bug Reporting Form
Begin learning RoboHelp HTML 7 or 8 within the day - $24.95!
Adobe Certified RoboHelp HTML Training
SorcerStone Blog
RoboHelp eBooks -
Importing .htm files into RoboHelp project
In my project in RoboHelp, when I go to File > Import > HTML File… to add a .htm file to my project, it locks up on me instead of providing a directory listing allowing me to select files to add to my project. The only way to get out of it is to go to the Task Manager and killing the process.
Hi there
Your use of "The Vault" would seem to most certainly describe some form of a Source Control system. Source Control systems offer a combination between a Librarian and a Traffic Cop. Typically you log into these systems with a user ID and a password. That way the system knows who you are.
Typically with these systems the data resides on a coroporate network. And also typically you will have a "working folder" on your hard drive where the files exist. When everything is checked into the Source Control system, the files on your hard drive are flagged as "Read Only".
When you need to work with a file, you perform a process of checking out. The Source Control system then changes the Read Only status of the file on your hard drive to Read/Write. But it also makes a note of the date/time stamp. If the file stored in Source Control is newer than the counterpart on your hard drive, it copies the newer file to your hard drive before allowing you to make changes.
I'd begin with a simple sanity check. Create a totally separate and new project. Add a topic or three. Add an image. Generate. Do things work okay? If not, you have some form of issue with RoboHelp that needs to be resolved before you attempt to troubleshoot what is happening with your project in Source Control.
Perhaps try copying the content from Source control to a different folder and see if you are then able to make edits.
Hopefully something here either helped directly or sparked a thought that does.
Cheers... Rick
Helpful and Handy Links
RoboHelp Wish Form/Bug Reporting Form
Begin learning RoboHelp HTML 7 or 8 within the day - $24.95!
Adobe Certified RoboHelp HTML Training
SorcerStone Blog
RoboHelp eBooks
Maybe you are looking for
-
Same here, 4s working perfectly, downloaded update 8.0.1 Now no wifi or bluetooth or hotspot. Control on/off icons are muted in colour and don't respond. Tried resetting network connections then total restore, didn't work so still have the same probl
-
Hard disk not detected on Satellite Pro 4270
I took out the 2"5 hard disk from my SP4270 to transfer data to my PC through a 3"5-2"5 EIDE adapter, the HD was detected by my PC bios and the transfer was successful. Then I reinserted my hard disk into the 2"5 notebook bay, but I get a "Insert sys
-
IOS 8.3 does not mark e-mails as read.
Hi all, I couldn't find anything in the forums, but I wanted to see if others are seeing the same issue I am. After upgrading, when I open up an email and then go back to my list of emails, the blue dot (message read notification) does not disappear.
-
Need Help with new Classes / methods
Hi, I need to create a class called Proposition. It include a Proposition object with 3 variables Name, Description, Value This is the constructor I wrote: private String name; private String description; private boolean value; public Proposition(){
-
Unable to even see the link of install now on the installation page
i am trying to download reader and flash but i dont see the install now button/link. i am sure to be at the right page but the link cant be seen. i am trying to use chrome to see flash based tv shows but the loading circle keeps circling. also unable