Understanding the RoboHelp project files: XPJ and FPJ

Tuesday, October 30 2012 @ 2:30 PM, By Nandini Gupta

XPJ (XML based project file) is the main file which is used to launch your project in RoboHelp. We will look closely to what this file means to RoboHelp and how this small file unwraps the complete RoboHelp Project comprising several components.

Though all of your RoboHelp’s project content can be managed in GUI mode, it is good to understand how RoboHelp integrates, manages, and stores the complex and vast interlinked project data in an organized way.

As XPJ is an XML based file, you can view the file’s content in any Text Editor. Let’s take a closer look at the content of the file.

Click the image to enlarge it.
XPJ file content

XPJ file content

RoboHelp’s XPJ contains references to all vital elements and it binds all these elements together, and that’s why it is the main project file for RoboHelp.

On the Other hand, the FPJ – Folder Project File, maintains references to all folders present in the Project Directory and maintains the hierarchy and position for each topic element.

Click the image to enlarge it.
FPJ file content

FPJ file content

Each subfolder would further point to the file elements contained inside it.

Broken Links: how and why? Resolve them manually

RoboHelp uses these FPJ files to point to various topic/folder elements in your project. When you have a broken link under your project manager or any folder/file item present in Project Directory is missing, it is because the FPJ file has lost its reference while loading/processing content.

You can manually edit the sections inside it to get the correct file references in RoboHelp again.

For example, in the following Folder Structure, if you have ‘Chapter 3’ as missing, you can reinsert that by using the below highlighted (Blue) syntax, which is the standard nomenclature, FPJ follows to point to a file.

Click the image to enlarge it.
Links and References

Links and References

The block identifies Topic, Name, Comments, and FrameSet. You can manually specify these values to get the Project Manager ‘find’ the ‘missing’ file back. Therefore, if the Resolving broken links using the Tool menu does not work out, you can carefully edit the file and restore the links back.

Note: It’s recommended that you keep a backup of the project file before editing the file manually in a text editor. Also ensure that RoboHelp application is not running when you edit the file.

 

Submitted by: Anjaneai Srivastava, Tech Support Consultant

COMMENTS

  • By iteec - 4:54 PM on October 30, 2012  

    ya it very help ful for me . this site also have more idea about this http://isearchr.blogspot.com/

    • By Anjaneai - 2:27 AM on November 1, 2012  

      Thanks a lot! :)

  • Categories

  • Archives

  • Authors

  • Useful Links

  • Recent Comments

    • Joel: Thanks for fixing the links guys!
    • Maxwell Hoffmann: Ted, one aspect of the blog that may have escaped your notice; you can launch the HTML5 version in...
    • Maxwell Hoffmann: Joel, per comments made above, I discovered that the original URLs were incorrect with pointers to...
    • Maxwell Hoffmann: Paul, as I indicated in the comments below, the original blog had links that pointed to a...
    • Maxwell Hoffmann: I apologize to all concerned regarding my suggestion to “clear the cache” … it...