Unable to checkout some files to filesystem on Windows about kumascript HOT 3 CLOSED

I have found some examples of "colon-macros" used on MDN pages. For example, this page:

https://developer.mozilla.org/en-US/Add-ons/Code_snippets/File_I_O

uses {{ Storage:synchronous_io_warning() }} several times. So, we will need to translate colons in KumaScript macro names into file-safe characters.

My preference is Storage-synchronous_io_warning.ejs. It looks a little clumsy, but moves toward dashes for namespacing rather than colons.

from kumascript.

The colon (:) is one of the characters that can't be used in a filename on a Windows filesystem, and we should change the filenames of these macros that use it. The set of disallowed characters (MSDN source) are:

• < (less than)
• > (greater than)
• : (colon)
• " (double quote)
• / (forward slash)
• \ (backslash)
• | (vertical bar or pipe)
• ? (question mark)
• * (asterisk)

We're already normalizing case, so that {{CompatNo}} and {{compatno}} both work. Maybe we can extend this so that the filename for {{MDN:Common}} is one of:

• MDN_Common.ejs
• MDN-Common.ejs
• MDN.Common.ejs

The macro usage could still include the colon.

Or, we could change all the internal usage of these macros in one PR. I'll need to double check if any "colon-macros" are used on pages.

from kumascript.

The staff discussed this and agreed to use a dash (-) instead of a colon (:) in the filenames. The tasks are:

• Normalize colons to dashes, maybe in getTemplateName.
• Rename the macros.

from kumascript.