I guess the documentation for DocImport is not very clear about how to set up the directory of XML files.
First go to DocImport and click on Options. Set the Books Folder to com_docimport/books
if it's not set to that already.
Using FTP/SFTP or your hosting file manager go into your site's media/com_docimport/books folder. Create a new directory, let's call it my_category
. Move your DocBook XML files and related assets into the my_category folder.
Go to DocImport, Categories and click on the category you have created. In the Slug / Directory field enter my_category
(the name of the subfolder you created inside media/com_docimport/books). Click on Save & Close.
Now DocImport will see your DocBook XML files.
A couple of important points:
- Your XML files must be in DocBook XML format. That's the only format DocImport understands.
- I see that you're trying to have multiple XML files. While this works, kinda, it's not a very pleasant experience. The index page is just a dump HTML list of article titles. It's best to have one big DocBook XML Book document instead of multiple DocBook XML Article documents. You can of course use imports to keep your sections organised as individual files. However, if you do that, you need to put the included XML documents in a subdirectory.
Regarding making DocImport into a paid component, it doesn't really make sense to me. There are a handful of us using it. I'd rather give the occasional advice through our ticket system than trying to create yet another paid product with all the administrative trouble that entails.
Nicholas K. Dionysopoulos
Lead Developer and Director
🇬🇷Greek: native 🇬🇧English: excellent 🇫🇷French: basic • 🕐 My time zone is Europe / Athens
Please keep in mind my timezone and cultural differences when reading my replies. Thank you!