Редактируем страницы в Wiki: различия между версиями

Voljik (обсуждение | вклад)
 
(не показано 18 промежуточных версий 5 участников)
Строка 1: Строка 1:
[[Категория:Документы Рубикуса]]
[[Категория:Документы Рубикуса]]
'''Документы, Рубикус, Рубикус wiki, Для редакторов'''


__TOC__
==Как найти нужную страничку==
Подходящую страничку можно найти в списках категорий [[Оглавление|главной страницы Вики]] или в набрав ключевые слова в поиске. 


====Шаблон краткой инструкция для карточки в Trello====
<br>
Что делать:<br>
<hr>
1. Выбрать задачу в колонке To Do, перетащить ее в колонку Doing и добавить в заголовок свой логин в Телеграме @...<br>
==Куда именно поместить информацию на страничке==
2. Открыть файл <span style="color:red">%номер файла%</span> из Новый Rubikus drive list <span style="color:red">%ссылка на файл%</span> и перенести содержимое на соответствующие странички Вики.<br>
Текстовая информация, включая ссылки, переносится в раздел ‘Склад информации для редактора страницы’ вместе с ключевыми словами.
a. Ссылка на главную страницу Вики:
Картинки, pdfы можно приложить к страничке (загрузить файл) и потом добавить в виде ссылки на получившийся wiki-файл. 
http://wiki.helpua.rubikus.de/mw/index.php/%D0%9E%D0%B3%D0%BB%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5<br>
b. Подходящую страничку можно найти в списках категорий главной страницы или в набрав ключевые слова в поиске.<br>
c. Текстовая информация, включая ссылки, переносится в раздел ‘Склад информации для редактора страницы’ вместе с ключевыми словами.<br>
Картинки, pdfы можно приложить к страничке (загрузить файл) и потом добавить в виде ссылки на получившийся wiki-файл.<br>
d. ‌Если страница в Куме, куда вы собираетесь переносить информацию, ещё не создана, ее можно создать и внести в список соответствующей категории. Страницы для документов, которые пока невозможно отнести к каким-то конкретным категориям, можно временно создать в разделе ‘Темы’ главной страницы.<br>
3. После завершения обработки файлов, отметить соответствующие строки в табличке 'Новый список файлов из Базы знаний' https://docs.google.com/spreadsheets/d/1ZJeaO_T9_vlc5mpDfq0phQ01wUOcETExJMQhXpPuOiU/edit#gid=0 (выделить цветом и заполнить клетки Notes / In wiki).<br>
4. Перенести файл базы знаний в папку 'In Wiki' https://drive.google.com/drive/folders/112kF1EJkoAwmou8Oh6Iuxbqp0WynhsnB?usp=sharing<br>
5. Перетащить карточку в колонку Done.<br>


====Инструкция по переносу====
Редакторы тем переносят информацию из документов или Склада в соответствующие разделы.


Текущий список заданий по переносу документации можно посмотреть на [https://trello.com/b/77aHUtWF/%D0%BF%D0%B5%D1%80%D0%B5%D0%BD%D0%BE%D1%81%D0%B8%D0%BC-%D0%B2-%D0%B2%D0%B8%D0%BA%D0%B8 доске Trello] (если у вас пока нет доступа к доске, нужно запросить его - request access)<br>
<br>
<hr>
==Форматирование текста в wiki==
Справка по форматированию <br>
(на русском) https://www.mediawiki.org/wiki/Help:Formatting/ru<br>
(на английском) https://www.mediawiki.org/wiki/Help:Formatting<br>


[[Файл:Trello доска.png|thumb|center|600px|Карточки с заданиями на доске в Trello]]
===Переносы строк при добавлении информации на wiki===
<br>
Переносы строк добавляются с помощью <nowiki><br></nowiki> или пустой строкой между 2мя строками.
'''1.''' Для начала работы нужно выбрать карточку в колонке To Do, перетащить ее в колонку Doing и добавить в заголовок свой логин в Телеграме (@...) (так будет проще найти, кто в данный момент работает над заданием). <br>
{| class="wikitable"
Отредактировать заголовок можно, открыв карточку на просмотр, или прямо в колонке (навести курсор на карточку - появится значок редактирования (картинка ниже) - нажать на него - после внесения изменений нажать Save)<br>
|-
[[Файл:Редактирование заголовка карточки.png|thumb|center|200px|Изменение заголовка в карточке]]
! Описание !!Код страницы в режиме редактирования!! Отображение на странице после сохранения
<br>
|-
'''2.''' После этого открыть ссылки с файлами из описания своей задачи и перенести содержимое на подходящие странички Вики.<br>  
| Стандартное копирование 2х строк из документа на страничку (в результате строки сливаются в одну) || Первая строка<br>Вторая строка || Первая строкаВторая строка
{|
|-
|+
| Использование <nowiki><br></nowiki> || Первая строка<nowiki><br></nowiki><br>Вторая строка || Первая строка<br>Вторая строка
|-
|-
| [[Файл:Карточка Trello с заданием 2.png|thumb|center|400px|Открытая карточка с заданием (новый шаблон описания)]] || [[Файл:Карточка Trello с заданием.png|thumb|center|400px|Открытая карточка с заданием (старый шаблон описания)]]
| Перенос с помощью дополнительной пустой строки|| Первая строка<br><br>Вторая строка || Первая строка<br>Вторая строка
|}
|}
=== Добавление ссылок (внешние, внутренние, email) ===
Справка по добавлению ссылок<br>
(на русском) https://www.mediawiki.org/wiki/Help:Links/ru<br>
(на английском) https://www.mediawiki.org/wiki/Help:Links<br>


'''Как переносить:'''<br>
Как вставить ссылку на email:  
* Подходящую страничку можно найти в списках категорий [[Оглавление|главной страницы Вики]] или в набрав ключевые слова в поиске. [[Переносим_документы_в_wiki#Как_найти_нужную_страничку|Как найти нужную страничку]]<br>
{| class="wikitable"
* Для редактирования wiki-странички нажать Править или Править код в соответствующем разделе страницы (или справа вверху для всей страницы).<br>
|-
* Текстовая информация, включая ссылки, переносится в раздел ‘Склад информации для редактора страницы’ вместе с ключевыми словами. Картинки, pdfы можно приложить к страничке (загрузить файл) и потом добавить в виде ссылки на получившийся wiki-файл. [[Переносим_документы_в_wiki#Как_добавить_картинку_или_PDF|Как добавить картинку или PDF]] <br>
! Код странички в режиме редактирования !! Отображение текста после сохранения
* Если странички для страны нет, ее можно создать и внести в список соответствующей категории. Страницы для документов, которые пока невозможно отнести к каким-то конкретным странам или категориям, можно временно создать в разделе "Темы" главной страницы. [[Переносим_документы_в_wiki#Как_создать_новую_страничку|Как создать новую страничку]]<br>
|-
 
| <nowiki>[mailto:info@example.org email me]</nowiki> || [mailto:info@example.org email me]
 
|-
'''3.''' После завершения обработки файлов, отметить соответствующие строки в табличке [https://docs.google.com/spreadsheets/d/1ZJeaO_T9_vlc5mpDfq0phQ01wUOcETExJMQhXpPuOiU/edit#gid=0/ "Новый список файлов из Базы знаний"] (выделить цветом и заполнить клетки Notes / In wiki)<br>
| контакты лучше вставлять с видимым адресом почты, так будет проще скопировать/сохранить при необходимости <nowiki>[mailto:info@example.org info@example.org]</nowiki> || [mailto:info@example.org info@example.org]
'''4.''' Перенести обработанный файл базы знаний в папку [https://drive.google.com/drive/folders/112kF1EJkoAwmou8Oh6Iuxbqp0WynhsnB?usp=sharing 'In Wiki']
 
Меню File - Move - в появившемся окне при необходимости с помощью стрелочки ← перейти в папку "База знаний Rubikus.helpUA", выбрать в списке папку In Wiki - нажать кнопку Move here
{|
|+
|-
|-
| [[Файл:Перенос обработанного файла - шаг 1.png|thumb|center|300px|]] || [[Файл:Перенос обработанного файла - шаг 2.png|thumb|center|300px|]]
| то же самое с телефонами <nowiki>[tel:+1234567890 +1 (23) 456-78-90]</nowiki> || [tel:+1234567890 +1 (23) 456-78-90]
|}
|}


=== Картинки в wiki ===
Справка по работе с картинками <br>
(на английском) https://www.mediawiki.org/wiki/Help:Images <br>
(на русском) https://www.mediawiki.org/wiki/Help:Images/ru <br>
<br>
<hr>


'''5.''' Перетащить карточку Trello в колонку Done <br>
'''6.''' Скушать печеньку и по возможности перейти к п1 и следующей задаче :)<br>
====Частые вопросы====
=====Как найти нужную страничку=====
Подходящую страничку можно найти в списках категорий [[Оглавление|главной страницы Вики]] или в набрав ключевые слова в поиске. 
=====Куда именно поместить информацию на страничке=====
Текстовая информация, включая ссылки, переносится в раздел ‘Склад информации для редактора страницы’ вместе с ключевыми словами.
Картинки, pdfы можно приложить к страничке (загрузить файл) и потом добавить в виде ссылки на получившийся wiki-файл. 


Редакторы тем переносят информацию из документов или Склада в соответствующие разделы.
==Работа со страницами==


=====Что делать если странички нет=====
===Что делать если странички нет===
Если страница в Куме, куда вы собираетесь переносить информацию, ещё не создана, ее нужно создать и внести в список соответствующей категории. Страницы для документов, которые пока невозможно отнести к каким-то конкретным категориям, можно временно создать в разделе ‘Темы’ главной страницы.<br>
Если страница в Вики, куда вы собираетесь переносить информацию, ещё не создана, ее нужно создать и внести в список соответствующей категории. Страницы для документов, которые пока невозможно отнести к каким-то конкретным категориям, можно временно создать в разделе ‘Темы’ главной страницы.<br>
Информация добавляется прямо на новую страничку (с подзаголовком "Склад информации для редактора страницы"), остальная разметка с разделами будет добавлена позже.
Информация добавляется прямо на новую страничку (с подзаголовком "Склад информации для редактора страницы"), остальная разметка с разделами будет добавлена позже.


=====Как создать новую страничку=====
<br>
<hr>
===Как создать новую страничку===
Если в списке категорий уже есть ссылка с названием нужной несуществующей страницы (такие ссылки отображаются красным и при наведении курсора всплывает подсказка "страница не существует"), то можно просто нажать на нее и перейти на страницу редактирования новой статьи. После добавления текста и нажатия кнопки «Записать страницу» новая страница будет создана.
Если в списке категорий уже есть ссылка с названием нужной несуществующей страницы (такие ссылки отображаются красным и при наведении курсора всплывает подсказка "страница не существует"), то можно просто нажать на нее и перейти на страницу редактирования новой статьи. После добавления текста и нажатия кнопки «Записать страницу» новая страница будет создана.
[[Файл:Страница не существует.png|thumb|center|600px|Ссылка на несуществующую страницу]]<br>
[[Файл:Страница не существует.png|thumb|center|600px|Ссылка на несуществующую страницу]]<br>
Строка 90: Строка 82:
[[Файл:Добавление ссылки на страницу (редактирование кода).png|thumb|center|500px|]]
[[Файл:Добавление ссылки на страницу (редактирование кода).png|thumb|center|500px|]]


 
<br>
=====Как добавить новую страничку в список категории на Главной странице=====
<br>
<hr>
===Как добавить новую страничку в список категории на Главной странице===
Если страница, которую нужно добавить, еще не существует, то смотри [[Переносим_документы_в_wiki#Как_создать_новую_страничку|Как создать новую страничку]]<br>
Если страница, которую нужно добавить, еще не существует, то смотри [[Переносим_документы_в_wiki#Как_создать_новую_страничку|Как создать новую страничку]]<br>
Если нужно добавить ссылку на уже существующую страницу, то можно просто выбрать ее название при создании ссылки:
Если нужно добавить ссылку на уже существующую страницу, то можно просто выбрать ее название при создании ссылки:
[[Файл:Добавление ссылки на существующую страницу.png|thumb|center|500px]]
[[Файл:Добавление ссылки на существующую страницу.png|thumb|center|500px]]


=====Куда добавить новую страничку, если она не подходит ни в одну из категорий, существующих на Главной странице=====
<br>
<br>
<hr>
===Куда добавить новую страничку, если она не подходит ни в одну из категорий, существующих на Главной странице===
Страницы для документов, которые пока невозможно отнести к каким-то конкретным странам или категориям, можно временно создать в разделе "Темы" главной страницы.
Страницы для документов, которые пока невозможно отнести к каким-то конкретным странам или категориям, можно временно создать в разделе "Темы" главной страницы.
[[Файл:Раздел Темы.png|thumb|center|400px]]
[[Файл:Раздел Темы.png|thumb|center|400px]]


=====Как добавить категорию на страницу=====
<br>
<br>
<hr>
===Как добавить текст другой страницы целиком в другую===
Чтобы включить текст другой страницы (например, страницы под названием "Социальная поддержка в Швамбрании"), вам достаточно вставить следующий код в основную:
<nowiki>{{:Социальная поддержка в Швамбрании}}</nowiki>
 
===Как исключить часть содержимого другой страницы от добавления в другую===
Вам поможет тэг <nowiki><noinclude></nowiki>
 
Например, если вы активно пользуетесь реферальными ссылками (тэг <nowiki><ref></nowiki>) на странице, которая импортируется в другую, вам имеет смысл сделать раздел
 
<nowiki>
<noinclude></nowiki>
<br/>
<nowiki>=== Ссылки и источники ===</nowiki>
<br/>
<nowiki></noinclude>
</nowiki>
 
(обязательно сохраните переносы строк)
 
==Как добавить категорию на страницу==
Для добавления категории на страницу нужно добавить метку <nowiki>[[Категория:НазваниеКатегории]]</nowiki> <br>
Для добавления категории на страницу нужно добавить метку <nowiki>[[Категория:НазваниеКатегории]]</nowiki> <br>
Например: <nowiki>[[Категория:Австралия]]</nowiki>
Например: <nowiki>[[Категория:Австралия]]</nowiki>
Строка 119: Строка 138:
<nowiki>[[Категория:Австралия]]</nowiki>
<nowiki>[[Категория:Австралия]]</nowiki>


 
<br>
=====Как добавлять ключевые слова / метки для ссылок=====
<br>
<hr>
==Как добавлять ключевые слова / метки для ссылок==
Ключевые слова - это обычные текстовые метки для ссылок, которые позволяют отнести ее к какой-то категории без необходимости открытия и улучшают работу поиска.  
Ключевые слова - это обычные текстовые метки для ссылок, которые позволяют отнести ее к какой-то категории без необходимости открытия и улучшают работу поиска.  
Для каждой ссылки (на внешний ресурс, PDF и тд) помимо меток желательно также добавить краткое описание.
Для каждой ссылки (на внешний ресурс, PDF и тд) помимо меток желательно также добавить краткое описание.


Пример:
Пример:
[[Файл:Пример меток для ссылок на странице.png|thumb|center|300px|]]
[[Файл:Пример меток для ссылок на странице.png|thumb|center|400px|]]


Список основных ключевых слов можно найти в файле https://docs.google.com/spreadsheets/d/1hgb2VpnFN90Z5xfHq0vTyWikFY3PWDDm/
Список основных ключевых слов можно найти в файле https://docs.google.com/spreadsheets/d/1hgb2VpnFN90Z5xfHq0vTyWikFY3PWDDm/


 
<br>
=====Как добавить картинку или PDF=====
<hr>
При добавлении картинки или документа для них нужно указать понятное название, соответствующее его содержимому.
==Как добавить картинку или PDF==
При добавлении картинки или документа нужно:
* при загрузке файла в wiki указать понятное название, соответствующее его содержимому
* на странице рядом добавить ключевые слова и текст с описанием файла (краткое содержание, рассматриваемые вопросы или основные темы)
* по возможности указать ссылку на источник-оригинал
* добавить ссылку на файл в wiki / превью-pdf (если не нужен просмотр прямо на страничке, то небольшого размера (h=100px), если нужен просмотр, то в зависимости от ширины pdf-страницы)


Вставить > Изображения и медиафайлы > выбрать файл > заполнить необходимые поля (в том числе название) > после завершения загрузки выбрать "Вставить" для добавления на страничку
Вставить > Изображения и медиафайлы > выбрать файл > заполнить необходимые поля (в том числе название) > после завершения загрузки выбрать "Вставить" для добавления на страничку
Строка 137: Строка 163:
[[Файл:Добавление файлов - окно загрузки.png|thumb|center|400px|]]
[[Файл:Добавление файлов - окно загрузки.png|thumb|center|400px|]]


<span style="color:red">TODO: как вставить на страницу существующий файл</span>
<span style="color:red">как вставить на страницу существующий файл</span>
<PRE>
[[Файл:Рубикус-Хельсинки-паромы.pdf|Паромы Таллинн-Хелсинки]]
</PRE>


Полезные ссылки:<br>
Полезные ссылки:<br>
[http://wiki.helpua.rubikus.de/mw/index.php/%D0%A1%D0%BB%D1%83%D0%B6%D0%B5%D0%B1%D0%BD%D0%B0%D1%8F:%D0%97%D0%B0%D0%B3%D1%80%D1%83%D0%B7%D0%BA%D0%B0 Служебная страница-форма для загрузки файлов]
[http://wiki.helpua.rubikus.de/mw/index.php/%D0%A1%D0%BB%D1%83%D0%B6%D0%B5%D0%B1%D0%BD%D0%B0%D1%8F:%D0%97%D0%B0%D0%B3%D1%80%D1%83%D0%B7%D0%BA%D0%B0 Служебная страница-форма для загрузки файлов]<br>
[https://www.mediawiki.org/wiki/Help:Images| Как работать с картинками в wiki]
<br>
<hr>


=====PDF-файл или картинка слишком большие / File exceeds 2 MB  =====
==PDF-файл или картинка слишком большие / File exceeds 2 MB  ==
'''Для PDF''' <br>
'''Для PDF''' <br>
1) Весь текст вставить как обычный текст, а картинки обрезать и вставить отдельно. Т.е. превратить pdf в wiki-текст c картинками<br>
1) Весь текст вставить как обычный текст, а картинки обрезать и вставить отдельно. Т.е. превратить pdf в wiki-текст c картинками<br>
Строка 175: Строка 207:
  Tip: To reduce the file size of multiple images at the same time, [https://support.apple.com/guide/preview/display-several-files-in-one-preview-window-prvw1085/11.0/mac/13.0 display the images in the same window], select them in that window’s sidebar, then choose Tools > Adjust Size.
  Tip: To reduce the file size of multiple images at the same time, [https://support.apple.com/guide/preview/display-several-files-in-one-preview-window-prvw1085/11.0/mac/13.0 display the images in the same window], select them in that window’s sidebar, then choose Tools > Adjust Size.


=====Как вставить PDF-файл с превьюшкой  =====
<br>
<hr>
==Как вставить PDF-файл с превьюшкой  ==
  Можно показывать целиком PDF и регулировать размер вот так:
  Можно показывать целиком PDF и регулировать размер вот так:
  1) Загрузить (upload) файл в Вики;
  1) Загрузить (upload) файл в Вики;
Строка 187: Строка 221:
  <nowiki><pdf width="500" height="300">File:Example.pdf</pdf></nowiki>
  <nowiki><pdf width="500" height="300">File:Example.pdf</pdf></nowiki>


=====Раздел "Склад информации для редактора страницы"=====
<br>
<br>
<hr>
==Раздел "Склад информации для редактора страницы"==
Раздел "Склад информации для редактора страницы" используется для временного добавления информации, которая требует дополнительной обработки. В дальнейшем она разбирается по соответствующим разделам.
Раздел "Склад информации для редактора страницы" используется для временного добавления информации, которая требует дополнительной обработки. В дальнейшем она разбирается по соответствующим разделам.


Строка 193: Строка 230:
Если его нет, то при необходимости можно вручную добавить с заголовком соответствующего уровня в самом конце страницы.
Если его нет, то при необходимости можно вручную добавить с заголовком соответствующего уровня в самом конце страницы.


=====Если остались вопросы=====
<br>
Вопросы можно задать в телеграм чате для обсуждения технических вопросов Rubikus Wiki (Techical Discussions for Rubikus Wiki) и при необходимости внести в данный список вместе с ответами.
<hr>
== Дополнительные программы и утилиты для преобразования контента (pdf, excel, wiki) ==
* Convert images and PDF to text https://ocr.space/<br>
* Excel xls to wiki copy and paste converter for Wikipedia and Mediawiki https://excel2wiki.toolforge.org/index.php <br>
* Table Convert Online / Конвертер для таблиц: https://tableconvert.com/ (used to convert Excel or other spreadsheets into Markdown Table / create and generate Markdown Table online via Table Editor)<br>
 
 
<br>
<br>
<hr>
 
==Если остались вопросы==
Вопросы можно задать в телеграм чате для обсуждения технических вопросов Rubikus Wiki ([https://t.me/+3mhl4evANGozOGRh Technical Discussions for Rubikus Wiki]) и при необходимости внести в данный список вместе с ответами.