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

Voljik (обсуждение | вклад)
Нет описания правки
 
(не показаны 22 промежуточные версии 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 ===
'''5.''' Перетащить карточку Trello в колонку Done <br>
Справка по работе с картинками <br>
'''6.''' Скушать печеньку и по возможности перейти к п1 и следующей задаче :)<br>
(на английском) https://www.mediawiki.org/wiki/Help:Images <br>
 
(на русском) https://www.mediawiki.org/wiki/Help:Images/ru <br>
<br>
<hr>




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


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


=====Как создать новую страничку=====
<br>
<hr>
===Как создать новую страничку===
Если в списке категорий уже есть ссылка с названием нужной несуществующей страницы (такие ссылки отображаются красным и при наведении курсора всплывает подсказка "страница не существует"), то можно просто нажать на нее и перейти на страницу редактирования новой статьи. После добавления текста и нажатия кнопки «Записать страницу» новая страница будет создана.
Если в списке категорий уже есть ссылка с названием нужной несуществующей страницы (такие ссылки отображаются красным и при наведении курсора всплывает подсказка "страница не существует"), то можно просто нажать на нее и перейти на страницу редактирования новой статьи. После добавления текста и нажатия кнопки «Записать страницу» новая страница будет создана.
[[Файл:Страница не существует.png|thumb|center|600px|Ссылка на несуществующую страницу]]<br>
[[Файл:Страница не существует.png|thumb|center|600px|Ссылка на несуществующую страницу]]<br>
Строка 88: Строка 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>
Строка 117: Строка 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>
<hr>
==Как добавить картинку или PDF==
При добавлении картинки или документа нужно:
* при загрузке файла в wiki указать понятное название, соответствующее его содержимому
* на странице рядом добавить ключевые слова и текст с описанием файла (краткое содержание, рассматриваемые вопросы или основные темы)
* по возможности указать ссылку на источник-оригинал
* добавить ссылку на файл в wiki / превью-pdf (если не нужен просмотр прямо на страничке, то небольшого размера (h=100px), если нужен просмотр, то в зависимости от ширины pdf-страницы)


=====Как добавить картинку или PDF=====
Вставить > Изображения и медиафайлы > выбрать файл > заполнить необходимые поля (в том числе название) > после завершения загрузки выбрать "Вставить" для добавления на страничку
Вставить > Изображения и медиафайлы > выбрать файл > заполнить необходимые поля > после завершения загрузки выбрать "Вставить" для добавления на страничку
[[Файл:Добавление файлов.png|thumb|center|600px|]]
[[Файл:Добавление файлов.png|thumb|center|600px|]]
[[Файл:Добавление файлов - окно загрузки.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>
Или<br>
2) Уменьшить размер pdf-файла (при этом может сильно пострадать качество)<br>
'''Mac'''
https://support.apple.com/guide/preview/compress-a-pdf-prvw1509/mac - вверху страницы при необходимости можно выбрать версию системы
To save storage space, you can compress a PDF in Preview.
Note: When compressed, the PDF may be of lower quality than the original.<br>
1. In the Preview app  on your Mac, open the PDF that you want to compress (in Finder - select file - right-click - Open with - Preview)
2. Choose File > Export (Don’t choose Export as PDF)
3. Click the Quartz Filter pop-up menu, then choose Reduce File Size.
4. Check the quality and file size again.


'''Для картинок'''<br>
Как уменьшить размер картинки:<br>
Как уменьшить размер картинки:<br>
  '''In Windows 10'''
  '''In Windows 10'''
  Check the file size - right/click/properties
  Check the file size - right-click - Properties
  Right-click the file
  Right-click the file- Select Edit, file opens in Paint (hopefully)
Select Edit, file opens in Paint (hopefully)
  Click resize
  Click resize
  Reduce percentage by desired number
  Reduce percentage by desired number
  Save
  Save
  Check the file size again
  Check the file size again - if greater than 2 MB, rinse and repeat
If greater than 2 MB, rinse and repeat


=====Как вставить PDF-файл с превьюшкой  =====
'''Mac'''
https://support.apple.com/guide/preview/resize-rotate-or-flip-an-image-prvw2015/11.0/mac/13.0 - вверху страницы при необходимости можно выбрать версию системы
Reduce an image’s file size
1. In the Preview app  on your Mac, open the file you want to change.
2. Choose Tools > Adjust Size, then select “Resample image.”
3. Enter a smaller value in the Resolution field.
4. The new size is shown at the bottom.<br>
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.
 
<br>
<hr>
==Как вставить PDF-файл с превьюшкой  ==
  Можно показывать целиком PDF и регулировать размер вот так:
  Можно показывать целиком PDF и регулировать размер вот так:
  1) Загрузить (upload) файл в Вики;
  1) Загрузить (upload) файл в Вики;
Строка 164: Строка 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>
==Раздел "Склад информации для редактора страницы"==
Раздел "Склад информации для редактора страницы" используется для временного добавления информации, которая требует дополнительной обработки. В дальнейшем она разбирается по соответствующим разделам.
Раздел "Склад информации для редактора страницы" используется для временного добавления информации, которая требует дополнительной обработки. В дальнейшем она разбирается по соответствующим разделам.


Строка 170: Строка 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]) и при необходимости внести в данный список вместе с ответами.