From 49b3a86bbce39b72a5b09dcb6a6ece954ced6119 Mon Sep 17 00:00:00 2001 From: "John Paul E. Balandan, CPA" Date: Wed, 4 Nov 2026 00:33:58 +0800 Subject: [PATCH 1/2] docs: rewrite the contributor guide for Markdown --- .../instructions/user-guide.instructions.md | 10 +- contributing/ELDocs.tmbundle.zip | Bin 3932 -> 0 bytes contributing/documentation.md | 183 +++++++++++++++++ contributing/documentation.rst | 186 ------------------ contributing/pull_request.md | 12 +- 5 files changed, 196 insertions(+), 195 deletions(-) delete mode 100644 contributing/ELDocs.tmbundle.zip create mode 100644 contributing/documentation.md delete mode 100644 contributing/documentation.rst diff --git a/.github/instructions/user-guide.instructions.md b/.github/instructions/user-guide.instructions.md index 9b55a50ba3f1..c5eafc5a3999 100644 --- a/.github/instructions/user-guide.instructions.md +++ b/.github/instructions/user-guide.instructions.md @@ -1,11 +1,15 @@ --- -applyTo: "user_guide_src/**/*.rst" +applyTo: "docs/**/*.md" --- # User guide -- Preserve the existing reStructuredText structure, terminology, directives, +- Preserve the existing Markdown structure, terminology, admonitions, anchors, and surrounding writing style. +- Indent nested lists and admonition bodies by four spaces, and keep the two + trailing spaces that end a line as a hard line break. +- Add a new page to the page's folder `index.md` and run + `php admin/update-docs-nav.php` to add it to `docs/.nav.yml`. - Keep PHP examples compatible with PHP 8.2 and verify signatures and behavior against the current framework code. - Distinguish new behavior from existing behavior and document defaults @@ -22,6 +26,6 @@ applyTo: "user_guide_src/**/*.rst" smallest migration in both the minor changelog and upgrading guide. - Keep code examples minimal but complete enough to run in a normal CodeIgniter application. -- Leave the complete Sphinx build and documentation validation to GitHub +- Leave the complete MkDocs build and documentation validation to GitHub Actions unless the task specifically requires local documentation validation. diff --git a/contributing/ELDocs.tmbundle.zip b/contributing/ELDocs.tmbundle.zip deleted file mode 100644 index f7a11b364ca918379b48ad525798148e7470b6b1..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3932 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 NV?Y4VziZ>$e*jys2rd8s diff --git a/contributing/documentation.md b/contributing/documentation.md new file mode 100644 index 000000000000..ae0231411a7b --- /dev/null +++ b/contributing/documentation.md @@ -0,0 +1,183 @@ +# Writing CodeIgniter Documentation + +CodeIgniter's user guide is written in Markdown, in the **docs/** folder, and built with [MkDocs](https://www.mkdocs.org/) and the [Material](https://squidfunnel.github.io/mkdocs-material/) theme. +The focus is on readability and user friendliness. +While the pages can be quite technical, we always write for humans! + +- [Tools Required](#tools-required) +- [Pages and the Navigation](#pages-and-the-navigation) +- [Page and Section Headings](#page-and-section-headings) +- [Links](#links) +- [Admonitions](#admonitions) +- [Text Decoration](#text-decoration) +- [Code Blocks](#code-blocks) +- [Line Breaks and Whitespace](#line-breaks-and-whitespace) + +## Tools Required + +To preview the rendered site, you need Python 3.11 or newer. Install MkDocs and its dependencies into a virtual environment: + +```console +python3 -m venv venv +venv/bin/pip install -r docs/requirements.txt +``` + +Then serve the user guide at , which reloads when you save a page: + +```console +venv/bin/mkdocs serve +``` + +GitHub Actions builds the user guide for every pull request that changes **docs/**, with `mkdocs build --strict`. +A broken link, a missing page or an unknown anchor fails the build, so you can leave the full validation to it unless you are changing the build itself. + +## Pages and the Navigation + +Each page is a Markdown file in **docs/**, such as **docs/libraries/pagination.md**. +The navigation is the file **docs/.nav.yml**. + +When you add a page, run the script that adds it to the navigation: + +```console +php admin/update-docs-nav.php +``` + +The script places the page in the section of its folder, in the order of the links in that folder's **index.md**. +Add the link to the **index.md** first, and edit **docs/.nav.yml** by hand only to change the order or the title of an entry. +The pull request check runs `php admin/update-docs-nav.php --check`, which fails when a page is missing from the navigation or an entry has no file. + +## Page and Section Headings + +Headings provide the order and the sections of a page, and they build the table of contents on the right of the page. +Use one `#` heading for the page title, then `##` for sections and `###` for subsections, without skipping a level: + +```markdown +# Page Title + +## Major Section + +### Subsection + +#### SubSubSection +``` + +Do not add a table of contents yourself. The theme builds it from the headings, down to the third level. + +## Links + +### To a Section + +Every heading gets an anchor from its text, in lowercase with hyphens in place of spaces and punctuation. +The heading `## Result Rows` has the anchor `#result-rows`. + +To link to a section of another page: + +```markdown +See [Result Rows](../database/results.md#result-rows) for how to read them. +``` + +To link to a section of the same page: + +```markdown +See [Result Rows](#result-rows) +``` + +### To a Page + +Link to the Markdown file with a path relative to the current page: + +```markdown +See the [Session](../libraries/sessions.md) library +``` + +### To a URL + +```markdown +[CodeIgniter 4 framework](https://github.com/codeigniter4/framework) +``` + +### To a Function or a Method + +Write the name as code, or link it to the page that describes it: + +```markdown +See [dot_array_search()](../helpers/array_helper.md) + +See `CodeIgniter\HTTP\Response::setCookie()` +``` + +## Admonitions + +Use an admonition for a note, a warning or a version badge. +The body is indented by four spaces. + +```markdown +!!! note "Note" + You must call this method first to generate correct pagination links. + +!!! important "Important" + Do not edit the files in the **system** folder. + +!!! warning "Warning" + This setting disables the CSRF protection. +``` + +The types in use are `note`, `important`, `warning`, `danger`, `success` and `tip`. + +### New Feature + +Mark a feature that is new in a version with a `success` admonition that has the title `Available from version`, followed by the version: + +```markdown +!!! success "Available from version 4.3.0" +``` + +### Deprecated + +Mark a deprecation with a `danger` admonition, and say what to use instead: + +```markdown +!!! danger "Deprecated since version 4.3.0" + Use `CodeIgniter\Database\BaseBuilder::setData()` instead. +``` + +## Text Decoration + +As a general rule, we use `**` for in-line file paths, and a single backtick for source code. + +E.g.: + +```markdown +Open the **app/Config/Filters.php** file and update the `$methods` property like the following: +``` + +## Code Blocks + +Fence a code block with three backticks and the name of its language. +PHP samples have no opening tag, and the highlighter expects that: + +````markdown +```php +$pager = service('pager'); +``` +```` + +### CLI Command + +Use the `console` language for a command that is run in a terminal: + +````markdown +```console +php spark migrate +``` +```` + +Other languages in use are `html`, `apache`, `json` and `text`. + +## Line Breaks and Whitespace + +Python-Markdown, the parser behind MkDocs, is stricter than the Markdown on GitHub: + +- Indent nested lists and the body of an admonition by four spaces. +- A line that ends with two spaces is a hard line break. Your editor must not trim them, and **.editorconfig** already turns trimming off for **docs/**. +- Leave a blank line before a list, a code fence and a table. diff --git a/contributing/documentation.rst b/contributing/documentation.rst deleted file mode 100644 index deedc29ebfc9..000000000000 --- a/contributing/documentation.rst +++ /dev/null @@ -1,186 +0,0 @@ -################################# -Writing CodeIgniter Documentation -################################# - -CodeIgniter uses Sphinx to generate its documentation in a variety of formats, -using `reStructuredText`_ to handle the formatting. If you are familiar with -Markdown or Textile, you will quickly grasp reStructuredText. The focus is -on readability and user friendliness. -While they can be quite technical, we always write for humans! - -.. _reStructuredText: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html - -.. contents:: - :local: - -************** -Tools Required -************** - -To see the rendered HTML, ePub, PDF, etc., you will need to install Sphinx -along with the PHP domain extension for Sphinx. The underlying requirement -is to have Python installed. - -You can read more about installing all tools in **user_guide_src/README.rst** - -***************** -Table of Contents -***************** - -A local table of contents should always be included, like the one below. -It is created automatically by inserting the following:: - - .. contents:: - :local: - :depth: 2 - -***************************************** -Page and Section Headings and Subheadings -***************************************** - -Headings not only provide order and sections within a page, but they also -are used to automatically build both the page and document table of contents. -Headings are formed by using certain characters as underlines for a bit of -text. Major headings, like page titles and section headings also use -overlines. Other headings just use underlines, with the following hierarchy:: - - # with overline for page titles - * with overline for major sections - = for subsections - - for subsubsections - ^ for subsubsubsections - " for subsubsubsubsections (!) - -The :download:`TextMate ELDocs Bundle <./ELDocs.tmbundle.zip>` can help you -create these with the following tab triggers:: - - title-> - - ########## - Page Title - ########## - - sec-> - - ************* - Major Section - ************* - - sub-> - - Subsection - ========== - - sss-> - - SubSubSection - ------------- - - ssss-> - - SubSubSubSection - ^^^^^^^^^^^^^^^^ - - sssss-> - - SubSubSubSubSection (!) - """"""""""""""""""""""" - -********** -References -********** - -To a Section -============ - -If you need to link to a specific section, the first you add the label before a header:: - - .. _curlrequest-request-options-headers: - - headers - ======= - -And then you can reference it like this:: - - See :ref:`CURLRequest Class ` for how to add. - - See :ref:`curlrequest-request-options-headers` for how to add. - -To a Section in the Page -======================== - -You can reference a section in the current page like the following:: - - See `Result Rows`_ - -To a Page -========= - -You can reference a page like the following:: - - See :doc:`Session <../libraries/sessions>` library - - See :doc:`../libraries/sessions` library - -To a URL -======== - -:: - - `CodeIgniter 4 framework `_ - -To a Function -============= - -:: - - :php:func:`dot_array_search()` - -To a Method -=========== - -:: - - :php:meth:`CodeIgniter\\HTTP\\Response::setCookie()` - -**************** -Other Directives -**************** - -New Feature -=========== - -:: - - .. versionadded:: 4.3.0 - -Deprecated -========== - -:: - - .. deprecated:: 4.3.0 - Use :php:meth:`CodeIgniter\\Database\\BaseBuilder::setData()` instead. - -*************** -Text Decoration -*************** - -As a general rule, we use ``**`` for in-line file paths, and `````` for source code. - -E.g.:: - - Open the **app/Config/Filters.php** file and update the ``$methods`` property like the following: - -********** -Code Block -********** - -CLI Command -=========== - -:: - - .. code-block:: console - - php spark migrate diff --git a/contributing/pull_request.md b/contributing/pull_request.md index 844d62046cfa..9f1f8c28a24b 100644 --- a/contributing/pull_request.md +++ b/contributing/pull_request.md @@ -121,15 +121,15 @@ then you will need to add to the documentation. New classes, methods, parameters, changing default values, changing behavior etc. are all changes that require a change to documentation. -Also, the [Changelog](https://codeigniter4.github.io/CodeIgniter4/changelogs/index.html) +Also, the [Changelog](https://codeigniter4.github.io/CodeIgniter4/develop/changelogs/index.html) must be updated for every change, and PHPDoc blocks must be maintained. -See [Writing CodeIgniter Documentation](./documentation.rst). +See [Writing CodeIgniter Documentation](./documentation.md). #### Changelog -The [Changelog](https://codeigniter4.github.io/CodeIgniter4/changelogs/index.html) -in the [user guide](https://github.com/codeigniter4/CodeIgniter4/tree/develop/user_guide_src/source/changelogs) +The [Changelog](https://codeigniter4.github.io/CodeIgniter4/develop/changelogs/index.html) +in the [user guide](https://github.com/codeigniter4/CodeIgniter4/tree/develop/docs/changelogs) needs to be kept up-to-date. Not all changes will need an entry in it, but the following items should. @@ -144,8 +144,8 @@ following items should. If your PR requires users to do something when they upgrade CodeIgniter, or changes the Config values, -the [Upgrading Guide](https://codeigniter4.github.io/CodeIgniter4/installation/upgrading.html) -in the [installation](https://github.com/codeigniter4/CodeIgniter4/tree/develop/user_guide_src/source/installation) +the [Upgrading Guide](https://codeigniter4.github.io/CodeIgniter4/develop/installation/upgrading.html) +in the [installation](https://github.com/codeigniter4/CodeIgniter4/tree/develop/docs/installation) folder is also needed. - Add an instruction what to do when upgrading. From 1d7c047a360a7c24ab50203b7069b0635281a9a0 Mon Sep 17 00:00:00 2001 From: "John Paul E. Balandan, CPA" Date: Wed, 4 Nov 2026 00:33:59 +0800 Subject: [PATCH 2/2] chore: update tooling references to the Markdown user guide --- .github/carson.yml | 2 +- .github/dependabot.yml | 9 ++++ .../instructions/worker-mode.instructions.md | 2 +- .github/skills/forum-announcement/SKILL.md | 2 +- .gitignore | 47 ++++++++----------- README.md | 2 +- admin/framework/.gitignore | 39 +++++---------- admin/starter/.gitignore | 39 +++++---------- admin/userguide/.gitignore | 5 -- tests/README.md | 2 +- tests/system/Database/Builder/UpdateTest.php | 2 +- tests/system/Database/Live/UpdateTest.php | 2 +- 12 files changed, 61 insertions(+), 92 deletions(-) diff --git a/.github/carson.yml b/.github/carson.yml index 07c841b7a021..deb4501859b9 100644 --- a/.github/carson.yml +++ b/.github/carson.yml @@ -22,7 +22,7 @@ settings: files: ['.github/workflows/*'] - label: documentation files: - all: ['user_guide_src/source/**'] + all: ['docs/**'] - label: testing files: all: ['tests/**'] diff --git a/.github/dependabot.yml b/.github/dependabot.yml index c6188a21b9e6..e511627ae3bc 100644 --- a/.github/dependabot.yml +++ b/.github/dependabot.yml @@ -24,3 +24,12 @@ updates: patterns: - '*' group-by: dependency-name + + - package-ecosystem: 'pip' + directory: '/docs' + schedule: + interval: 'weekly' + groups: + user-guide-dependencies: + patterns: + - '*' diff --git a/.github/instructions/worker-mode.instructions.md b/.github/instructions/worker-mode.instructions.md index ec6e1742ec5a..ab0329da5983 100644 --- a/.github/instructions/worker-mode.instructions.md +++ b/.github/instructions/worker-mode.instructions.md @@ -1,5 +1,5 @@ --- -applyTo: "system/Boot.php,system/CodeIgniter.php,system/Commands/Worker/**,system/Config/BaseService.php,system/Config/Factories.php,system/Config/Factory.php,system/Config/Services.php,system/Database/Config.php,system/Database/BaseConnection.php,system/Database/ConnectionInterface.php,system/Database/*/Connection.php,system/Events/Events.php,system/Session/**,system/Cache/**,system/HTTP/**,system/Filters/**,system/Router/**,system/Security/**,system/Debug/Toolbar.php,system/Debug/Toolbar/**,app/Config/WorkerMode.php,tests/system/Commands/Worker/**,user_guide_src/source/installation/worker_mode.rst" +applyTo: "system/Boot.php,system/CodeIgniter.php,system/Commands/Worker/**,system/Config/BaseService.php,system/Config/Factories.php,system/Config/Factory.php,system/Config/Services.php,system/Database/Config.php,system/Database/BaseConnection.php,system/Database/ConnectionInterface.php,system/Database/*/Connection.php,system/Events/Events.php,system/Session/**,system/Cache/**,system/HTTP/**,system/Filters/**,system/Router/**,system/Security/**,system/Debug/Toolbar.php,system/Debug/Toolbar/**,app/Config/WorkerMode.php,tests/system/Commands/Worker/**,docs/installation/worker_mode.md" --- # FrankenPHP Worker Mode diff --git a/.github/skills/forum-announcement/SKILL.md b/.github/skills/forum-announcement/SKILL.md index e9e7c731a1a3..1a53513c9917 100644 --- a/.github/skills/forum-announcement/SKILL.md +++ b/.github/skills/forum-announcement/SKILL.md @@ -25,7 +25,7 @@ Create a forum-ready CodeIgniter4 release announcement using myBB markup. ## Procedure 1. Read `CHANGELOG.md` for release summary and PR references. -2. Read `user_guide_src/source/changelogs/v{VERSION}.rst` for each target version. +2. Read `docs/changelogs/v{VERSION}.md` for each target version. 3. Determine release mode: - Single release: one `4.x.y` version. - Dual release: maintenance + major; maintenance is presented first in the post. diff --git a/.gitignore b/.gitignore index 418eb60af297..ea4db348cfb5 100644 --- a/.gitignore +++ b/.gitignore @@ -42,11 +42,18 @@ $RECYCLE.BIN/ # These should never be under version control, # as it poses a security risk. .env -.vagrant -Vagrantfile -/user_guide_src/venv/ + +#------------------------- +# Local Configuration +#------------------------- +# phpenv local config +.php-version + +# pyenv local config .python-version -/user_guide_src/.python-version + +/phpunit.xml +/.php-cs-fixer.php #------------------------- # Temporary Files @@ -72,21 +79,19 @@ Vagrantfile php_errors.log #------------------------- -# User Guide Temp Files +# Build Output #------------------------- -/user_guide_src/build/* +# Test coverage +/build/ + +# phpDocumentor +/api/ + +# User guide /site/ /venv/ __pycache__/ -#------------------------- -# Test Files -#------------------------- -/tests/coverage* - -# Don't save phpunit under version control. -/phpunit - #------------------------- # Composer #------------------------- @@ -97,21 +102,13 @@ composer.lock # IDE / Development Files #------------------------- -# Modules Testing -_modules/* - -# phpenv local config -.php-version - # Jetbrains editors (PHPStorm, etc) .idea/ *.iml # Netbeans /nbproject/ -/build/ /nbbuild/ -/dist/ /nbdist/ /nbactions.xml /nb-configuration.xml @@ -124,12 +121,6 @@ _modules/* *.sublime-workspace *.sublime-project .phpintel -/api/ # Visual Studio Code .vscode/ - -/results/ -/phpunit.xml - -/.php-cs-fixer.php diff --git a/README.md b/README.md index 6a4e1025a8f5..8557b8d2a00d 100644 --- a/README.md +++ b/README.md @@ -26,7 +26,7 @@ More information about the plans for version 4 can be found in [CodeIgniter 4](h The [User Guide](https://codeigniter.com/user_guide/) is the primary documentation for CodeIgniter 4. -You will also find the [current **in-progress** User Guide](https://codeigniter4.github.io/CodeIgniter4/). +You will also find the [current **in-progress** User Guide](https://codeigniter4.github.io/CodeIgniter4/develop/). As with the rest of the framework, it is a work in progress, and will see changes over time to structure, explanations, etc. You might also be interested in the [API documentation](https://codeigniter4.github.io/api/) for the framework components. diff --git a/admin/framework/.gitignore b/admin/framework/.gitignore index 56b9f10d9160..0599343e84c3 100644 --- a/admin/framework/.gitignore +++ b/admin/framework/.gitignore @@ -42,8 +42,14 @@ $RECYCLE.BIN/ # These should never be under version control, # as it poses a security risk. .env -.vagrant -Vagrantfile + +#------------------------- +# Local Configuration +#------------------------- +# phpenv local config +.php-version + +/phpunit.xml #------------------------- # Temporary Files @@ -66,20 +72,13 @@ Vagrantfile php_errors.log #------------------------- -# User Guide Temp Files -#------------------------- -/user_guide_src/build/* -/user_guide_src/cilexer/build/* -/user_guide_src/cilexer/dist/* -/user_guide_src/cilexer/pycilexer.egg-info/* - -#------------------------- -# Test Files +# Build Output #------------------------- -/tests/coverage* +# Test coverage +/build/ -# Don't save phpunit under version control. -/phpunit +# phpDocumentor +/api/ #------------------------- # Composer @@ -90,21 +89,13 @@ vendor/ # IDE / Development Files #------------------------- -# Modules Testing -_modules/* - -# phpenv local config -.php-version - # Jetbrains editors (PHPStorm, etc) .idea/ *.iml # NetBeans /nbproject/ -/build/ /nbbuild/ -/dist/ /nbdist/ /nbactions.xml /nb-configuration.xml @@ -117,10 +108,6 @@ _modules/* *.sublime-workspace *.sublime-project .phpintel -/api/ # Visual Studio Code .vscode/ - -/results/ -/phpunit.xml diff --git a/admin/starter/.gitignore b/admin/starter/.gitignore index 56b9f10d9160..0599343e84c3 100644 --- a/admin/starter/.gitignore +++ b/admin/starter/.gitignore @@ -42,8 +42,14 @@ $RECYCLE.BIN/ # These should never be under version control, # as it poses a security risk. .env -.vagrant -Vagrantfile + +#------------------------- +# Local Configuration +#------------------------- +# phpenv local config +.php-version + +/phpunit.xml #------------------------- # Temporary Files @@ -66,20 +72,13 @@ Vagrantfile php_errors.log #------------------------- -# User Guide Temp Files -#------------------------- -/user_guide_src/build/* -/user_guide_src/cilexer/build/* -/user_guide_src/cilexer/dist/* -/user_guide_src/cilexer/pycilexer.egg-info/* - -#------------------------- -# Test Files +# Build Output #------------------------- -/tests/coverage* +# Test coverage +/build/ -# Don't save phpunit under version control. -/phpunit +# phpDocumentor +/api/ #------------------------- # Composer @@ -90,21 +89,13 @@ vendor/ # IDE / Development Files #------------------------- -# Modules Testing -_modules/* - -# phpenv local config -.php-version - # Jetbrains editors (PHPStorm, etc) .idea/ *.iml # NetBeans /nbproject/ -/build/ /nbbuild/ -/dist/ /nbdist/ /nbactions.xml /nb-configuration.xml @@ -117,10 +108,6 @@ _modules/* *.sublime-workspace *.sublime-project .phpintel -/api/ # Visual Studio Code .vscode/ - -/results/ -/phpunit.xml diff --git a/admin/userguide/.gitignore b/admin/userguide/.gitignore index d0eba7f4bdaa..41fc132dc574 100644 --- a/admin/userguide/.gitignore +++ b/admin/userguide/.gitignore @@ -5,9 +5,4 @@ !*/cache/index.html !*/cache/.htaccess -user_guide_src/build/* -user_guide_src/cilexer/build/* -user_guide_src/cilexer/dist/* -user_guide_src/cilexer/pycilexer.egg-info/* - /vendor/ diff --git a/tests/README.md b/tests/README.md index 4e35d026e838..3d55356baa35 100644 --- a/tests/README.md +++ b/tests/README.md @@ -54,7 +54,7 @@ database.default.port = 3306 Make sure that you provide a database engine that is currently running on your machine. More details on a test database setup are in the -[Testing Your Database](https://codeigniter4.github.io/CodeIgniter4/testing/database.html) section of the documentation. +[Testing Your Database](https://codeigniter4.github.io/CodeIgniter4/develop/testing/database.html) section of the documentation. If you want to run the tests without using live database you can exclude `@DatabaseLive` group. This will make the tests run quite a bit faster. diff --git a/tests/system/Database/Builder/UpdateTest.php b/tests/system/Database/Builder/UpdateTest.php index 91b220b0ba1b..7df08aea74f6 100644 --- a/tests/system/Database/Builder/UpdateTest.php +++ b/tests/system/Database/Builder/UpdateTest.php @@ -422,7 +422,7 @@ public function testUpdateWithWhereSameColumn3(): void } /** - * @see https://codeigniter4.github.io/CodeIgniter4/database/query_builder.html#updating-data + * @see https://codeigniter4.github.io/CodeIgniter4/develop/database/query_builder.html#updating-data */ public function testSetWithoutEscape(): void { diff --git a/tests/system/Database/Live/UpdateTest.php b/tests/system/Database/Live/UpdateTest.php index 41efa9b86c17..c23084a5b5f0 100644 --- a/tests/system/Database/Live/UpdateTest.php +++ b/tests/system/Database/Live/UpdateTest.php @@ -491,7 +491,7 @@ public function testUpdatePeriods(): void } /** - * @see https://codeigniter4.github.io/CodeIgniter4/database/query_builder.html#updating-data + * @see https://codeigniter4.github.io/CodeIgniter4/develop/database/query_builder.html#updating-data */ public function testSetWithoutEscape(): void {