Skip navigation
Currently Being Moderated

Importing .htm files into RoboHelp project

Jul 13, 2009 9:08 AM

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. 

  • Currently Being Moderated
    Jul 14, 2009 4:51 AM   in reply to jbolin

    As to the "locking up," your environment is probably the issue:

    • You must install RoboHelp on a local machine, as a user with full admin rights.
    • To be edited, your RoboHelp projects must be on your local machine (only store them on a server for backup). They should reside as close to C: as possible, and never under My Documents.


    As to the "other user" .htm files:

    • How are they being produced? If they are Microsoft-based files (.doc, .xls, etc.) and are being converted to .htm, that might create problems.
    • Are you copying them to your project folder on your local machine before importing them? That's usually best.



    Good luck,


    Mark as:
  • Currently Being Moderated
    Jul 15, 2009 9:37 AM   in reply to jbolin

    Either the "others" are doing something different, or your IT peeps (here and/or there) are doing something different. Things rarely "just start[ed] happening," such as files becoming read-only.


    I suspect that perhaps the IT folks have introduced some strange processes into the environment. For example, the "Vault" might be a "virtual network," or some other network-like environment that messes with the Access database that RoboHelp uses to keep track of all its project elements.


    Another point: you're not trying to import output files from them instead of source files, are you? They, and you, may be unaware that this is unacceptable.


    When you say you check out and check in the files, are you all using a source control product? If so, the projects, and that product, might not be setup properly.


    You might have to acquire a good Diff product to run comparisons and then only replace changed content, instead of continually importing files over and over.



    Good luck,


    Mark as:
  • Currently Being Moderated
    Jul 21, 2009 3:33 PM   in reply to jbolin

    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

    Mark as:
  • Currently Being Moderated
    Jul 22, 2009 5:30 AM   in reply to jbolin

    You say: "He does not have any trouble with importing files and I didn't have any trouble until @ 2 months ago. I would think if the IT department did anything differently, my India counterpart would be having the same issues."


    Think about that a bit more, instead of shooting down every suggestion provided to you so far. What makes you so certain that your environment and your counterpart's environment are exactly the same, and that your IT peeps didn't mess up somewhere? What makes you so certain that some cosmic RoboHelp failure is the reason that this situation "just started happening"?


    • I'd seriously inquire whether the IT peeps changed some of the settings in your use of SourceGear Vault.
    • Was a new anti-virus software introduced (or the old one upgraded or re-configured), and is it wreaking havoc with your RoboHelp files?
    • The other issue I would look at is your earlier comment about "where all files are sotred[sic] (dev. included)." I would strenuously object to any source control solution that is designed for storing both development code and your help source files. That can only end badly.
    • Another issue is that there are at least 4 RH project files that should not be included in the source control environment: .cpd, .hhp, .ldb, .pss. Check on that.
    • As to the "read-only" issue, a file in source control is always read-only until it is "checked out" (or whatever terminology SourceGear uses for that function), at which time it becomes writeable.


    The thing that continues to confuse me is your use of "importing" files that have been added/edited by your counterpart (and apparently vice versa). If such a file has been added/edited within the RoboHelp project at his location, and subsequently checked in to the Vault, why aren't you just checking it out (into your local version of the RoboHelp project) at your end?


    Good luck,

    Mark as:
  • Currently Being Moderated
    Jul 22, 2009 10:32 AM   in reply to jbolin
    • Your India guy creates a new file, and adds it to the Vault, but not within a RoboHelp project?
    • Does your India guy add a source file or output file to the Vault?
    • You then check out the file directly to your project folder, or some other location on your computer?
    • You then open the RH project and try to import the file, and RH freezes?
    • Why would you delete those four files in your project as well as in the vault? I thought the RH project wasn't in the Vault? (Those files are machine-specific; that's why they don't belong in source control.)


    Resent this or not, but it appears that your organization has developed a process that doesn't seem to conform to best practices for either RoboHelp or any common source control product. Once you've collected the information you've requested from your IT peeps and your India guy, try to spell out for us an exact progression from India to you.


    What normally happens is this:

    1. The RoboHelp project gets added to source control from within RoboHelp (it knows what files not to add), probably from your end.
    2. Users set the local path on their computers to match the source control folder.
    3. Users open the project in RoboHelp, check out/edit/check in files.
    4. Other users open the project in RoboHelp, check out/edit/check in files.


    At no time should it be necessary to import files, uninstall/reinstall RoboHelp, manually make files writeable, etc.



    Good luck,


    Mark as:
  • Currently Being Moderated
    Aug 3, 2009 1:21 PM   in reply to jbolin



    I was reading your post and something caught my eye because I had a similar thing happen to me.  We use a system called Documentum (sounds very similar to what you are using) and what was happening was the person checking out the document on the other end wasn't actually saving it to his hard drive even though the document was "checked out" of the library.  We never did figure it out completely, but we now have a rule in place that after you check out a document, you have to do a File/Save As into a work directory.  You don't have the change the file name, you just have to know it's truly open on your computer.  Then when you are finished and you check it back in.


    Also, the other thing that occurred to me is it sounds like it could be a "permissions" issue.  If it started going wanky 2 months ago, perhaps something else changed on the back end which you may not be aware of.  Network patches and upgrades to servers can change things in your working environment and you may not even know about it.  I know at my company, they've been consolidating servers and while there is not supposed to be any effect on the backend, because it's simply a different server and not identical to the original server, something could be different than your original working environment.


    Just some food for though.  Good luck

    Mark as:

More Like This

  • Retrieving data ...

Bookmarked By (0)

Answers + Points = Status

  • 10 points awarded for Correct Answers
  • 5 points awarded for Helpful Answers
  • 10,000+ points
  • 1,001-10,000 points
  • 501-1,000 points
  • 5-500 points