Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия Последняя версия Следующая версия справа и слева | ||
страница_документации [28.10.2016 21:58] admin [Картинки-ссылки] |
страница_документации [08.11.2016 14:40] admin |
||
---|---|---|---|
Строка 31: | Строка 31: | ||
===== Страницы, идентификаторы, ссылки, создание страниц ===== | ===== Страницы, идентификаторы, ссылки, создание страниц ===== | ||
- | Каждая страница имеет свой уникальный идентификатор. Идентификатор страницы может содержать маленькие русские или английские буквы, цифры и знак "_". Еще в идентификаторе может быть двоеточие, см. ниже. Идентификатор страницы отображается вверху страницы в квадратных скобках (у этой страницы идентификатор "страница_документации"). | + | Каждая страница имеет свой уникальный идентификатор. Идентификатор страницы может содержать маленькие русские или английские буквы, цифры, знаки "-", "_". Еще в идентификаторе может быть двоеточие, см. ниже. Идентификатор страницы отображается вверху страницы в квадратных скобках (у этой страницы идентификатор "страница_документации"). |
- | Чтобы создать ссылку на другую страницу вики, нужно указать идентификатор страницы в двойных квадратных скобках: [[тестовая_страница_для_документации]]. Можно также сделать ссылку с [[тестовая_страница_для_документации|с другим текстом]]. | + | Чтобы создать ссылку на другую страницу вики, нужно указать идентификатор страницы в двойных квадратных скобках: [[тестовая_страница_для_документации]]. Можно также сделать ссылку с [[тестовая_страница_для_документации|другим текстом]]. |
<code>Чтобы создать ссылку на другую страницу вики, нужно указать | <code>Чтобы создать ссылку на другую страницу вики, нужно указать | ||
идентификатор страницы в двойных квадратных | идентификатор страницы в двойных квадратных | ||
скобках: [[тестовая_страница_для_документации]]. Можно также сделать | скобках: [[тестовая_страница_для_документации]]. Можно также сделать | ||
- | ссылку с [[тестовая_страница_для_документации|с другим текстом]].</code> | + | ссылку с [[тестовая_страница_для_документации|другим текстом]].</code> |
- | Чтобы создать новую страницу, нужно сначала создать ссылку на нее, указав идентификатор новой страницы: [[несуществующая страница для документации]]. После чего можно перейти по этой ссылке и создать страницу. Можно, впрочем, ее и не создавать. При создании страницы ее идентификатор автоматически преобразуется в нижний регистр, пробелы заменяются на "_". | + | Чтобы создать новую страницу, нужно сначала создать ссылку на нее, указав идентификатор новой страницы: [[Несуществующая страница для документации]]. После чего можно перейти по этой ссылке и создать страницу. Можно, впрочем, ее и не создавать. При создании страницы ее идентификатор автоматически преобразуется в нижний регистр, пробелы заменяются на "_". |
<code>Чтобы создать новую страницу, нужно сначала создать ссылку на нее, | <code>Чтобы создать новую страницу, нужно сначала создать ссылку на нее, | ||
- | указав идентификатор новой страницы: [[несуществующая страница для документации]]. | + | указав идентификатор новой страницы: [[Несуществующая страница для документации]]. |
После чего можно перейти по этой ссылке и создать страницу. Можно, впрочем, | После чего можно перейти по этой ссылке и создать страницу. Можно, впрочем, | ||
ее и не создавать. При создании страницы ее идентификатор автоматически | ее и не создавать. При создании страницы ее идентификатор автоматически | ||
Строка 52: | Строка 52: | ||
===== Разделы (namespace) ===== | ===== Разделы (namespace) ===== | ||
- | Разделы (в официальной документации DokuWiki они называются namespace - пространства имен) - это способ группировать разные страницы. Чтобы сделать страницу в разделе, нужно указать идентификатор раздела в идентификаторе страницы, через двоеточие [[тестовый_раздел:тестовая_страница_в_разделе]]. Зайдите [[тестовый_раздел:тестовая_страница_в_разделе|сюда]] и обратите внимание, как изменился блок "Вы находитесь здесь" (вверху). А еще пройдите по ссылке "Все страницы" вверху и посмотрите, как аккуратно все сгруппировано по разделам. | + | Разделы (в официальной документации DokuWiki они называются namespace - пространства имен) - это способ группировать разные страницы. Чтобы сделать страницу в разделе, нужно указать идентификатор раздела в идентификаторе страницы, через двоеточие [[тестовый_раздел:тестовая_страница_в_разделе]]. Зайдите [[тестовый_раздел:тестовая_страница_в_разделе|сюда]] и обратите внимание, как изменился блок "Вы находитесь здесь" (вверху). А еще пройдите по ссылке "Все страницы" вверху и посмотрите, как аккуратно страницы группируются |
+ | по разделам (не все, конечно, но хотя бы некоторые %%=)%%. | ||
<code>Разделы (в официальной документации DokuWiki они называются namespace - | <code>Разделы (в официальной документации DokuWiki они называются namespace - | ||
Строка 60: | Строка 61: | ||
Зайдите [[тестовый_раздел:тестовая_страница_в_разделе|сюда]] и обратите внимание, | Зайдите [[тестовый_раздел:тестовая_страница_в_разделе|сюда]] и обратите внимание, | ||
как изменился блок "Вы находитесь здесь" (вверху). А еще пройдите по ссылке | как изменился блок "Вы находитесь здесь" (вверху). А еще пройдите по ссылке | ||
- | "Все страницы" вверху и посмотрите, как аккуратно все сгруппировано | + | "Все страницы" вверху и посмотрите, как аккуратно страницы группируются |
- | по разделам.</code> | + | по разделам (не все, конечно, но хотя бы некоторые %%=)%%.</code> |
При создании страницы с разделом раздел создается автоматически. | При создании страницы с разделом раздел создается автоматически. | ||
Строка 78: | Строка 79: | ||
Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков 3-го уровня и выше, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку %%~~NOTOC~~%%. | Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков 3-го уровня и выше, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку %%~~NOTOC~~%%. | ||
- | |||
====== Заголовок 1-го уровня ====== | ====== Заголовок 1-го уровня ====== | ||
===== Заголовок 2-го уровня ===== | ===== Заголовок 2-го уровня ===== | ||
Строка 107: | Строка 107: | ||
Если у страницы нет заголовка, то по умолчанию ее идентификатор используется в качестве названия в ссылках и блоке "Вы находитесь здесь": [[тестовая_страница_без_заголовка]]. Если же у страницы есть хотя бы один заголовок, то в качестве названия используется заголовок: [[тестовый_раздел_с_заголовком:тестовая_страница_с_заголовком]]. Заголовок страницы может содержать любые символы и вообще обычно более красивый, чем идентификатор. | Если у страницы нет заголовка, то по умолчанию ее идентификатор используется в качестве названия в ссылках и блоке "Вы находитесь здесь": [[тестовая_страница_без_заголовка]]. Если же у страницы есть хотя бы один заголовок, то в качестве названия используется заголовок: [[тестовый_раздел_с_заголовком:тестовая_страница_с_заголовком]]. Заголовок страницы может содержать любые символы и вообще обычно более красивый, чем идентификатор. | ||
- | |||
- | |||
===== Ссылки на другие сайты ===== | ===== Ссылки на другие сайты ===== | ||
Строка 122: | Строка 120: | ||
тоже распознаются: <andi@splitbrain.org>.</code> | тоже распознаются: <andi@splitbrain.org>.</code> | ||
+ | Ссылки на внешние сайты, в отличие от ссылок на страницы вики, автоматически выделяются курсивом. | ||
Строка 158: | Строка 156: | ||
<code>Это правильная ссылка, которая не работает, т.к. не оканчивается на .jpg {{https://img-fotki.yandex.ru/get/105765/31216099.e4d/0_fb46d_55ee430b_M}}</code> | <code>Это правильная ссылка, которая не работает, т.к. не оканчивается на .jpg {{https://img-fotki.yandex.ru/get/105765/31216099.e4d/0_fb46d_55ee430b_M}}</code> | ||
- | В теории, DokuWiki также поддерживает загрузку картинок непосредственно на наш сайт, но НаБегу эта возможность пока что отключена. | + | В теории, DokuWiki также поддерживает загрузку картинок непосредственно на наш сайт, но НаБегу эта возможность пока что отключена, т.к. место на хостинге ограничено. |
===== Картинки-ссылки ===== | ===== Картинки-ссылки ===== |