wiki de milsiete89 | PmWiki / LocalCustomizations

Editando PmWiki.LocalCustomizations

From its inception, PmWiki has been designed so that [[WikiAdministrator]]s can greatly customize the way PmWiki displays pages and the markup sequences used to generate pages.  (This is even mentioned explicitly in [[PmWikiPhilosophy]] #4.)  As a result, the core ''pmwiki.php'' script makes extensive use of [[PmWiki.Variables]] to determine how markup sequences will be processed and what each individual page will output.  Thus, a WikiAdministrator can make a lot of customizations simply by setting variables in the ''config.php'' file.

The bulk of this page describes how customizations work in general, see [[PmWiki.DocumentationIndex]] for specific customizations that are commonly performed at many PmWiki installations, including:

* [[Skins]]
* [[Internationalizations]]
* [[Custom Markup]]
* [[Custom InterMap]]s

The ''scripts/'' subdirectory (below the directory holding the ''pmwiki.php'' script) and the PmWiki [[(Cookbook:)Cookbook]] contain many example customizations that you can include in your ''config.php'' site configuration.  The first few lines of each of these scripts generally contain instructions about how to enable (and use) the feature provided by the script--for most scripts, simply adding a line like:

->[@include_once("scripts/scriptfile.php");@]

somewhere in the ''config.php'' file will enable it.  Some of the scripts are automatically enabled for you via the ''scripts/stdconfig.php'' script unless you disable it by setting @@$EnableStdConfig=0;@@ in ''local/config.php''.

Note that you should strongly resist the temptation to directly modify the ''pmwiki.php'' script or the files in the ''scripts/'' subdirectory.  Any modifications you make to these files will probably be overwritten whenever you perform a [[PmWiki.Upgrade(s)]].  Instead, look at some of the sample scripts for examples of customizations that can be performed from ''config.php''. You can even create your own script to do a customization and use @@include_once(...)@@ to include it from ''config.php''.  If you do make your own customization script, you can safely put it in the ''cookbook/'' subdirectory--it won't get overwritten by an upgrade there.  You might also want to submit your customization to the [[MailingLists|pmwiki-users mailing list]] or the [[(Cookbook:)Cookbook]] so that others can benefit from your effort and so that it can perhaps be included in future releases of PmWiki.

%trail%<<|DocumentationIndex|>>

Sumario:

Autor: Esta es una edición menor

Basic Editing - Text Formatting Rules - Documentation Index	Tables: Simple - Advanced
Paragraphs: for a new paragraph, use a blank line; -> to indent text, -< hanging text	Line break: \\ or [[<<]]
Lists: * for bullet lists, # for numbered lists, :term:definition for definition lists Emphasis: ''italics'', '''bold''', '''''bold italics''''', @@typewriter@@ (monospaced) References: [[another page]], [[http://www.example.com]], [[another page \| link text]], [[#anchor]] Groups: [[Group/Page]] displays Page, [[Group.Page]] displays Group.Page, [[Group(.Page)]] displays Group
Separators: !!, !!! for headings, ---- for horizontal line Other markups: [+bigger+], [-smaller-], '^superscript^', '_subscript_', {+inserted+}, {-deleted-}	Prevent formatting: [=...=] Preformatted block: [@...@]