DITA Best Practices : oXygen Customization Files/folders

Starting with oXygen 18.1 in the Vasont environment, the previous DITA folder (D:\DITA-OT) has been deprecated. All customization files are now located on the Vasont server within:

D:\WKFS oXygen Files

Folder Structure Logic

The folder structure for the customized files is as follows:

D:\WKFS oXygen Files
  └─ ~snippets
  └─ css
  └─ ditavals
  └─ fragments
  └─ images
      └─ icons
  └─ pdf
      └─ com.wkfs.legacypdf-GRC
  └─ scenarios

Folder Structure Definition

FolderUsage
~snippetsContains any snippets of DITA code that can be used within oXygen to simplify frequent actions (example: Expere Changelog simpletable)
cssContains all style sheets (skins) used within the individual transformations. For a more detailed description, refer to the text file in this location: ~Where and when are these used.txt
ditvals

Used as a location to store ditavals that may be used by multiple authors.

Ditavals can be stored in your user Docucments folder if it is only used by you. If you have a ditaval that should be placed here for other authors to use, inform Kel or Todd so that it can be propagated across Vasont servers.

fragmentsContains individual XML files that are used to introduce custom code within the transformed webhelp. These include, as an example, code for google Analytics, Feeddback button, etc.
imagesContains any images used by the transforms, including icons for note elements, WKFS logos and special icons.
pdfContains the files for PDF transformations.
scenarios

Contains all transformation scenario files officially implemented by the InfoDev team. For more information, refer to Importing Transformation Scenarios into oXygen.