Page 1 of 1

Documentation: Expand info for Logical Folders

Posted: Wed Feb 17, 2016 2:12 am
by RBVanDyke
For oXygen XML Editor 17.1

I'm a relative oXygen 17 newbie who has encountered the concept of Logical Folders via wanting to apply an XSL Transformation Scenario to multiple XML files:

https://www.oxygenxml.com/doc/versions/ ... ation.html

ONE -
I think it would very helpful to expand the information about logical folders to, at a minimum, explain the limitations that apply to their use within a project's documents tree. Evidently Logical Folders can (a) only be created at the topmost level of an oXygen project, and (b) cannot then be repositioned into a sub-foldler contained in the project's folders hierarchy(?) Note that I'm not sure that Logical Folders cannot in fact be repositioned, I've only inferred it after trying and failing to move a Logical Folder into the project's files hierarchy. Thu I think it would be helpful for the documentation to provide a bit more explanation about what can and cannot be done with Logical Folders.

TWO -
By extension, would it be possible / useful to enable Logical Folders to be positioned within a project's files hierarchy? This isn't a show-stopper for me in any way, but my sense of tidiness makes me want to create a Logical Folder in that part of the project where (at least in this specific instance) the XML files I want to batch transform are located. So if that capability became available I'd find it handy -- but again, it's not a show-stopper...

Cheers, thanks, & hope this helps,
Riley
SFO

Re: Documentation: Expand info for Logical Folders

Posted: Wed Feb 17, 2016 11:22 am
by adrian
Hello,

1. The explanations you seek are project related so they can be found here:
Oxygen XML Editor 17.1 - The Project View
Logical folders - marked with a blue icon on Windows and Unix/Linux and a magenta icon on Mac OS X. They help you group files within the project. This folder type has no correspondent on the physical disk, since they are used as containers for related items. Creating and deleting them does not affect the file system on disk. They are created on the project root or inside other logical folders by using the contextual action New > Logical Folder. The contextual menu action Remove from Project can be used to remove them from the project.
So, logical folders can only be created inside (or moved to) other logical folders. The topmost level (project root) is also a logical folder. So you can create a hierarchy of logical folders, not just on the top level.
You cannot create or move a logical folder inside a file system (linked) folder. The file system (linked) folder lists the files and folders from the file system.

2. Allowing logical folders within file system folders could lead to a lot more confusion. The problem is you can then link other files or folders from the file system within these logical folders and soon things will get out of hand. By design the links to file system folders and files are meant to be leafs of the logical model of the project.
If you want to group things together in the project, it would be preferable to create a logical folder (hierarchy) and link within it the file system folders (or simply the files) with your needed files.

Regards,
Adrian

Re: Documentation: Expand info for Logical Folders

Posted: Wed Feb 17, 2016 8:48 pm
by RBVanDyke
Thanks Adrian!

Riley
SFO