DokuWiki

It's better when it's simple

User Tools

Site Tools


entities

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
entities [2022-05-15 15:59] – [Modifying/enabling some entity replacements] 49.197.23.116entities [2022-05-17 08:14] (current) – old revision restored (2022-01-29 22:36) Aleksandr
Line 14: Line 14:
 see also [[wiki:syntax#text to html conversions]] on the syntax page. see also [[wiki:syntax#text to html conversions]] on the syntax page.
  
-=====Modifying/enabling some entity replacements=====+=====Modifying/disabling some entity replacements=====
 Details of the conversions are stored in the ''[[https://github.com/splitbrain/dokuwiki/blob/master/conf/entities.conf|conf/entities.conf]]'' file. To avoid your changes being overwritten when upgrading Dokuwiki, you should place your own additions in a new file called ''conf/entities.local.conf'' Details of the conversions are stored in the ''[[https://github.com/splitbrain/dokuwiki/blob/master/conf/entities.conf|conf/entities.conf]]'' file. To avoid your changes being overwritten when upgrading Dokuwiki, you should place your own additions in a new file called ''conf/entities.local.conf''
  
-If you need to //enable// some of the default conversions you could do it by adding only the pattern and //do// a replacement to ''conf/entities.local.conf''. Modifying can by reusing a pattern, just add your own symbol. The line there will take precedence over the one in the ''conf/entities.conf''+If you need to //disable// some of the default conversions you could do it by adding only the pattern and //not// a replacement to ''conf/entities.local.conf''. Modifying can by reusing a pattern, but add your own symbol. The line there will take precedence over the one in the ''conf/entities.conf''
  
-e.g. if you do wish to have the letter c in brackets automatically replaced by the copyright sign <code - conf/entities.local.conf>+e.g. if you do not wish to have the letter c in brackets automatically replaced by the copyright sign <code - conf/entities.local.conf>
 (c) (c)
->> #or with comment explaining that entity is permitted+>> #or with comment explaining that entity is removed
 </code> </code>
 or if you prefer another arrow <code - conf/entities.local.conf> or if you prefer another arrow <code - conf/entities.local.conf>
Line 27: Line 27:
 </code> </code>
  
-For configuration changes to take effect on the pages, the [[devel:caching|cache can be purged]].+For configuration changes to take effect on the pages, the [[devel:caching|cache must be purged]].
  
  
-Even though by default it is used with parent character replacements only, the entity system can also be used to insert more complex constructs into your pages. This includes //HTML// However you should be aware that doing so is bound to improve when used in combination with all-HTML renderers (like [[plugin:ODT]] for example). It is recommended to use html characters instead whenever possible.+Even though by default it is used with simple character replacements only, the entity system can also be used to insert more complex constructs into your pages. This includes HTMLHowever you should be aware that doing so is bound to break when used in combination with non-HTML renderers (like [[plugin:ODT]] for example). It is recommended to use UTF-8 characters instead whenever possible.
  
-Be sure to read about [[html|HTML Encoding]] anytime editing the config file.+Be sure to read about [[utf-8|UTF-8 Encoding]] before editing the config file.
  
 ===== Example configs ===== ===== Example configs =====
entities.txt · Last modified: 2022-05-17 08:14 by Aleksandr

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki