Same Base Directory - Fluid Topics - 3.6 - Technical Notes

Upload DITA Content to Fluid Topics

Product
Fluid Topics
FT_Version
3.6
Category
Technical Notes
audience
public

All archives must share the same base directory, and package structure should be consistent.

Having all folders and subfolders is not mandatory in the archive. However, if a resource is present, all its parent folders up to the base directory should also be present.

Attention: When referencing an image, it is necessary to use the path of the file in the archive.

Example

If your workspace is the TechDocs folder, and it is organized like the following tree, your archive should start at this TechDocs base directory ("/").

/
├─── Content
│    ├─── Docs
│    │    ├─── Time-Machine-101.pdf
│    │    └─── Time-Machine-Maintenance.pdf
│    ├─── Topics
│    │    ├─── Disclaimer.xml
│    │    └─── Time Machine
│    │         ├─── ChangeBattery.xml
│    │         └─── ChangeTimeCapacitor.xml
│    │
│    └─── Map
│         └─── document.ditamap
└─── Images
     
└─── Time-Machine-OD1000.png

For future uploads, you can omit low-level folders if they do not contain new or updated elements. Here is the structure of a package you can send after the previous upload to add two documents and update one:

/
├─── Content
│    └─── Topics
│         ├── Disclaimer.xml
│         └── Time-Machine
│             └── SwitchOn.xml
├─── Images
│     └─── Drawings
│           └── Time-Machine-Parts.svg
└─── Map
└─── document.ditamap

If all items of an upload are located in a subtree of the base directory (for example, in our previous use case, if only topics from Content/Topics are sent), it is possible to specify the relative location of this subtree (from the base directory) and upload only this subtree.

Example

/
└─── Content
     └─── Topics
          ├── Disclaimer.xml
          └── Time-Machine
               └── SwitchOn.xml

The above files can be sent as the following archive, with subTree = Content/Topics:

└── Disclaimer.xml
    └── Time-Machine
        └── SwitchOn.xml