Плагин «Мой шаблон» | Participants
|
- Statistics
- Participants
- Translate into Russian
- Translation result
- 64% translated in draft.
If you do not want to register an account, you can sign in with OpenID.
MyTemplate plugin | ||
===== Download and Installation ===== | ||
Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the URL given above. Refer to [[:Plugins]] on how to install plugins manually. | Скачать и установить плагин можно с помощью «[[plugin:plugin|менеджера плагинов]]», используя ссылку для скачивания, указанную выше. Чтобы узнать, как установить плагин вручную, см. страницу «[[:plugin|Плагины]]». | |
===== Syntax and Usage ===== | ||
The plugin allows you to seperate the structure of a wiki page and the data contained within. This allows you to have multiple data pages referencing the same structure page. Technically, you can also combine several structure pages. | Плагин позволяет отделить структуру вики-страницы от содержащейся на ней информации. Это позволяет иметь страницы с различными данными, привязанных к странице с определённой структурой. Технически возможно объединять несколько таких «структурных» страниц. | |
I will continue to use the term "structure page" for the pages that contain dokuwiki code and placeholders for data and "data page" for those that contain the actual data that will be inserted into those placeholders. | Я буду продолжать использовать термин «структурная страница» для страниц, которые содержат разметку «ДокуВики» и указатели места заполнения (метки) для данных и «страниц данных», которые содержат информацию для заполнения по соответствующшим меткам. | |
Both types of pages can be viewed when browsing the wiki. The structure page will be displayed as is, whereas the data page is displayed as the final compiled page, structure and all. | Оба типа страниц могут быть просмотрены через вики. Структурные страниц будут отображаться как есть, а страницы с информацией будут отображатся в скомпилированном (собранном) виде (т. е. данные, расположенные в соответствии с определённой структурой). | |
Please note that I wrote this plugin to solve a very specific problem so some of the functionality may not be generally useful. | Пожалуйста, обратите внимание, что плагин написан для решения конкретных задач, так что некоторые функции не могут быть в целом полезным. | |
This is also my first dokuwiki plugin and I'm not very experienced with php, so this plugin very possibly contains security issues and bugs. | Это мой первый плагин для «ДокуВики». И я не очень опытен с PHP, поэтому, возможно, что код плагина содержит уязвимости в безопасности и ошибки. | |
=== Declaring the structure page === | ||
All replacement commands look like the following: ~~COMMAND(x[,var]):param1[:param2[:param3]]~[!]~ | Команды замещения выглядят следующим образом: ~~COMMAND(x[,var]):param1[:param2[:param3]]~[!]~ | |
* The available commands are listed below. | ||
* "var" is optional. If set, the result of this replacement will be stored in a variable by that name and can later be used again. | * «var» — необязателен. Если он задан, результат замены будет сохранён в переменной с этим именем и впоследствии может быть использован повторно. | |
* "x" is the "pass" during which the placeholder should be replaced. This will be 0 most of the time, but on some occasions, you may need more control over the order in which things get replaced. If you don't get the point, the list-command is a common case where using different passes makes sense and it should become obvious why. | * «x» — задаёт последовательность операций, во время которых происходит замена меток (placeholder). В основном значение данного параметра равно нулю, за исключением случаев, когда требуется контроль над очерёдностью (последовательностью) проведения замен. Если это не очень понятно: список команд --- это основа, где возможно использование различной последовательности действий по замене (FIXME). | |
* depending on the command specified, up to three parameters are required, separated by colons. Please note that a parameter could also be another replacement command, they will be interpreted inner-to-outer automatically. | * В зависимости от заданной команды, требуется до трёх параметров, разделёных двоеточиями. Заметьте, что параметр может быть также следующей заменяющей командой, при этом вложенность замен разбирается автоматически от самой последней к самой первой. | |
* finally, you may place a ! between the final two ~ to have MyTemplate not output anything. This makes sense if you want to calculate an intermediate result to be used later. | * Чтобы плагин ничего не выводил, вы можете разместить восклицательный знак (!) между двух тильд (~), стоящих в конце строки. Это имеет смысл, если вы хотите получить промежуточные результаты, которые будут использоваться позже. | |
Available Commands: |
© Себастьян Херборт. License: CC Attribution-NonCommercial-ShareAlike 3.0 Unported
— temirgaleev’у спасибо за помощь в переводе. — alexgearbox