Same Base Directory - Fluid Topics - 3.6

Upload DITA Content to Fluid Topics

Product
Fluid Topics
FT_Version
3.6
Category
Technical Notes

All archives that you send must share the same base directory.

Package structure should be consistent and should always start at the same base directory.

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.

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