Skip to content

Document the "Convert file names to ASCII" config #6710

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Dec 12, 2024
Merged

Document the "Convert file names to ASCII" config #6710

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
41c161a
Document the "Convert file names to ASCII" config
kjac Nov 28, 2024
8ae4cf4
Adding ASCII to accepted acronyms
sofietoft Dec 10, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/styles/UmbracoDocs/Acronyms.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -88,3 +88,4 @@ exceptions:
- JPEG
- BCC
- SSD
- ASCII
7 changes: 6 additions & 1 deletion 13/umbraco-cms/reference/configuration/requesthandlersettings.md
View file
Open in desktop
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
7 changes: 6 additions & 1 deletion 15/umbraco-cms/reference/configuration/requesthandlersettings.md
View file
Open in desktop
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
Loading