Option to sanitize DocC files?

Development Swift-DocC
1

I am generating static website files from my .doccarchive file:

xcrun docc process-archive transform-for-static-hosting $DOCC_ARCHIVE_PATH --output-path $STATIC_FILES_FOLDER --hosting-base-path DOCC_NAME

I want to upload these files to a GitHub pages branch, but some of the folder and file names have a : in them:

Error: Artifact path is not valid: /data/documentation/services/accesstokeninfo/!=(_:_:).json. Contains the following character:  Colon :
          
Invalid characters include:  Double quote ", Colon :, Less than <, Greater than >, Vertical bar |, Asterisk *, Question mark ?, Carriage return \r, Line feed \n
2

You may be interested in this ongoing thread: Unsafe characters in file names redux .

3

There is an existing patch for this: SwiftDocC: use "portable" paths for file names by compnerd · Pull Request #668 · swiftlang/swift-docc · GitHub but the discussion that @destroycomputers mentioned is relevant as it is trying to figure out the path forward for that change.

4

CC: @FranzBusch @ronnqvist