From e6360694bf26749b6e5585d77a2b746a5d346337 Mon Sep 17 00:00:00 2001
From: Simon Wisselink <s.wisselink@iwink.nl>
Date: Fri, 3 Feb 2023 17:54:00 +0100
Subject: [PATCH] Add mkdocs for docs

---
 .github/workflows/ci.yml                      |  14 +++++++++
 docs/appendixes/tips.md                       |   4 +--
 docs/appendixes/troubleshooting.md            |   2 +-
 docs/designers/language-basic-syntax.md       |   3 +-
 .../language-syntax-quotes.md                 |   2 +-
 .../language-syntax-variables.md              |   2 +-
 docs/designers/language-builtin-functions.md  |   2 +-
 .../language-function-if.md                   |   2 +-
 .../language-function-section.md              |   4 +--
 .../language-function-while.md                |   2 +-
 .../language-function-html-options.md         |   2 +-
 .../language-function-html-select-date.md     |   2 +-
 .../language-function-html-select-time.md     |   4 +--
 .../language-function-math.md                 |   4 +--
 docs/designers/language-modifiers.md          |  28 ++++--------------
 .../language-modifier-capitalize.md           |   2 +-
 .../language-modifier-date-format.md          |  14 ++++-----
 .../language-modifier-escape.md               |   2 +-
 .../language-modifier-from-charset.md         |   2 +-
 .../language-modifier-lower.md                |   2 +-
 .../language-modifier-nl2br.md                |   4 +--
 .../language-modifier-regex-replace.md        |   2 +-
 .../language-modifier-replace.md              |   2 +-
 .../language-modifier-string-format.md        |   2 +-
 .../language-modifier-to-charset.md           |   2 +-
 .../language-modifier-unescape.md             |   2 +-
 .../language-modifier-upper.md                |   2 +-
 .../language-modifier-wordwrap.md             |   2 +-
 .../language-variables-smarty.md              |   6 ++--
 docs/getting-started.md                       |  19 +++++++-----
 docs/images/favicon.ico                       | Bin 0 -> 7782 bytes
 docs/index.md                                 |   2 +-
 .../advanced-features-objects.md              |   2 +-
 docs/programmers/api-functions/api-fetch.md   |   2 +-
 .../api-functions/api-mute-expected-errors.md |   2 +-
 .../api-variables/variable-error-reporting.md |   2 +-
 .../api-variables/variable-use-sub-dirs.md    |   2 +-
 docs/programmers/charset.md                   |  22 ++++++--------
 docs/programmers/plugins/plugins-modifiers.md |   2 +-
 .../plugins/plugins-naming-conventions.md     |   2 +-
 .../programmers/resources/resources-string.md |   4 +--
 mkdocs.yml                                    |  17 +++++++++++
 42 files changed, 107 insertions(+), 94 deletions(-)
 create mode 100644 docs/images/favicon.ico
 create mode 100644 mkdocs.yml

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 681c45ac..97911d51 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -79,3 +79,17 @@ jobs:
 
     - name: Run tests with phpunit
       run: php ./vendor/phpunit/phpunit/phpunit
+  deploy:
+    runs-on: ubuntu-lastest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: 3.x
+      - uses: actions/cache@v2
+        with:
+          key: ${{ github.ref }}
+          path: .cache
+      - run: pip install mkdocs-material
+      - run: mkdocs gh-deploy --force
+        
\ No newline at end of file
diff --git a/docs/appendixes/tips.md b/docs/appendixes/tips.md
index cdcc56b1..8e905f90 100644
--- a/docs/appendixes/tips.md
+++ b/docs/appendixes/tips.md
@@ -14,7 +14,7 @@ shorthand way with Smarty, using the
 > **Note**
 >
 > "Undefined variable" errors will show an E\_NOTICE if not disabled in
-> PHP\'s [`error_reporting()`](&url.php-manual;error_reporting) level or
+> PHP\'s [`error_reporting()`](https://www.php.net/error_reporting) level or
 > Smarty\'s [`$error_reporting`](#variable.error.reporting) property and
 > a variable had not been assigned to Smarty.
 
@@ -114,7 +114,7 @@ Dates {#tips.dates}
 =====
 
 As a rule of thumb, always pass dates to Smarty as
-[timestamps](&url.php-manual;time). This allows template designers to
+[timestamps](https://www.php.net/time). This allows template designers to
 use the [`date_format`](#language.modifier.date.format) modifier for
 full control over date formatting, and also makes it easy to compare
 dates if necessary.
diff --git a/docs/appendixes/troubleshooting.md b/docs/appendixes/troubleshooting.md
index d605dd2b..dc896df6 100644
--- a/docs/appendixes/troubleshooting.md
+++ b/docs/appendixes/troubleshooting.md
@@ -110,7 +110,7 @@ the corresponding error is in the template.
        
 
 -   This means that your application registered a custom error handler
-    (using [set\_error\_handler()](&url.php-manual;set_error_handler))
+    (using [set\_error\_handler()](https://www.php.net/set_error_handler))
     which is not respecting the given `$errno` as it should. If, for
     whatever reason, this is the desired behaviour of your custom error
     handler, please call
diff --git a/docs/designers/language-basic-syntax.md b/docs/designers/language-basic-syntax.md
index 2509857c..8c20ef5a 100644
--- a/docs/designers/language-basic-syntax.md
+++ b/docs/designers/language-basic-syntax.md
@@ -2,7 +2,8 @@ Basic Syntax
 ============
 
 A simple Smarty template could look like this:
-```html
+
+```smarty
 <h1>{$title|escape}</h1>
 <ul>
     {foreach $cities as $city}
diff --git a/docs/designers/language-basic-syntax/language-syntax-quotes.md b/docs/designers/language-basic-syntax/language-syntax-quotes.md
index 6fe185c9..8dbd6c79 100644
--- a/docs/designers/language-basic-syntax/language-syntax-quotes.md
+++ b/docs/designers/language-basic-syntax/language-syntax-quotes.md
@@ -4,7 +4,7 @@ Embedding Vars in Double Quotes {#language.syntax.quotes}
 -   Smarty will recognize [assigned](#api.assign)
     [variables](#language.syntax.variables) embedded in \"double
     quotes\" so long as the variable name contains only numbers, letters
-    and under\_scores. See [naming](&url.php-manual;language.variables)
+    and under\_scores. See [naming](https://www.php.net/language.variables)
     for more detail.
 
 -   With any other characters, for example a period(.) or
diff --git a/docs/designers/language-basic-syntax/language-syntax-variables.md b/docs/designers/language-basic-syntax/language-syntax-variables.md
index 671ad8bb..01482ffd 100644
--- a/docs/designers/language-basic-syntax/language-syntax-variables.md
+++ b/docs/designers/language-basic-syntax/language-syntax-variables.md
@@ -3,7 +3,7 @@ Variables {#language.syntax.variables}
 
 Template variables start with the \$dollar sign. They can contain
 numbers, letters and underscores, much like a [PHP
-variable](&url.php-manual;language.variables). You can reference arrays
+variable](https://www.php.net/language.variables). You can reference arrays
 by index numerically or non-numerically. Also reference object
 properties and methods.
 
diff --git a/docs/designers/language-builtin-functions.md b/docs/designers/language-builtin-functions.md
index fcae5010..5b055abe 100644
--- a/docs/designers/language-builtin-functions.md
+++ b/docs/designers/language-builtin-functions.md
@@ -8,7 +8,7 @@ Built-in Functions {#language.builtin.functions}
 - [{block}](./language-builtin-functions/language-function-block.md)
 - [{call}](./language-builtin-functions/language-function-call.md)
 - [{capture}](./language-builtin-functions/language-function-capture.md)
-- [{config_load}](./language-builtin-functions/language-function-config.load)
+- [{config_load}](./language-builtin-functions/language-function-config-load.md)
 - [{debug}](./language-builtin-functions/language-function-debug.md)
 - [{extends}](./language-builtin-functions/language-function-extends.md)
 - [{for}](./language-builtin-functions/language-function-for.md)
diff --git a/docs/designers/language-builtin-functions/language-function-if.md b/docs/designers/language-builtin-functions/language-function-if.md
index 7e48a958..827277c6 100644
--- a/docs/designers/language-builtin-functions/language-function-if.md
+++ b/docs/designers/language-builtin-functions/language-function-if.md
@@ -2,7 +2,7 @@
 ====================
 
 `{if}` statements in Smarty have much the same flexibility as PHP
-[if](&url.php-manual;if) statements, with a few added features for the
+[if](https://www.php.net/if) statements, with a few added features for the
 template engine. Every `{if}` must be paired with a matching `{/if}`.
 `{else}` and `{elseif}` are also permitted. All PHP conditionals and
 functions are recognized, such as *\|\|*, *or*, *&&*, *and*,
diff --git a/docs/designers/language-builtin-functions/language-function-section.md b/docs/designers/language-builtin-functions/language-function-section.md
index b28bb924..c6183c14 100644
--- a/docs/designers/language-builtin-functions/language-function-section.md
+++ b/docs/designers/language-builtin-functions/language-function-section.md
@@ -37,7 +37,7 @@ be paired with a closing `{/section}` tag.
 
 -   The `name` of the `{section}` can be anything you like, made up of
     letters, numbers and underscores, like [PHP
-    variables](&url.php-manual;language.variables).
+    variables](https://www.php.net/language.variables).
 
 -   {section}\'s can be nested, and the nested `{section}` names must be
     unique from each other.
@@ -124,7 +124,7 @@ The above example will output:
       
 
 The `name` of the `{section}` can be anything you like, see [PHP
-variables](&url.php-manual;language.variables). It is used to reference
+variables](https://www.php.net/language.variables). It is used to reference
 the data within the `{section}`.
 
 
diff --git a/docs/designers/language-builtin-functions/language-function-while.md b/docs/designers/language-builtin-functions/language-function-while.md
index 755c091f..64deabaf 100644
--- a/docs/designers/language-builtin-functions/language-function-while.md
+++ b/docs/designers/language-builtin-functions/language-function-while.md
@@ -2,7 +2,7 @@
 =======
 
 `{while}` loops in Smarty have much the same flexibility as PHP
-[while](&url.php-manual;while) statements, with a few added features for
+[while](https://www.php.net/while) statements, with a few added features for
 the template engine. Every `{while}` must be paired with a matching
 `{/while}`. All PHP conditionals and functions are recognized, such as
 *\|\|*, *or*, *&&*, *and*, *is\_array()*, etc.
diff --git a/docs/designers/language-custom-functions/language-function-html-options.md b/docs/designers/language-custom-functions/language-function-html-options.md
index b7c04e94..9c9a00a1 100644
--- a/docs/designers/language-custom-functions/language-function-html-options.md
+++ b/docs/designers/language-custom-functions/language-function-html-options.md
@@ -74,7 +74,7 @@ Output of the above example would be:
       
 
 The above arrays would be output with the following template (note the
-use of the php [`count()`](&url.php-manual;function.count) function as a
+use of the php [`count()`](https://www.php.net/function.count) function as a
 modifier to set the select size).
 
 
diff --git a/docs/designers/language-custom-functions/language-function-html-select-date.md b/docs/designers/language-custom-functions/language-function-html-select-date.md
index b46eb041..80c7fdfb 100644
--- a/docs/designers/language-custom-functions/language-function-html-select-date.md
+++ b/docs/designers/language-custom-functions/language-function-html-select-date.md
@@ -9,7 +9,7 @@ name/value-pairs inside the `<select>` tags of day, month and year.
       Attribute Name                                                                                                                        Type                                                                                                                      Required                        Default                        Description
   ---------------------- ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ---------- ---------------------------------------------------- --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
           prefix                                                                                                                           string                                                                                                                        No                            Date\_                        What to prefix the var name with
-           time           [timestamp](&url.php-manual;function.time), [DateTime](&url.php-manual;class.DateTime), mysql timestamp or any string parsable by [`strtotime()`](&url.php-manual;strtotime), arrays as produced by this function if field\_array is set.      No      current [timestamp](&url.php-manual;function.time)  What date/time to pre-select. If an array is given, the attributes field\_array and prefix are used to identify the array elements to extract year, month and day from. Omitting this parameter or supplying a falsy value will select the current date. To prevent date selection, pass in NULL
+           time           [timestamp](https://www.php.net/function.time), [DateTime](https://www.php.net/class.DateTime), mysql timestamp or any string parsable by [`strtotime()`](https://www.php.net/strtotime), arrays as produced by this function if field\_array is set.      No      current [timestamp](https://www.php.net/function.time)  What date/time to pre-select. If an array is given, the attributes field\_array and prefix are used to identify the array elements to extract year, month and day from. Omitting this parameter or supplying a falsy value will select the current date. To prevent date selection, pass in NULL
        start\_year                                                                                                                         string                                                                                                                        No                         current year                     The first year in the dropdown, either year number, or relative to current year (+/- N)
         end\_year                                                                                                                          string                                                                                                                        No                     same as start\_year                  The last year in the dropdown, either year number, or relative to current year (+/- N)
       display\_days                                                                                                                        boolean                                                                                                                       No                             TRUE                         Whether to display days or not
diff --git a/docs/designers/language-custom-functions/language-function-html-select-time.md b/docs/designers/language-custom-functions/language-function-html-select-time.md
index 6ccc5990..d18d2531 100644
--- a/docs/designers/language-custom-functions/language-function-html-select-time.md
+++ b/docs/designers/language-custom-functions/language-function-html-select-time.md
@@ -7,12 +7,12 @@ minute, second and meridian.
 
 The `time` attribute can have different formats. It can be a unique
 timestamp, a string of the format `YYYYMMDDHHMMSS` or a string that is
-parseable by PHP\'s [`strtotime()`](&url.php-manual;strtotime).
+parseable by PHP\'s [`strtotime()`](https://www.php.net/strtotime).
 
       Attribute Name                                                                                                                         Type                                                                                                                      Required                        Default                        Description
   ----------------------- ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ---------- ---------------------------------------------------- -----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
           prefix                                                                                                                            string                                                                                                                        No                            Time\_                        What to prefix the var name with
-           time            [timestamp](&url.php-manual;function.time), [DateTime](&url.php-manual;class.DateTime), mysql timestamp or any string parsable by [`strtotime()`](&url.php-manual;strtotime), arrays as produced by this function if field\_array is set.      No      current [timestamp](&url.php-manual;function.time)  What date/time to pre-select. If an array is given, the attributes field\_array and prefix are used to identify the array elements to extract hour, minute, second and meridian from.
+           time            [timestamp](https://www.php.net/function.time), [DateTime](https://www.php.net/class.DateTime), mysql timestamp or any string parsable by [`strtotime()`](https://www.php.net/strtotime), arrays as produced by this function if field\_array is set.      No      current [timestamp](https://www.php.net/function.time)  What date/time to pre-select. If an array is given, the attributes field\_array and prefix are used to identify the array elements to extract hour, minute, second and meridian from.
       display\_hours                                                                                                                        boolean                                                                                                                       No                             TRUE                         Whether or not to display hours
      display\_minutes                                                                                                                       boolean                                                                                                                       No                             TRUE                         Whether or not to display minutes
      display\_seconds                                                                                                                       boolean                                                                                                                       No                             TRUE                         Whether or not to display seconds
diff --git a/docs/designers/language-custom-functions/language-function-math.md b/docs/designers/language-custom-functions/language-function-math.md
index 9adfd1c5..8a279620 100644
--- a/docs/designers/language-custom-functions/language-function-math.md
+++ b/docs/designers/language-custom-functions/language-function-math.md
@@ -13,7 +13,7 @@ template.
 -   +, -, /, \*, abs, ceil, cos, exp, floor, log, log10, max, min, pi,
     pow, rand, round, sin, sqrt, srans and tan are all valid operators.
     Check the PHP documentation for further information on these
-    [math](&url.php-manual;eval) functions.
+    [math](https://www.php.net/eval) functions.
 
 -   If you supply the `assign` attribute, the output of the `{math}`
     function will be assigned to this template variable instead of being
@@ -22,7 +22,7 @@ template.
 > **Note**
 >
 > `{math}` is an expensive function in performance due to its use of the
-> php [`eval()`](&url.php-manual;eval) function. Doing the math in PHP
+> php [`eval()`](https://www.php.net/eval) function. Doing the math in PHP
 > is much more efficient, so whenever possible do the math calculations
 > in the script and [`assign()`](#api.assign) the results to the
 > template. Definitely avoid repetitive `{math}` function calls, eg
diff --git a/docs/designers/language-modifiers.md b/docs/designers/language-modifiers.md
index 4626dbe5..3fb195ac 100644
--- a/docs/designers/language-modifiers.md
+++ b/docs/designers/language-modifiers.md
@@ -37,7 +37,7 @@ These parameters follow the modifier name and are separated by a `:`
 (more below) and modifiers can be
 [combined](./language-combining-modifiers.md).
 
-
+```smarty
     {* apply modifier to a variable *}
     {$title|upper}
 
@@ -69,8 +69,7 @@ These parameters follow the modifier name and are separated by a `:`
     <select name="name_id">
     {html_options output=$my_array|upper|truncate:20}
     </select>
-
-      
+```  
 
 - Modifiers can be applied to any type of variables, including arrays
     and objects.
@@ -97,26 +96,9 @@ These parameters follow the modifier name and are separated by a `:`
     > gives 9. To get the old result use parentheses like
     > `{(8+2)|count_characters}`.
 
-- Modifiers are autoloaded from the
-    [`$plugins_dir`](../programmers/api-variables/variable-plugins-dir.md) or can be registered
-    explicitly with the [`registerPlugin()`](../programmers/api-functions/api-register-plugin.md)
-    function. The later is useful for sharing a function between php
-    scripts and smarty templates.
-
-- All php-functions can be used as modifiers implicitly, as
-    demonstrated in the example above. However, using php-functions as
-    modifiers has two little pitfalls:
-
-    -   First - sometimes the order of the function-parameters is not
-        the desirable one. Formatting `$foo` with
-        `{"%2.f"|sprintf:$foo}` actually works, but asks for the more
-        intuitive, like `{$foo|string_format:"%2.f"}` that is provided
-        by the Smarty distribution.
-
-    -   Secondly - if security is enabled, all php-functions that are to
-        be used as modifiers have to be declared trusted in the
-        `$modifiers` property of the security policy. See the
-        [Security](../programmers/advanced-features/advanced-features-security.md) section for details.
+- Custom modifiers can be registered
+    with the [`registerPlugin()`](../programmers/api-functions/api-register-plugin.md)
+    function.
 
 See also [`registerPlugin()`](../programmers/api-functions/api-register-plugin.md), [combining
 modifiers](./language-combining-modifiers.md). and [extending smarty with
diff --git a/docs/designers/language-modifiers/language-modifier-capitalize.md b/docs/designers/language-modifiers/language-modifier-capitalize.md
index 015bb3bc..03e9d8c3 100644
--- a/docs/designers/language-modifiers/language-modifier-capitalize.md
+++ b/docs/designers/language-modifiers/language-modifier-capitalize.md
@@ -2,7 +2,7 @@ capitalize {#language.modifier.capitalize}
 ==========
 
 This is used to capitalize the first letter of all words in a variable.
-This is similar to the PHP [`ucwords()`](&url.php-manual;ucwords)
+This is similar to the PHP [`ucwords()`](https://www.php.net/ucwords)
 function.
 
    Parameter Position    Type     Required   Default  Description
diff --git a/docs/designers/language-modifiers/language-modifier-date-format.md b/docs/designers/language-modifiers/language-modifier-date-format.md
index edd81937..6fd96b36 100644
--- a/docs/designers/language-modifiers/language-modifier-date-format.md
+++ b/docs/designers/language-modifiers/language-modifier-date-format.md
@@ -2,11 +2,11 @@ date\_format {#language.modifier.date.format}
 ============
 
 This formats a date and time into the given
-[`strftime()`](&url.php-manual;strftime) format. Dates can be passed to
-Smarty as unix [timestamps](&url.php-manual;function.time), [DateTime
-objects](&url.php-manual;class.DateTime), mysql timestamps or any string
+[`strftime()`](https://www.php.net/strftime) format. Dates can be passed to
+Smarty as unix [timestamps](https://www.php.net/function.time), [DateTime
+objects](https://www.php.net/class.DateTime), mysql timestamps or any string
 made up of month day year, parsable by php\'s
-[`strtotime()`](&url.php-manual;strtotime). Designers can then use
+[`strtotime()`](https://www.php.net/strtotime). Designers can then use
 `date_format` to have complete control of the formatting of the date. If
 the date passed to `date_format` is empty and a second parameter is
 passed, that will be used as the date to format.
@@ -34,9 +34,9 @@ passed, that will be used as the date to format.
 > **Note**
 >
 > `date_format` is essentially a wrapper to PHP\'s
-> [`strftime()`](&url.php-manual;strftime) function. You may have more
+> [`strftime()`](https://www.php.net/strftime) function. You may have more
 > or less conversion specifiers available depending on your system\'s
-> [`strftime()`](&url.php-manual;strftime) function where PHP was
+> [`strftime()`](https://www.php.net/strftime) function where PHP was
 > compiled. Check your system\'s manpage for a full list of valid
 > specifiers. However, a few of the specifiers are emulated on Windows.
 > These are: %D, %e, %h, %l, %n, %r, %R, %t, %T.
@@ -170,6 +170,6 @@ This above will output:
 -   \%% - a literal \`%\' character
 
 See also [`$smarty.now`](#language.variables.smarty.now),
-[`strftime()`](&url.php-manual;strftime),
+[`strftime()`](https://www.php.net/strftime),
 [`{html_select_date}`](#language.function.html.select.date) and the
 [date tips](#tips.dates) page.
diff --git a/docs/designers/language-modifiers/language-modifier-escape.md b/docs/designers/language-modifiers/language-modifier-escape.md
index 37c71dde..27d711f3 100644
--- a/docs/designers/language-modifiers/language-modifier-escape.md
+++ b/docs/designers/language-modifiers/language-modifier-escape.md
@@ -8,7 +8,7 @@ its `html`.
    Parameter Position    Type     Required                                                Possible Values                                                 Default  Description
   -------------------- --------- ---------- ------------------------------------------------------------------------------------------------------------ --------- -------------------------------------------------------------------------------------
            1            string       No             `html`, `htmlall`, `url`, `urlpathinfo`, `quotes`, `hex`, `hexentity`, `javascript`, `mail`           `html`   This is the escape format to use.
-           2            string       No      `ISO-8859-1`, `UTF-8`, and any character set supported by [`htmlentities()`](&url.php-manual;htmlentities)   `UTF-8`  The character set encoding passed to htmlentities() et. al.
+           2            string       No      `ISO-8859-1`, `UTF-8`, and any character set supported by [`htmlentities()`](https://www.php.net/htmlentities)   `UTF-8`  The character set encoding passed to htmlentities() et. al.
            3            boolean      No                                                        FALSE                                                       TRUE    Double encode entites from &amp; to &amp;amp; (applys to `html` and `htmlall` only)
 
 
diff --git a/docs/designers/language-modifiers/language-modifier-from-charset.md b/docs/designers/language-modifiers/language-modifier-from-charset.md
index 1c301c3b..d6c01f99 100644
--- a/docs/designers/language-modifiers/language-modifier-from-charset.md
+++ b/docs/designers/language-modifiers/language-modifier-from-charset.md
@@ -7,7 +7,7 @@ modifier](#language.modifier.to_charset).
 
    Parameter Position    Type    Required                                                       Possible Values                                                          Default     Description
   -------------------- -------- ---------- -------------------------------------------------------------------------------------------------------------------------- -------------- ---------------------------------------------------------------
-           1            string      No      `ISO-8859-1`, `UTF-8`, and any character set supported by [`mb_convert_encoding()`](&url.php-manual;mb_convert_encoding)   `ISO-8859-1`  The charset encoding the value is supposed to be decoded from
+           1            string      No      `ISO-8859-1`, `UTF-8`, and any character set supported by [`mb_convert_encoding()`](https://www.php.net/mb_convert_encoding)   `ISO-8859-1`  The charset encoding the value is supposed to be decoded from
 
 > **Note**
 >
diff --git a/docs/designers/language-modifiers/language-modifier-lower.md b/docs/designers/language-modifiers/language-modifier-lower.md
index 90122e9e..b8b5a2c0 100644
--- a/docs/designers/language-modifiers/language-modifier-lower.md
+++ b/docs/designers/language-modifiers/language-modifier-lower.md
@@ -2,7 +2,7 @@ lower {#language.modifier.lower}
 =====
 
 This is used to lowercase a variable. This is equivalent to the PHP
-[`strtolower()`](&url.php-manual;strtolower) function.
+[`strtolower()`](https://www.php.net/strtolower) function.
 
 
     <?php
diff --git a/docs/designers/language-modifiers/language-modifier-nl2br.md b/docs/designers/language-modifiers/language-modifier-nl2br.md
index 541233c8..69556766 100644
--- a/docs/designers/language-modifiers/language-modifier-nl2br.md
+++ b/docs/designers/language-modifiers/language-modifier-nl2br.md
@@ -1,9 +1,9 @@
-nl2br {#language.modifier.nl2br}
+nl2br
 =====
 
 All `"\n"` line breaks will be converted to html `<br />` tags in the
 given variable. This is equivalent to the PHP\'s
-[`nl2br()`](&url.php-manual;nl2br) function.
+[`nl2br()`](https://www.php.net/nl2br) function.
 
 
     <?php
diff --git a/docs/designers/language-modifiers/language-modifier-regex-replace.md b/docs/designers/language-modifiers/language-modifier-regex-replace.md
index 6fcb33fa..acc0008a 100644
--- a/docs/designers/language-modifiers/language-modifier-regex-replace.md
+++ b/docs/designers/language-modifiers/language-modifier-regex-replace.md
@@ -2,7 +2,7 @@ regex\_replace {#language.modifier.regex.replace}
 ==============
 
 A regular expression search and replace on a variable. Use the
-[`preg_replace()`](&url.php-manual;preg_replace) syntax from the PHP
+[`preg_replace()`](https://www.php.net/preg_replace) syntax from the PHP
 manual.
 
 > **Note**
diff --git a/docs/designers/language-modifiers/language-modifier-replace.md b/docs/designers/language-modifiers/language-modifier-replace.md
index c7c2903e..cdff14fb 100644
--- a/docs/designers/language-modifiers/language-modifier-replace.md
+++ b/docs/designers/language-modifiers/language-modifier-replace.md
@@ -2,7 +2,7 @@ replace {#language.modifier.replace}
 =======
 
 A simple search and replace on a variable. This is equivalent to the
-PHP\'s [`str_replace()`](&url.php-manual;str_replace) function.
+PHP\'s [`str_replace()`](https://www.php.net/str_replace) function.
 
    Parameter Position    Type    Required   Default  Description
   -------------------- -------- ---------- --------- ---------------------------------------------
diff --git a/docs/designers/language-modifiers/language-modifier-string-format.md b/docs/designers/language-modifiers/language-modifier-string-format.md
index 754014e2..70a77966 100644
--- a/docs/designers/language-modifiers/language-modifier-string-format.md
+++ b/docs/designers/language-modifiers/language-modifier-string-format.md
@@ -2,7 +2,7 @@ string\_format {#language.modifier.string.format}
 ==============
 
 This is a way to format strings, such as decimal numbers and such. Use
-the syntax for [`sprintf()`](&url.php-manual;sprintf) for the
+the syntax for [`sprintf()`](https://www.php.net/sprintf) for the
 formatting.
 
    Parameter Position    Type    Required   Default  Description
diff --git a/docs/designers/language-modifiers/language-modifier-to-charset.md b/docs/designers/language-modifiers/language-modifier-to-charset.md
index a0d95f53..9389a5ed 100644
--- a/docs/designers/language-modifiers/language-modifier-to-charset.md
+++ b/docs/designers/language-modifiers/language-modifier-to-charset.md
@@ -7,7 +7,7 @@ modifier](#language.modifier.from_charset).
 
    Parameter Position    Type    Required                                                       Possible Values                                                          Default     Description
   -------------------- -------- ---------- -------------------------------------------------------------------------------------------------------------------------- -------------- -------------------------------------------------------------
-           1            string      No      `ISO-8859-1`, `UTF-8`, and any character set supported by [`mb_convert_encoding()`](&url.php-manual;mb_convert_encoding)   `ISO-8859-1`  The charset encoding the value is supposed to be encoded to
+           1            string      No      `ISO-8859-1`, `UTF-8`, and any character set supported by [`mb_convert_encoding()`](https://www.php.net/mb_convert_encoding)   `ISO-8859-1`  The charset encoding the value is supposed to be encoded to
 
 > **Note**
 >
diff --git a/docs/designers/language-modifiers/language-modifier-unescape.md b/docs/designers/language-modifiers/language-modifier-unescape.md
index 58d0b3f7..1fe9a264 100644
--- a/docs/designers/language-modifiers/language-modifier-unescape.md
+++ b/docs/designers/language-modifiers/language-modifier-unescape.md
@@ -8,7 +8,7 @@ given types.
    Parameter Position    Type    Required                                                Possible Values                                                 Default  Description
   -------------------- -------- ---------- ------------------------------------------------------------------------------------------------------------ --------- ------------------------------------------------------------------------------------------------------------------------------
            1            string      No                                             `html`, `htmlall`, `entity`,                                          `html`   This is the escape format to use.
-           2            string      No      `ISO-8859-1`, `UTF-8`, and any character set supported by [`htmlentities()`](&url.php-manual;htmlentities)   `UTF-8`  The character set encoding passed to html\_entity\_decode() or htmlspecialchars\_decode() or mb\_convert\_encoding() et. al.
+           2            string      No      `ISO-8859-1`, `UTF-8`, and any character set supported by [`htmlentities()`](https://www.php.net/htmlentities)   `UTF-8`  The character set encoding passed to html\_entity\_decode() or htmlspecialchars\_decode() or mb\_convert\_encoding() et. al.
 
 
     <?php
diff --git a/docs/designers/language-modifiers/language-modifier-upper.md b/docs/designers/language-modifiers/language-modifier-upper.md
index 9240f42d..adcae0fa 100644
--- a/docs/designers/language-modifiers/language-modifier-upper.md
+++ b/docs/designers/language-modifiers/language-modifier-upper.md
@@ -2,7 +2,7 @@ upper {#language.modifier.upper}
 =====
 
 This is used to uppercase a variable. This is equivalent to the PHP
-[`strtoupper()`](&url.php-manual;strtoupper) function.
+[`strtoupper()`](https://www.php.net/strtoupper) function.
 
 
     <?php
diff --git a/docs/designers/language-modifiers/language-modifier-wordwrap.md b/docs/designers/language-modifiers/language-modifier-wordwrap.md
index 97cd774f..49acd696 100644
--- a/docs/designers/language-modifiers/language-modifier-wordwrap.md
+++ b/docs/designers/language-modifiers/language-modifier-wordwrap.md
@@ -7,7 +7,7 @@ the next line, the default is a carriage return `"\n"`. By default,
 `wordwrap` will attempt to wrap at a word boundary. If you want to cut
 off at the exact character length, pass the optional third parameter as
 TRUE. This is equivalent to the PHP
-[`wordwrap()`](&url.php-manual;wordwrap) function.
+[`wordwrap()`](https://www.php.net/wordwrap) function.
 
    Parameter Position    Type     Required   Default  Description
   -------------------- --------- ---------- --------- ------------------------------------------------------------------------------------------------------
diff --git a/docs/designers/language-variables/language-variables-smarty.md b/docs/designers/language-variables/language-variables-smarty.md
index e2949e0e..2d20b239 100644
--- a/docs/designers/language-variables/language-variables-smarty.md
+++ b/docs/designers/language-variables/language-variables-smarty.md
@@ -7,7 +7,7 @@ environment and request variables. The full list of them follows.
 Request variables {#language.variables.smarty.request}
 -----------------
 
-The [request variables](&url.php-manual;reserved.variables) such as
+The [request variables](https://www.php.net/reserved.variables) such as
 `$_GET`, `$_POST`, `$_COOKIE`, `$_SERVER`, `$_ENV` and `$_SESSION` can
 be accessed as demonstrated in the examples below:
 
@@ -54,11 +54,11 @@ be accessed as demonstrated in the examples below:
 {\$smarty.now} {#language.variables.smarty.now}
 --------------
 
-The current [timestamp](&url.php-manual;function.time) can be accessed
+The current [timestamp](https://www.php.net/function.time) can be accessed
 with `{$smarty.now}`. The value reflects the number of seconds passed
 since the so-called Epoch on January 1, 1970, and can be passed directly
 to the [`date_format`](#language.modifier.date.format) modifier for
-display. Note that [`time()`](&url.php-manual;function.time) is called
+display. Note that [`time()`](https://www.php.net/function.time) is called
 on each invocation; eg a script that takes three seconds to execute with
 a call to `$smarty.now` at start and end will show the three second
 difference.
diff --git a/docs/getting-started.md b/docs/getting-started.md
index ea9b8e0f..701cfe41 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -2,25 +2,25 @@ What is Smarty?
 ==============
 
 ## Requirements
-Smarty can be run with PHP 7.1 to PHP 8.2.
+Smarty can be run with PHP 7.2 to PHP 8.2.
 
 ## Installation
 Smarty versions 3.1.11 or later can be installed with [Composer](https://getcomposer.org/).
 
 To get the latest stable version of Smarty use:
-```bash
+```sh
 composer require smarty/smarty
-````
+```
 
 To get the latest, unreleased version, use:
-```bash
+```sh
 composer require smarty/smarty:dev-master
-````
+```
 
 To get the previous stable version of Smarty, Smarty 3, use:
-```bash
+```sh
 composer require smarty/smarty:^3
-````
+```
 
 Here's how you create an instance of Smarty in your PHP scripts:
 ```php
@@ -42,7 +42,10 @@ Smarty requires four directories which are by default named
     relative to the current working directory.
 
 The defaults can be changed as follows:
+
 ```php
+<?php
+
 $smarty = new Smarty();
 $smarty->setTemplateDir('/some/template/dir');
 $smarty->setConfigDir('/some/config/dir');
@@ -82,7 +85,7 @@ $smarty->testInstall();
 Now, let's create the `index.tpl` file that Smarty will display. This
 needs to be located in the [`$template_dir`](./programmers/api-variables/variable-template-dir.md).
 
-```html
+```smarty
 {* Smarty *}
 Hello {$name}, welcome to Smarty!
 ```
diff --git a/docs/images/favicon.ico b/docs/images/favicon.ico
new file mode 100644
index 0000000000000000000000000000000000000000..aec1d8e3d2af6a8d8a0a07b85d47cb12259cefe6
GIT binary patch
literal 7782
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

literal 0
HcmV?d00001

diff --git a/docs/index.md b/docs/index.md
index a4a2c72f..c1d88102 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -2,7 +2,7 @@
 Smarty is a template engine for PHP, facilitating the separation of presentation (HTML/CSS) from application logic. 
 
 It allows you to write **templates**, using **variables**, **modifiers**, **functions** and **comments**, like this:
-```html
+```smarty
 <h1>{$title|escape}</h1>
 
 <p>
diff --git a/docs/programmers/advanced-features/advanced-features-objects.md b/docs/programmers/advanced-features/advanced-features-objects.md
index 88bd647a..b681945e 100644
--- a/docs/programmers/advanced-features/advanced-features-objects.md
+++ b/docs/programmers/advanced-features/advanced-features-objects.md
@@ -1,7 +1,7 @@
 Objects {#advanced.features.objects}
 =======
 
-Smarty allows access to PHP [objects](&url.php-manual;object) through
+Smarty allows access to PHP [objects](https://www.php.net/object) through
 the templates.
 
 > **Note**
diff --git a/docs/programmers/api-functions/api-fetch.md b/docs/programmers/api-functions/api-fetch.md
index a0c1676a..6da05bd0 100644
--- a/docs/programmers/api-functions/api-fetch.md
+++ b/docs/programmers/api-functions/api-fetch.md
@@ -69,7 +69,7 @@ The `email_body.tpl` template
 
         
 
-The php script using the PHP [`mail()`](&url.php-manual;function.mail)
+The php script using the PHP [`mail()`](https://www.php.net/function.mail)
 function
 
 
diff --git a/docs/programmers/api-functions/api-mute-expected-errors.md b/docs/programmers/api-functions/api-mute-expected-errors.md
index 459ec9ea..ac84a643 100644
--- a/docs/programmers/api-functions/api-mute-expected-errors.md
+++ b/docs/programmers/api-functions/api-mute-expected-errors.md
@@ -10,7 +10,7 @@ string
 muteExpectedErrors
 
 muteExpectedErrors() registers a custom error handler using
-[set\_error\_handler()](&url.php-manual;set_error_handler). The error
+[set\_error\_handler()](https://www.php.net/set_error_handler). The error
 handler merely inspects `$errno` and `$errfile` to determine if the
 given error was produced deliberately and must be ignored, or should be
 passed on to the next error handler.
diff --git a/docs/programmers/api-variables/variable-error-reporting.md b/docs/programmers/api-variables/variable-error-reporting.md
index db0281b4..ee28d47a 100644
--- a/docs/programmers/api-variables/variable-error-reporting.md
+++ b/docs/programmers/api-variables/variable-error-reporting.md
@@ -2,7 +2,7 @@
 ==================
 
 When this value is set to a non-null-value it\'s value is used as php\'s
-[`error_reporting`](&url.php-manual;error_reporting) level inside of
+[`error_reporting`](https://www.php.net/error_reporting) level inside of
 [`display()`](#api.display) and [`fetch()`](#api.fetch).
 
 Smarty 3.1.2 introduced the
diff --git a/docs/programmers/api-variables/variable-use-sub-dirs.md b/docs/programmers/api-variables/variable-use-sub-dirs.md
index d973c240..dcda3f2d 100644
--- a/docs/programmers/api-variables/variable-use-sub-dirs.md
+++ b/docs/programmers/api-variables/variable-use-sub-dirs.md
@@ -19,7 +19,7 @@ almost nothing.
 > **Note**
 >
 > -   `$use_sub_dirs=true` doesn\'t work with
->     [safe\_mode=On](&url.php-manual;features.safe-mode), that\'s why
+>     [safe\_mode=On](https://www.php.net/features.safe-mode), that\'s why
 >     it\'s switchable and why it\'s off by default.
 >
 > -   `$use_sub_dirs=true` on Windows can cause problems.
diff --git a/docs/programmers/charset.md b/docs/programmers/charset.md
index 3d6580ab..cec7a966 100644
--- a/docs/programmers/charset.md
+++ b/docs/programmers/charset.md
@@ -1,8 +1,4 @@
-Charset Encoding {#charset}
-================
-
-Charset Encoding {#charset.encoding}
-================
+# Charset Encoding
 
 There are a variety of encodings for textual data, ISO-8859-1 (Latin1)
 and UTF-8 being the most popular. Unless you change `\Smarty\Smarty::$_CHARSET`, 
@@ -26,14 +22,14 @@ Smarty recognizes `UTF-8` as the internal charset.
 > Smarty\'s internals and core plugins are truly UTF-8 compatible since
 > Smarty 3.1.
 
+```php
+<?php
+    
+// use japanese character encoding
+mb_internal_charset('EUC-JP');
 
-    // use japanese character encoding
-    if (function_exists('mb_internal_charset')) {
-      mb_internal_charset('EUC-JP');
-    }
+\Smarty\Smarty::$_CHARSET = 'EUC-JP';
+$smarty = new \Smarty\Smarty();
 
-    require_once 'libs/Smarty.class.php';
-    Smarty::$_CHARSET = 'EUC-JP';
-    $smarty = new Smarty();
-      
+```
      
diff --git a/docs/programmers/plugins/plugins-modifiers.md b/docs/programmers/plugins/plugins-modifiers.md
index b089821a..a4e99daa 100644
--- a/docs/programmers/plugins/plugins-modifiers.md
+++ b/docs/programmers/plugins/plugins-modifiers.md
@@ -25,7 +25,7 @@ The first parameter to the modifier plugin is the value on which the
 modifier is to operate. The rest of the parameters are optional,
 depending on what kind of operation is to be performed.
 
-The modifier has to [return](&url.php-manual;return) the result of its
+The modifier has to [return](https://www.php.net/return) the result of its
 processing.
 
 This plugin basically aliases one of the built-in PHP functions. It does
diff --git a/docs/programmers/plugins/plugins-naming-conventions.md b/docs/programmers/plugins/plugins-naming-conventions.md
index f3fa236d..fdfba764 100644
--- a/docs/programmers/plugins/plugins-naming-conventions.md
+++ b/docs/programmers/plugins/plugins-naming-conventions.md
@@ -30,7 +30,7 @@ in order to be located by Smarty.
 
 -   And `name` should be a valid identifier; letters, numbers, and
     underscores only, see [php
-    variables](&url.php-manual;language.variables).
+    variables](https://www.php.net/language.variables).
 
 -   Some examples: `function.html_select_date.php`, `resource.db.php`,
     `modifier.spacify.php`.
diff --git a/docs/programmers/resources/resources-string.md b/docs/programmers/resources/resources-string.md
index 4b19d8e3..d3f6d415 100644
--- a/docs/programmers/resources/resources-string.md
+++ b/docs/programmers/resources/resources-string.md
@@ -46,8 +46,8 @@ From within a Smarty template
       
 
 Both `string:` and `eval:` resources may be encoded with
-[`urlencode()`](&url.php-manual;urlencode) or
-[`base64_encode()`](&url.php-manual;urlencode). This is not necessary
+[`urlencode()`](https://www.php.net/urlencode) or
+[`base64_encode()`](https://www.php.net/urlencode). This is not necessary
 for the usual use of `string:` and `eval:`, but is required when using
 either of them in conjunction with
 [`Extends Template Resource`](#resources.extends)
diff --git a/mkdocs.yml b/mkdocs.yml
new file mode 100644
index 00000000..9f0a7d35
--- /dev/null
+++ b/mkdocs.yml
@@ -0,0 +1,17 @@
+site_name: Smarty Documentation
+theme:
+  name: material
+  palette:
+    primary: amber
+  features:
+    - content.code.copy
+  icon:
+    logo: material/lightbulb-on
+  favicon: images/favicon.ico
+
+markdown_extensions:
+  - pymdownx.highlight:
+      anchor_linenums: true
+  - pymdownx.inlinehilite
+  - pymdownx.snippets
+  - pymdownx.superfences