Skip to content

Commit

Permalink
Merge pull request #6710 from kjac/v15/feature/convert-file-names-to-…
Browse files Browse the repository at this point in the history
…ascii

Document the "Convert file names to ASCII" config
  • Loading branch information
sofietoft authored Dec 12, 2024
2 parents 4c28476 + 8ae4cf4 commit 8671a93
Show file tree
Hide file tree
Showing 3 changed files with 13 additions and 2 deletions.
1 change: 1 addition & 0 deletions .github/styles/UmbracoDocs/Acronyms.yml
Original file line number Diff line number Diff line change
Expand Up @@ -88,3 +88,4 @@ exceptions:
- JPEG
- BCC
- SSD
- ASCII
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ Here is a snippet containing all the default values of the `RequestHandler` sect
"RequestHandler": {
"AddTrailingSlash": true,
"ConvertUrlsToAscii": "try",
"ConvertFileNamesToAscii": "false",
"EnableDefaultCharReplacements": true,
"UserDefinedCharCollection": [
{
Expand Down Expand Up @@ -124,12 +125,16 @@ Here is a snippet containing all the default values of the `RequestHandler` sect

This will add a trailing slash to the URL when **`<addTrailingSlash>`** is set to "true". If you don't want to have a trailing slash, set the value to **false**.

### Convert URLs to ascii
### Convert URLs to ASCII

This setting tells Umbraco to convert all URLs to ASCII: American Standard Code for Information Interchange, if set to false the URLs will remain `UTF-8`.

This setting can be set to **try** This will make the engine try to convert the name to an ASCII implementation. If it fails, it will fallback to the name. Reason is that some languages don't have ASCII implementations, therefore the URLs would end up being empty.

### Convert file names to ASCII

This setting works the same as "Convert URLs to ASCII" above, but for Media item file names.

### Enable default character replacements

This setting tells Umbraco to use the default character replacements. If you don't want the default character replacements, set this to false.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ Here is a snippet containing all the default values of the `RequestHandler` sect
"RequestHandler": {
"AddTrailingSlash": true,
"ConvertUrlsToAscii": "try",
"ConvertFileNamesToAscii": "false",
"EnableDefaultCharReplacements": true,
"UserDefinedCharCollection": [
{
Expand Down Expand Up @@ -124,12 +125,16 @@ Here is a snippet containing all the default values of the `RequestHandler` sect

This will add a trailing slash to the URL when **`<addTrailingSlash>`** is set to "true". If you don't want to have a trailing slash, set the value to **false**.

### Convert URLs to ascii
### Convert URLs to ASCII

This setting tells Umbraco to convert all URLs to ASCII: American Standard Code for Information Interchange, if set to false the URLs will remain `UTF-8`.

This setting can be set to **try** This will make the engine try to convert the name to an ASCII implementation. If it fails, it will fallback to the name. Reason is that some languages don't have ASCII implementations, therefore the URLs would end up being empty.

### Convert file names to ASCII

This setting works the same as "Convert URLs to ASCII" above, but for Media item file names.

### Enable default character replacements

This setting tells Umbraco to use the default character replacements. If you don't want the default character replacements, set this to false.
Expand Down

0 comments on commit 8671a93

Please sign in to comment.