Hi, we are using DocumentX 5 to generate XML schema documentation, and some of the output .html files exceed the 260 character file name limit. I was wondering if there is any setting that would generate shorter file names, perhaps by using a shorter separator than !@! ... Thanks, Michael
Date
Votes
4 comments
-
Permanently deleted user You could try generating output to a short path (e.g. c:\docs). Do you know if it is it the topic filenames that are the problem, or the diagram filenames?
-
Michael Thanks for the reply, Richard. Yes, we've moved the output folder up a few levels, in order to shorten the overall path names. The path names we're concerned with are the .html topic files generated from our schema. As you know, the path format is:
Schema_xsd~e!@!Node1!@!Node2!@!Node3!@!...!@!NodeN.html
Because of the design of our schema, and the choice of element names, the fully qualified path names can easily exceed 260 characters. There's a reference in MSDN to how Windows can be made to use Unicode strings (whose length can be ~32k chars) by prepending them with \\?\ but this technique doesn't work with our build process (which is based on MSBUILD).
I guess I was hoping for something along the lines of a configurable separator (to be able to choose something shorter than !@!), or some sort of string encoding or compression along the lines of tiny URLs.
-
Permanently deleted user We do plan to offer the existing .NET documentation only feature to generate shortened filenames for the other documentation types in a future update, but at present there isn't any way to get around this problem I'm afraid.
-
Permanently deleted user For the benefit of anyone coming across this post, our 2012.1 version supports the Generate Shortened Alias Filenames option for all documentation types.
Please sign in to leave a comment.