Re: Unable to import Robohelp HTML files when using source control

[Rick Stone <rstone75 -at- kc -dot- rr -dot- com>]

Hi all

Just speculating out loud here. But maybe the following is a factor. I 
know that with RoboHelp, things are project specific. I could see this 
being an issue with source control.

Many operations in RoboHelp will affect nearly all the project files. 
For example, adding a folder and creating new topics. As source control 
provides the whole "traffic cop/librarian" functionality, it makes sense 
to me that when working with RoboHelp, only the files you are working 
with are unlocked. (Bear with me here, I'm trying to get to the point.)

Assume three authors are working on a project. Author A has the project 
open and is editing content in topic X. Author B opens the project, 
creates a folder and adds a file. I could fathom that Author A doesn't 
see the folder or topic. After all, their local copy of the project is 
unaware of it. I would think Author A would need to close and re-open 
the project to see the latest and greatest. Or possibly open the project 
and perform a "Get latest version" of all files in order to sync 
everything up.

Again, just some thinking out loud on the issue. Hopefully it's not 
"stinkin thinkin". ;)

Cheers... Rick :)

Amy Gale wrote:
> Deborah Slutzky wrote:
>   
>> Yes, I go through the process without obvious problems, but the file is
>> not put into my project. 
>> I receive no error message of any kind.
>>   
>>     
>
> Sometimes - for reasons I don't fully understand - RH seems to "forget" 
> to write out information about added .html files to the relevant .fpj 
> files, so the information is lost. 
>
> To get around this, try editing the relevant .fpj file directly.
>
> To add newfile.html to your project:
>
> * IF  newfile.html is in a folder that is already in your project, do 
> the following (where fname/ is the folder containing newfile.html).
>
>     - use a text editor to open fname/fname.fpj
>        (unless it newfile.html is in the root directory of your project, 
> in which case open root.fpj)
>
>     - add a new sub-element to the <topics> ... </topics> element:
>            <topic>
>                <name>newfile.html</name>
>                <comments></comments>
>                <frameset>0</frameset>
>            </topic>
>
>     - save the file
>     - leave it open (so you can re-save if RH tries to resist)
>     - open your project in RH. The file should show up under the correct 
> folder.
>
>
> * ELSE try to use the RH GUI to add the folder.
>
>     - IF this is successful, go through the steps outlined above.
>       Note that you will need to replace <topics/> with
>         <topics>
>             <topic>
>                  <name>newfile.html</name>
>                  <comments></comments>
>                  <frameset>0</frameset>
>              </topic>
>         </topics>
>
>   - ELSE
>       ~ use a text editor to open parent.fpj, where parent/ is the 
> folder containing fname/
>          (if fname/ is a child of the root directory of your project, 
> open root.fpj)
>
>       ~ add a new sub-element to the <folders> ... </folders> element:
>            <folder>
>                <name>fname</name>
>            </folder>
>          If the element was previously empty (<folders/>) you will need 
> to expand it.
>
>       ~ save the file
>
>       ~ create  new file in fname/fname.fpj with the following contents:
>          <?xml version="1.0" encoding="windows-1252"?>
>            <rhpml majorversion="1" minorversion="0">
>               <folders/>
>               <topics>
>                  <topic>
>                     <name>newfile.html</name>
>                     <comments></comments>
>                     <frameset>0</frameset>
>                  </topic>
>               </topics>
>            </rhpml>
>
>      ~ save the file, open your project in RH, make sure everything is ok.
>
> (phew)
> A
>    
>
>
>
>  
>
>      
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing 
> solution. Author in Doc-To-Help's XML-based editor,  Microsoft Word or 
> HTML and publish to the Web, Help systems or printed manuals. 
> http://www.doctohelp.com
>
> Help & Manual 5: The complete help authoring tool for individual
> authors and teams. Professional power, intuitive interface. Write
> once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
>
> ---
> You are currently subscribed to TECHWR-L as rstone75 -at- kc -dot- rr -dot- com -dot- 
>
> To unsubscribe send a blank email to 
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit http://lists.techwr-l.com/mailman/options/techwr-l/rstone75%40kc.rr.com
>
>
> To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
> http://www.techwr-l.com/ for more resources and info. 
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
>   
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing 
solution. Author in Doc-To-Help's XML-based editor,  Microsoft Word or 
HTML and publish to the Web, Help systems or printed manuals. 
http://www.doctohelp.com

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot- 

To unsubscribe send a blank email to 
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
http://www.techwr-l.com/ for more resources and info. 

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat