Технические рекомендации к статьям, публикуемым на GIS-Lab: различия между версиями

Материал из GIS-Lab
Перейти к навигации Перейти к поиску
 
(не показано 47 промежуточных версий 3 участников)
Строка 1: Строка 1:
{{Организационное|authors}}
Если вы решили написать и/или опубликовать свою статью, заметку, описание и разместить ее на GIS-Lab, рекомендуем предварительно ознакомиться с этими рекомендациями. Цель этих рекомендаций сделать материалы более качественными, а их появление на GIS-Lab более оперативным.  
Если вы решили написать и/или опубликовать свою статью, заметку, описание и разместить ее на GIS-Lab, рекомендуем предварительно ознакомиться с этими рекомендациями. Цель этих рекомендаций сделать материалы более качественными, а их появление на GIS-Lab более оперативным.  


Строка 22: Строка 23:


==Создание и редактирование статьи==
==Создание и редактирование статьи==
Статьи на GIS-Lab создаются в вики. Однако, попадают в основной список статей они только после утверждения редактором.
Статьи на GIS-Lab создаются и редактируются в специальном инструменте - [http://wiki.gis-lab.info вики]. Цель этого инструмента - обеспечить возможность совместной работы.


Для создания новой страницы наберите ее название в строке поиска в правом верхнем углу и нажмите "Перейти". На странице результатов поиска будет ссылка, по которой нужно перейти для создания страницы. Найти созданную страницу можно например через [[Служебная:AllPages|список всех страниц]]
Перед созданием документа, необходимо зайти в вики под своей учетной записью, используя имя пользователя и пароль с форума. Если у вас их еще нет - сначала [http://gis-lab.info/forum/ucp.php?mode=register зарегистрируйтесь]. Иначе, при попытке редактирования или создания страницы будет выдаваться сообщение что редактировать/создавать страницы могут только участники из группы «Участники».


Используйте <code><nowiki>{{Статья|Черновик}}</nowiki></code> в самом начале текста для обозначения черновиков статей.
После входа в вики, для создания новой страницы наберите ее название в строке поиска в правом верхнем углу и нажмите кнопку "Перейти". На странице результатов поиска первой будет ссылка, нажатие которой приведет к созданию новой страницы.
 
Найти созданную страницу в дальнейшем можно например через [[Служебная:AllPages|список всех страниц]] или группу Черновики, если вы задали при создании соответствующую категорию.


Заголовок статьи должен быть на русском и отражать содержание статьи.
Заголовок статьи должен быть на русском и отражать содержание статьи.
===Черновик===
По правилам сайта созданная статья должна некоторое время оставаться черновиком. Чтобы она попала в нужный список, сразу после создания добавьте: <code><nowiki>{{Статья|Черновик}}</nowiki></code> в первой строке.


==Шаблон==
==Шаблон==
Специального шаблона для создания статьи пока нет.
Специального шаблона для создания статьи пока нет.


В качестве примеров рекомендуем использовать другие статьи из списка опубликованных.
В качестве примеров рекомендуем использовать другие статьи из списка [[Категория:Опубликованные статьи|опубликованных]].
 
==Название==
Название статьи должно быть на языке, на котором она написана, т.е. русским или английским.
 
Если необходимо использовать кавычки, то должны быть использованы т.н. «ёлочки» (Alt+0171 и Alt+0187), другие кавычки использоваться не должны.


==Текст==
==Текст==


Для текста статьи необходимо использовать набор стилей, единых для всего сайта. [http://gis-lab.info/css/styles.css Получить список стилей].
Основные используемые стили:


Основные используемые стили:
<code><nowiki>==Название главы==</nowiki></code>
 
<code><nowiki>===Название подглавы===</nowiki></code>


<span style="font-size:200%">Заголовок статьи</span>
Не используйте заголовки других уровней.


<span style="font-size:155%; font-weight:bold">1. Название главы</span>
Для списков:


<span style="font-size:135%; font-weight:bold">1.1 Название подглавы</span>
<code><nowiki>*</nowiki></code> - первый уровень элемента ненумерованного списка<br/>
<code><nowiki>**</nowiki></code> - второй уровень элемента ненумерованного списка


==Аннотации==
==Код==
Каждая статья должна иметь аннотацию, она идет сразу после служебной категории (черновик или опубликована) и отражает краткое содержание статьи, но не дублирует ее название.


Пример кода:
Если в статье приводится программный код, то его можно добавлять двумя способами. Если кода мало (1-2) строки, то можно использовать теги <code><nowiki><pre></pre></nowiki></code>
<code><nowiki>{{Аннотация|Использование выражений на языке Python для операций с полями в QGIS}}</nowiki></code>
, например:


==Иллюстрации==
<code><nowiki><pre>http://wfsserver?key1=value1&ke2=value2</pre></nowiki></code>


===Название файла===
Что будет выглядеть так:


Название файлов иллюстраций должно соответствовать схеме:
<pre>http://wfsserver?key1=value1&ke2=value2</pre>


название статьи + (0)i.расширение Например: addprjag-01.gif, addprjag-02.gif, addprjag-03.jpg
Если кода значительное количество, то можно использовать специальные теги, которые позволяют внести цветовую разметку. Например:


'''где i - порядковый номер иллюстрации''' (если меньше 10, то перед номером добавляется 0), расширение - расширение соответствующее типу изображения (см. 4.2 Формат).
<pre><syntaxhighlight lang="python">
table =  {
'library' : 1000,
'other' : 2000,
'school' : 3000
}</syntaxhighlight></pre>


===Формат===
Что будет выглядеть так:


Для полноцветных изображений рекомендуется использовать формат JPEG, со степенью сжатия не менее 50, для индексированных изображений - GIF.
<syntaxhighlight lang="python">
table =  {
'library' : 1000,
'other' : 2000,
'school' : 3000
}</syntaxhighlight>


===Местоположение===
==Аннотации==
Каждая статья должна иметь аннотацию, она идет сразу после служебной категории (черновик или опубликована) и отражает краткое содержание статьи, но не дублирует ее название.


Все иллюстрации сохраняются в общей папке images, ссылка на иллюстрацию должна выглядеть следующим образом:
Пример кода:
<code><nowiki>{{Аннотация|Использование выражений на языке Python для операций с полями в QGIS}}</nowiki></code>


'''/images/figure-01.gif'''
==Иллюстрации==
Статьи должны иллюстрироваться. Для загрузки изображений служит [http://wiki.gis-lab.info/w/%D0%A1%D0%BB%D1%83%D0%B6%D0%B5%D0%B1%D0%BD%D0%B0%D1%8F:Upload специальная страница].


===Размер===
Имя файла иллюстрации не должно быть слишком общим, <code>about</code>, <code>settings</code> и т.д. Иначе существует риск, что следующий загруженный файл с таким названием перепишет ваш. Задавайте более уникальные имена, включающие название статьи, например: <code>map-classification-grass-01.jpg</code>.


Размер иллюстраций не должен превышать 500 пикселей по горизонтали и 300 пикселей по вертикали и должен быть ограничен одной из этих осей.
Для полноцветных изображений рекомендуется использовать формат PNG или JPEG, со степенью сжатия не менее 50, для индексированных изображений - GIF.


Если вы используете копию экрана, старайтесь не уменьшать ее в графическом редакторе, если это все-таки необходимо, не уменьшайте ее более чем на 25% (т.е. она должна быть не меньше 75% оригинала).
Размер загружаемых иллюстраций не ограничен. Иллюстрации в статье должны быть ограничены 750 пикселями по ширине. Если ваша иллюстрация меньше чем 750 пикселей по ширине - не уменьшайте ее для вставки в статью, это позволит сэкономить на лишнем щелчке и открытии иллюстрации отдельно. Если ваша иллюстрация больше чем 750 пикселей по ширине, можно уменьшить ее, указав меньшую размерность, например так: <code><nowiki>[[Файл:Рис.JPG|мини|центр|300|Рис. 1. Структура папки]]</nowiki></code>


Также для больших иллюстрации можно использовать специальный скрипт, назначаемый уменьшенной копии изображения. При использовании такого подхода на странице помещается уменьшенная копия изображения, ей назначается специальный скрипт, который при нажатии на уменьшенную версию открывает изображение нормального размера (т.н. всплывающее или popup-изображение). Название файла большой иллюстрации должно быть равно названию уменьшенной копии '''+ b''', например '''figure-01.gif''' и '''figure-01b.gif'''. Пример кода:
Если вы делаете снимок экрана (скриншот), старайтесь не уменьшать его в графическом редакторе, если это все-таки необходимо, не уменьшайте ее более чем на 25% (т.е. уменьшенный результат не должен быть меньше 75% оригинала).


<source lang="html4strict">
Для того, чтобы подчеркнуть некоторую область на изображений можно выделить ее тонкой красной линией или стрелкой.
<a href="/images/garshnep-12.jpg" onClick="NewWindow(this.href,'mm','650','550','yes');return false;">
<IMG height=234 alt="Щелкните для получения увеличенного изображения" src="/images/garshnep-12b.jpg" width=300 border=0></a>
</source>
Пример того, как работает такая форма представления увеличенных изображений ([http://gis-lab.info/projects/garshnep-text.html посмотреть]).


===Акцентирование определенных участков иллюстраций===
Чтобы сделать иллюстрацию со ссылкой, сделайте так (пример):


Для того, чтобы подчеркнуть некоторую область на изображений можно выделить ее тонкой красной линией, для этого в Photoshop, необходимо загрузить изображение, выделить нужный регион с помощью инструменты выделения, выбрать из меню - Select\Modify\Border, размер 2 pix, далее Edit\Fill красным или другим цветом.
<code><nowiki>[[Файл:Nextgis.png|link=http://nextgis.ru]]</nowiki></code>


==Ссылки на дополнительные материалы и прилагаемые файлы==
==Ссылки на дополнительные материалы и прилагаемые файлы==


Ссылки на дополнительные материалы, в том числе другие разделы GIS-Lab, могут даваться как в тексте, так и в блоке "См.также", располагающегося внизу страницы. Блок "см.также" должен содержать только основные ссылки.
Ссылки на дополнительные материалы, в том числе другие разделы GIS-Lab, могут даваться как в тексте статьи, так и в блоке "См. также", располагающегося внизу страницы. Блок "См. также" должен содержать только основные ссылки.


Дополнительные файлы, ссылки на которые вы хотите дать в статье, необходимо поместить в папку '''/other''' и дать на них соответствующую ссылку.
Дополнительные файлы, ссылки на которые вы хотите дать в статье, необходимо загрузить отдельно и дать на них соответствующую ссылку. Если файлы небольшие, их можно загружать в вики в виде архивов также, как и изображения. Если файлы значительного размера, свяжитесь с [http://wiki.gis-lab.info/w/%D0%9E%D1%80%D0%B3%D0%B0%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%BE%D0%BD%D0%BD%D1%8B%D0%B5_%D0%B7%D0%B0%D0%B4%D0%B0%D1%87%D0%B8_%D0%B4%D0%BB%D1%8F_%D1%80%D0%B5%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8_%D0%BD%D0%B0_GIS-Lab координаторами GIS-Lab], чтобы вам было выделено место на сервере.


==Обсуждение в форуме==
==Обсуждение в форуме==


Каждой статье, описанию проекта и другим материалам, имеющим свою страницу на сайте должно соответствовать обсуждение на форуме GIS-Lab в разделе "Материалы сайта". Для того, чтобы вставить ссылку на обсуждение в статью, необходимо:
Каждой статье, описанию проекта и другим материалам, имеющим свою страницу на сайте должно соответствовать обсуждение на форуме GIS-Lab в разделе "Материалы сайта".  
 
а) Создать в [http://gis-lab.info/forum/viewforum.php?f=3 форуме в разделе "Материалы сайта"] соответствующую тему-обсуждение. Текст темы должен включать название статьи и интернет-ссылку на саму статью.
 
б) Получить номер темы на форуме. Для этого необходимо перейти к списку тем в [http://gis-lab.info/forum/viewforum.php?f=3 форуме в разделе "Материалы сайта"] и скопировать ссылку на обсуждение темы, она имеет вид:
 
http://gis-lab.info/forum/viewtopic.php?t=875
 
где - 875 - номер темы необходимый, для подключения ее к статьи и автоматическому отслеживанию количество постов в теме.
 
в) Вставить специальные код в html-код статьи, причем NNN необходимо заменить на код, полученный в предыдущем шаге.


<source lang="html4strict">
'''Публикация, шаг 1:''' После того, как вы сочли, что статья завершена, нужно создать тему на форуме, где дать ссылку на статью в вики и пригласить участников к её обсуждению. Следует быть готовым к критике и редактированию статьи в соответствие с замечаниями.
<p align="center" class="text">
<!--#include virtual="/scripts/forum-comments-num.php?i=NNN"-->
</p>
</source>


==Последнее обновление==
==Публикация в основном списке==
'''Публикация, шаг 2:''' После первичного обсуждения на форуме, после учета критики, нужно известить редакторов сайта. Они примут решение о публикации статьи, дадут вам окончательную ссылку на нее и сделают учетную запись автора в блоге GIS-Lab.


Каждая страница должна заканчиваться датой последнего ее обновления. Для того, чтобы эта дата автоматически обновлялась, необходимо подключить следующий скрипт:
Ваша статья попадет в основной список статей после того, как она будет ими утверждена. Посмотреть, кто принимает решение публиковать или нет статью, обратиться и задать связанные с этим вопросы можно [[Организационные задачи для реализации на GIS-Lab|здесь]].


<source lang="html4strict">
'''Публикация, шаг 3:''' Зайдите в блог GIS-Lab по адресу: https://gis-lab.info/blog/wp-admin/ с созданной для вас учетной записью и создайте тему объявление о том, что появилась новая статья. Дайте ссылку на статью (не на вики!) и обсуждение ее в форуме.
<!--#include virtual="/scripts/date.php" -->
</source>


<center>'''Спасибо за участие в нашем проекте, надеемся он станет и Вашим!'''</center>
'''Публикация, шаг 4:''' Зайдите в вики-страницу статьи и измените в начале статьи текст <nowiki>{{Статья|Черновик}}</nowiki> на <nowiki>{{Статья|Опубликована|article}}</nowiki>, где article - название файла статьи на сайте (не вики), без ".html"


[[Категория:Служебные]]
[[Категория:Служебные]]

Текущая версия от 13:51, 15 октября 2020

Эта страница опубликована на сайте в разделе «Организационные материалы»
по адресу http://gis-lab.info/qa/authors.html

Если вы решили написать и/или опубликовать свою статью, заметку, описание и разместить ее на GIS-Lab, рекомендуем предварительно ознакомиться с этими рекомендациями. Цель этих рекомендаций сделать материалы более качественными, а их появление на GIS-Lab более оперативным.

Насколько это возможно, мы пытаемся уйти от формализации, но область наших интересов требует некоего общего языка для лучшего взаимопонимания между авторами и читателями. Также, мы считаем нужным, чтобы все материалы на сайте соответствовали некому набору параметров. Эти параметры изложены ниже, надеюсь они сделают наш ресурс более интерактивным и удобным для восприятия информации.

Если вы по какой-то причине не можете или не хотите создавать страницы в вики, вы можете прислать статью и дополнительный файлы в удобном для вас формате на наш адрес и мы разместим их в нужном порядке.

Если вы не согласны с какими-либо из перечисленных критериев или имеете что добавить, пожалуйста, пишите на электронную почту, а также в обсуждение этих рекомендаций на форуме.

Тема статьи

Тема статьи должна соответствовать тематике сайта, то есть так или иначе касаться пространственных технологий. Используемое программное обеспечение значения не имеет. Результаты полученные в статье должны быть как можно более четкими и воспроизводимыми. Возможны следующие типы статей:

  • Инструкция - как решить ту или иную задачу в том или ином программном обеспечении ГИС (например: Импорт данных в формате HDF)
  • Идея, четко изложенное описание идеи, возможно без технической реализации
  • Описание проекта - описание проекта с техническими подробностями, которые могут помочь сэкономить время специалистам сталкивающимся с подобными задачами (например: Выделение местообитаний гаршнепа с помощью ДЗЗ)
  • FAQ - набор вопросов и ответов по определенной теме (например: FAQ по проекциям)
  • Описание программы - описание программного продукта краткое и более полное. Продукт может быть как свободный, так и коммерческий. Статья не должна носить явный рекламный характер, но давать четкую информацию о программном продукте без необоснованных эмоциональных комментариев (например: Описание программного продукта Google-Earth).
  • Данные - описание набора данных: бумажной карты, электронной карты, набора слоев, геобазыданных и т.д. (например: Описание данных VMap0)
  • Перевод - перевод другой статьи, при наличие соответствующего разрешения авторов изначального материала (например: Интерпретация данных Landsat TM / ETM+)

Также возможны комбинации любых вышеперечисленных типов статей.

Создание и редактирование статьи

Статьи на GIS-Lab создаются и редактируются в специальном инструменте - вики. Цель этого инструмента - обеспечить возможность совместной работы.

Перед созданием документа, необходимо зайти в вики под своей учетной записью, используя имя пользователя и пароль с форума. Если у вас их еще нет - сначала зарегистрируйтесь. Иначе, при попытке редактирования или создания страницы будет выдаваться сообщение что редактировать/создавать страницы могут только участники из группы «Участники».

После входа в вики, для создания новой страницы наберите ее название в строке поиска в правом верхнем углу и нажмите кнопку "Перейти". На странице результатов поиска первой будет ссылка, нажатие которой приведет к созданию новой страницы.

Найти созданную страницу в дальнейшем можно например через список всех страниц или группу Черновики, если вы задали при создании соответствующую категорию.

Заголовок статьи должен быть на русском и отражать содержание статьи.

Черновик

По правилам сайта созданная статья должна некоторое время оставаться черновиком. Чтобы она попала в нужный список, сразу после создания добавьте: {{Статья|Черновик}} в первой строке.

Шаблон

Специального шаблона для создания статьи пока нет.

В качестве примеров рекомендуем использовать другие статьи из списка.

Название

Название статьи должно быть на языке, на котором она написана, т.е. русским или английским.

Если необходимо использовать кавычки, то должны быть использованы т.н. «ёлочки» (Alt+0171 и Alt+0187), другие кавычки использоваться не должны.

Текст

Основные используемые стили:

==Название главы==

===Название подглавы===

Не используйте заголовки других уровней.

Для списков:

* - первый уровень элемента ненумерованного списка
** - второй уровень элемента ненумерованного списка

Код

Если в статье приводится программный код, то его можно добавлять двумя способами. Если кода мало (1-2) строки, то можно использовать теги <pre></pre> , например:

<pre>http://wfsserver?key1=value1&ke2=value2</pre>

Что будет выглядеть так:

http://wfsserver?key1=value1&ke2=value2

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

<syntaxhighlight lang="python">
table =  { 
'library' : 1000,
'other' : 2000,
'school' : 3000
}</syntaxhighlight>

Что будет выглядеть так:

table =  { 
'library' : 1000,
'other' : 2000,
'school' : 3000
}

Аннотации

Каждая статья должна иметь аннотацию, она идет сразу после служебной категории (черновик или опубликована) и отражает краткое содержание статьи, но не дублирует ее название.

Пример кода: {{Аннотация|Использование выражений на языке Python для операций с полями в QGIS}}

Иллюстрации

Статьи должны иллюстрироваться. Для загрузки изображений служит специальная страница.

Имя файла иллюстрации не должно быть слишком общим, about, settings и т.д. Иначе существует риск, что следующий загруженный файл с таким названием перепишет ваш. Задавайте более уникальные имена, включающие название статьи, например: map-classification-grass-01.jpg.

Для полноцветных изображений рекомендуется использовать формат PNG или JPEG, со степенью сжатия не менее 50, для индексированных изображений - GIF.

Размер загружаемых иллюстраций не ограничен. Иллюстрации в статье должны быть ограничены 750 пикселями по ширине. Если ваша иллюстрация меньше чем 750 пикселей по ширине - не уменьшайте ее для вставки в статью, это позволит сэкономить на лишнем щелчке и открытии иллюстрации отдельно. Если ваша иллюстрация больше чем 750 пикселей по ширине, можно уменьшить ее, указав меньшую размерность, например так: [[Файл:Рис.JPG|мини|центр|300|Рис. 1. Структура папки]]

Если вы делаете снимок экрана (скриншот), старайтесь не уменьшать его в графическом редакторе, если это все-таки необходимо, не уменьшайте ее более чем на 25% (т.е. уменьшенный результат не должен быть меньше 75% оригинала).

Для того, чтобы подчеркнуть некоторую область на изображений можно выделить ее тонкой красной линией или стрелкой.

Чтобы сделать иллюстрацию со ссылкой, сделайте так (пример):

[[Файл:Nextgis.png|link=http://nextgis.ru]]

Ссылки на дополнительные материалы и прилагаемые файлы

Ссылки на дополнительные материалы, в том числе другие разделы GIS-Lab, могут даваться как в тексте статьи, так и в блоке "См. также", располагающегося внизу страницы. Блок "См. также" должен содержать только основные ссылки.

Дополнительные файлы, ссылки на которые вы хотите дать в статье, необходимо загрузить отдельно и дать на них соответствующую ссылку. Если файлы небольшие, их можно загружать в вики в виде архивов также, как и изображения. Если файлы значительного размера, свяжитесь с координаторами GIS-Lab, чтобы вам было выделено место на сервере.

Обсуждение в форуме

Каждой статье, описанию проекта и другим материалам, имеющим свою страницу на сайте должно соответствовать обсуждение на форуме GIS-Lab в разделе "Материалы сайта".

Публикация, шаг 1: После того, как вы сочли, что статья завершена, нужно создать тему на форуме, где дать ссылку на статью в вики и пригласить участников к её обсуждению. Следует быть готовым к критике и редактированию статьи в соответствие с замечаниями.

Публикация в основном списке

Публикация, шаг 2: После первичного обсуждения на форуме, после учета критики, нужно известить редакторов сайта. Они примут решение о публикации статьи, дадут вам окончательную ссылку на нее и сделают учетную запись автора в блоге GIS-Lab.

Ваша статья попадет в основной список статей после того, как она будет ими утверждена. Посмотреть, кто принимает решение публиковать или нет статью, обратиться и задать связанные с этим вопросы можно здесь.

Публикация, шаг 3: Зайдите в блог GIS-Lab по адресу: https://gis-lab.info/blog/wp-admin/ с созданной для вас учетной записью и создайте тему объявление о том, что появилась новая статья. Дайте ссылку на статью (не на вики!) и обсуждение ее в форуме.

Публикация, шаг 4: Зайдите в вики-страницу статьи и измените в начале статьи текст {{Статья|Черновик}} на {{Статья|Опубликована|article}}, где article - название файла статьи на сайте (не вики), без ".html"