Персональные инструменты
 

Справка:Советы — различия между версиями

Материал из CustisWiki

Перейти к: навигация, поиск
м (реплицировано из внутренней CustisWiki)
 
м (Замечания и обсуждения)
Строка 5: Строка 5:
 
Поместить новую статью в [[{{SITENAME}}]] и отредактировать существующую может любой зарегистрированный участник.
 
Поместить новую статью в [[{{SITENAME}}]] и отредактировать существующую может любой зарегистрированный участник.
  
 
+
<!--BEGINDSP-->
 +
Помещая новую статью в wiki или редактируя существующую, помните, что для прочтения эта статья '''доступна всем''' сотрудникам ЗИС, регистрация нужна только для редактирования статей. Поэтому избегайте помещения конфиденциальной информации, а также оскорбительных или некорректных высказываний. Вики хранит полную историю изменения статей с указанием авторства, поэтому следы вашей работы останутся.
 +
<!--ENDDSP-->
  
 
Позаботьтесь о читателях Вашей статьи, назвав и оформив ее хорошим образом, структурировав и проверив орфографию. К сожалению, для IE нет средств проверки орфографии, надо или использовать mozilla (смотри [[#Проверка орфографии]]), или воспользоваться внешним редактором. Что касается оформления, то лучше применять однородные приемы, особенно при редактировании существующей статьи, чтобы все материалы были выдержаны в едином стиле: это облегчает восприятие.
 
Позаботьтесь о читателях Вашей статьи, назвав и оформив ее хорошим образом, структурировав и проверив орфографию. К сожалению, для IE нет средств проверки орфографии, надо или использовать mozilla (смотри [[#Проверка орфографии]]), или воспользоваться внешним редактором. Что касается оформления, то лучше применять однородные приемы, особенно при редактировании существующей статьи, чтобы все материалы были выдержаны в едином стиле: это облегчает восприятие.
Строка 15: Строка 17:
 
Можно рекомендовать для установки следующие «многозакладочные броузеры»:
 
Можно рекомендовать для установки следующие «многозакладочные броузеры»:
  
* Maxthon — это надстройка над стандартным IE.  
+
* Maxthon — это надстройка над стандартным IE. <!--BEGINDSP-->Файлы для установки file:///X:/lemnews.com/ . Обычно состоит из двух созвучных архивов — основного, и русификатора (можно не устанавливать). Распакуйте в любую выбранную директорию и используйте.<!--ENDDSP-->
  
* Mozilla Firefox. Очень удобный броузер, единственное — могут возникнуть проблемы с некоторыми сайтами, криворуко оптимизированными под Internet Explorer.
+
* Mozilla Firefox. <!--BEGINDSP-->Файлы для установки находятся в file:///X:/mozilla.org (выберите инсталляционный файл с последней версией).<!--ENDDSP--> Очень удобный броузер, единственное — могут возникнуть проблемы с некоторыми сайтами, криворуко оптимизированными под Internet Explorer.
  
 
Также можно посмотреть броузеры <tt>MyIE2</tt>, <tt>Avant</tt>.
 
Также можно посмотреть броузеры <tt>MyIE2</tt>, <tt>Avant</tt>.
Строка 64: Строка 66:
 
http://www.activasoft.com/OpenOffice2MediaWiki
 
http://www.activasoft.com/OpenOffice2MediaWiki
  
 
+
<!--BEGINDSP-->
 +
* Запустите OpenOffice Writer;
 +
* Зайдите в меню «Tool/XML Filter Settings» («Средства/Настройки фильтров XML»)
 +
* Нажмите «New» («Создать») и заполните следующие поля:
 +
;Filter name/Имя фильтра: MediaWiki
 +
;Application/Приложение: OpenOffice.org Writer (.odt)
 +
;Name of file type/Описание типа файла: MediaWiki
 +
;File extention/Расширение файла: txt
 +
* Выберите вкладку Transformation/Трансформация и заполните поле
 +
;XSLT for Export/XSLT для экспорта: X:\activasoft.com\OD2MediaWiki.xslt
 +
<!--ENDDSP-->
  
 
= Импорт текста из MS Word=
 
= Импорт текста из MS Word=
Строка 92: Строка 104:
  
 
Для Mozilla Firefox есть возможность установить проверку русской орфографии. Для этого, установите в Firefox дополнение SpellBound и дополнение русский-словарь к нему.  
 
Для Mozilla Firefox есть возможность установить проверку русской орфографии. Для этого, установите в Firefox дополнение SpellBound и дополнение русский-словарь к нему.  
 
+
<!--BEGINDSP-->
 +
* все из каталога file:///X:/mozilla.org/spellbound/
 +
* русский словарь file:///X:/mozilla.org/spell-ru.xpi
 +
* Для Firefox 1.5.0.1. http://www.wildtangents.net/2006/02/04/how-to-get-spellbound-spell-checker-working-with-firefox-1501/
 +
<!--ENDDSP-->
  
 
Для IE и основанных на нем броузеров пока проверки русской орфографии нет. Была надежда, что удасться уговорить автора [http://www.ispell.com ispell] включить поддержку нелатинских символов. Не вышло.
 
Для IE и основанных на нем броузеров пока проверки русской орфографии нет. Была надежда, что удасться уговорить автора [http://www.ispell.com ispell] включить поддержку нелатинских символов. Не вышло.
Строка 98: Строка 114:
 
= Замечания и обсуждения =
 
= Замечания и обсуждения =
  
Уважительно относитесь к труду автора и не злоупотребляйте правом редактирования любых статей. Если какое-то положение кажется Вам спорным или неверным, то лучше вставить замечание, а не исправлять сразу основной текст. Можно предложить альтернативу. Вставляя замечание, '''обязательно''' представиться, для чего удобно вставить в текст <nowiki>~~~~</nowiki>, что при записи будет преобразовано в ссылку на участника обсуждения. Если замечание относится к конкретному месту текста, то его лучше вставить непосредственно в данное место, сделав абзац с большим количеством отступов с помощью двоеточий в начале абзаца. При этом, можно также использовать [[#Пиктограммы|пиктограммы]] для выделения замечаний, реплик и обсуждения из основного текста.  
+
Уважительно относитесь к труду автора и не злоупотребляйте правом редактирования любых статей. Если какое-то положение кажется Вам спорным или неверным, то лучше вставить замечание, а не исправлять сразу основной текст. Можно предложить альтернативу. Вставляя замечание, '''обязательно''' представиться, для чего удобно вставить в текст <nowiki>~~~~</nowiki>, что при записи будет преобразовано в ссылку на участника обсуждения. Если замечание относится к конкретному месту текста, то его лучше вставить непосредственно в данное место, используя шаблон «remark» и [[#Пиктограммы|пиктограммы]] для выделения его из основного текста. Можно также использовать отступы (двоеточиями).
 +
Пример:
 +
----
 +
Открытое множество упорядочивает комплексный критерий сходимости Коши, как и предполагалось. Матожидание, общеизвестно, необходимо и достаточно. Согласно последним исследованиям, полином восстанавливает действительный разрыв функции, что и требовалось доказать. Комплексное число тривиально. Сравнивая две формулы, приходим к следующему заключению: вектор осмысленно оправдывает Наибольший Общий Делитель (НОД), что несомненно приведет нас к истине.
 +
 
 +
{{remark|{{no}}[[Участник:StasFomin|Стас Фомин]] 16:24, 21 июля 2008 (UTC): Нет, Нормальное распределение реально накладывает аксиоматичный степенной ряд, в итоге приходим к логическому противоречию.}}
 +
 
 +
:{{remark|{{ok}}[[Участник:StasFomin|Стас Фомин]] 16:24, 21 июля 2008 (UTC): С другой стороны, рациональное число, конечно, упорядочивает криволинейный интеграл, что и требовалось доказать. Математический анализ соответствует невероятный предел последовательности, при этом, вместо 13 можно взять любую другую константу.}}
 +
 
 +
 
 +
----
 +
 
  
 
Если замечание относится к статье в целом или к соотнесению разных частей статьи, то его лучше вынести на отдельную страницу обсуждения, которая есть у каждой статьи, чтобы не загромождать основной текст. Представляться правильно '''в начале''' замечания, а не в конце, так как подпись визуально выделяется цветом и служит, таким образом, отправным пунктом при просмотре статьи. Ответы на замечания от других участников правильно оформлять аналогично.  
 
Если замечание относится к статье в целом или к соотнесению разных частей статьи, то его лучше вынести на отдельную страницу обсуждения, которая есть у каждой статьи, чтобы не загромождать основной текст. Представляться правильно '''в начале''' замечания, а не в конце, так как подпись визуально выделяется цветом и служит, таким образом, отправным пунктом при просмотре статьи. Ответы на замечания от других участников правильно оформлять аналогично.  
Строка 184: Строка 211:
  
 
{{replicate-from-custiswiki-to-lib}}
 
{{replicate-from-custiswiki-to-lib}}
 +
{{replicate-from-custiswiki-to-all}}

Версия 19:30, 21 июля 2008

Публичность

Основные правила использования вики исходят из того, что это — публичная документация, доступная и предназначенная для использования многими людьми.

Поместить новую статью в CustisWiki и отредактировать существующую может любой зарегистрированный участник.

Помещая новую статью в wiki или редактируя существующую, помните, что для прочтения эта статья доступна всем сотрудникам ЗИС, регистрация нужна только для редактирования статей. Поэтому избегайте помещения конфиденциальной информации, а также оскорбительных или некорректных высказываний. Вики хранит полную историю изменения статей с указанием авторства, поэтому следы вашей работы останутся.

Позаботьтесь о читателях Вашей статьи, назвав и оформив ее хорошим образом, структурировав и проверив орфографию. К сожалению, для IE нет средств проверки орфографии, надо или использовать mozilla (смотри #Проверка орфографии), или воспользоваться внешним редактором. Что касается оформления, то лучше применять однородные приемы, особенно при редактировании существующей статьи, чтобы все материалы были выдержаны в едином стиле: это облегчает восприятие.

Броузеры

Важным моментом удобства работы с CustisWiki является выбор броузера. При редактировании статей в CustisWiki часто удобно работать с несколькими статьями, начинать отдельные новые «ветки статей», и даже чтение статей скорее удобней сравнить с обходом комбинаторного дерева (не путать с растением). Поэтому удобный броузер должен быть в первую очередь «многотабовым», т. е. должен поддерживать открытие нескольких страниц внутри окна броузера и быстрое переключение между ними с помощью закладок. Тогда редактирование становиться местами гораздо более удобным, чем даже редактирование в хорошем текстовом редакторе, т. к. закладки есть, и при этом исчезает вся возня связанная с открытием или заведением новых файлов. Просмотр становится тоже очень удобным — просматривая статью вы можете по ссылкам открыть несколько связных окон, выяснить связанную информацию (даже отредактировать ее), и закрыть ее без влияния на процесс чтения основной статьи.

Можно рекомендовать для установки следующие «многозакладочные броузеры»:

  • Maxthon — это надстройка над стандартным IE. Файлы для установки file:///X:/lemnews.com/ . Обычно состоит из двух созвучных архивов — основного, и русификатора (можно не устанавливать). Распакуйте в любую выбранную директорию и используйте.
  • Mozilla Firefox. Файлы для установки находятся в file:///X:/mozilla.org (выберите инсталляционный файл с последней версией). Очень удобный броузер, единственное — могут возникнуть проблемы с некоторыми сайтами, криворуко оптимизированными под Internet Explorer.

Также можно посмотреть броузеры MyIE2, Avant.

Адресная строка броузера для русских статей

Броузер IE позволяет вводить русские названия статей непосредственно в строке броузера (можно набрать http://lib.custis.ru/wiki/index.php/Help:Советы ), это возможно и для броузера Mozilla Firefox, если вызвать страницу настроек

about:config 

и установить

network.standard-url.encode-utf8 = true

Внешнее редактирование

В большинстве броузеров, стандартные функции редактирования «TextArea»-области очень бедны — нет полноценного «Undo», «Find/Replace», настройки шрифтов и подсветки синтаксиса.

Но для броузера Mozilla Firefox, можно установить плагин TextArea Sputnik, с помощью которого можно использовать внешний редактор, для редактирования статей в CustisWiki.

Переход к статье из адресной строки Firefox

См. Firefox: Сокращения в адресной строке

Шрифт редактирования в TextArea

Если не использовать внешний редактор, то можно хотя бы настроить любимый шрифт для окна редактирования. Наиболее читаемыми с экрана являются шрифты из семейства sans-serif (без засечек), а наиболее удобными для редактирования — из семейства monospace. К сожалению, среди «стандартного» набора шрифтов, шрифтов, принадлежащих обоим семействам, всего два — «Lucida Console» и «FixedSys», и оба имеют достаточные недостатки, чтобы навязывать их общество всем пользователям. Поэтому, вы можете попытаться настроить шрифты в окне редактирования индивидуально.

Обладателям Firefox надо найти в каталоге

C:\Documents and Settings\[имя пользователя]\Application Data\Mozilla\Firefox\Profiles

подкаталог chrome и отредактировать в нем файл

userContent.css

(Если userContent.css там нет — скопировать его из userContent-example.css). Далее можно добавить строчку типа

 textarea {
            font-family: "Lucida Console", monospace, !important;
          }

«!important» — устанавливает приоритет вашего выбора над выбором вебмастера.

Импорт документов из OpenOffice

Очень неплохо зарекомендовала себя технология http://www.activasoft.com/OpenOffice2MediaWiki

  • Запустите OpenOffice Writer;
  • Зайдите в меню «Tool/XML Filter Settings» («Средства/Настройки фильтров XML»)
  • Нажмите «New» («Создать») и заполните следующие поля:
Filter name/Имя фильтра
MediaWiki
Application/Приложение
OpenOffice.org Writer (.odt)
Name of file type/Описание типа файла
MediaWiki
File extention/Расширение файла
txt
  • Выберите вкладку Transformation/Трансформация и заполните поле
XSLT for Export/XSLT для экспорта
X:\activasoft.com\OD2MediaWiki.xslt

Импорт текста из MS Word

Варианты:

Ссылки на локальные файлы

Если в Mozilla Firefox у вас не работают ссылки на локальные файлы (с UNC путями или с файловыми, т. е. ссылки вида file://\\localmachine/fff или file://x:/distr/) то читайте статью, как это можно исправить.

В кратце — для последних (2.x) версий Mozilla Firefox есть два решения.

  1. Установка http://locallink.mozdev.org/, но тогда «клики» на локально-файловых ссылках все равно работать не будут, открывать их можно только через контекстное меню «Open/…»
  2. Найти файл настроек для своего профиля (в обычном Firefoxе это «user.js», в PortableFirefox «prefs.js», в общем .js где лежит куча настроек в виде вызовов процедуры «user_pref». Найти группу опций «capability.policy.» и заменить ее (если этой группы нет — добавить) на:
user_pref("capability.policy.policynames", "localfilelinks");
user_pref("capability.policy.localfilelinks.sites", "http://wiki.office.custis.ru");
user_pref("capability.policy.localfilelinks.checkloaduri.enabled", "allAccess");

Если сайтов с которых разрешаем ссылки к локальным файлам — несколько, то надо перечислять их через пробел, например:

user_pref("capability.policy.localfilelinks.sites", "http://wiki.office.custis.ru http://penguin.office.custis.ru");

Проверка орфографии

Для Mozilla Firefox есть возможность установить проверку русской орфографии. Для этого, установите в Firefox дополнение SpellBound и дополнение русский-словарь к нему.

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

Замечания и обсуждения

Уважительно относитесь к труду автора и не злоупотребляйте правом редактирования любых статей. Если какое-то положение кажется Вам спорным или неверным, то лучше вставить замечание, а не исправлять сразу основной текст. Можно предложить альтернативу. Вставляя замечание, обязательно представиться, для чего удобно вставить в текст ~~~~, что при записи будет преобразовано в ссылку на участника обсуждения. Если замечание относится к конкретному месту текста, то его лучше вставить непосредственно в данное место, используя шаблон «remark» и пиктограммы для выделения его из основного текста. Можно также использовать отступы (двоеточиями). Пример:


Открытое множество упорядочивает комплексный критерий сходимости Коши, как и предполагалось. Матожидание, общеизвестно, необходимо и достаточно. Согласно последним исследованиям, полином восстанавливает действительный разрыв функции, что и требовалось доказать. Комплексное число тривиально. Сравнивая две формулы, приходим к следующему заключению: вектор осмысленно оправдывает Наибольший Общий Делитель (НОД), что несомненно приведет нас к истине.

No.svgСтас Фомин 16:24, 21 июля 2008 (UTC): Нет, Нормальное распределение реально накладывает аксиоматичный степенной ряд, в итоге приходим к логическому противоречию.
Ok16.pngСтас Фомин 16:24, 21 июля 2008 (UTC): С другой стороны, рациональное число, конечно, упорядочивает криволинейный интеграл, что и требовалось доказать. Математический анализ соответствует невероятный предел последовательности, при этом, вместо 13 можно взять любую другую константу.




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

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

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

Пиктограммы

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

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

Ok16.png
«ok»
No.svg
«no»
Question.svg
«question»

могут быть использованы в обсуждениях очевидным образом, а семантика использования остальных пиктограмм соответствует SGML Docbook#Замечания, и будет рассмотрена далее.

caution

Предостережение. Как правило, связанное с действиями техники, чем с действиями людей (для чего предназначен «warning»).

Пример:

{{caution}} Наверняка есть другие источники информации,  
 а также другая  поступающая информация. Так что этот список нуждается в 
 расширении и доработке.

Caution.svg Наверняка есть другие источники информации, а также другая поступающая информация. Так что этот список нуждается в расширении и доработке.

important

Важно!

{{important}} При загрузке все нулевые значения отрезаются и не вводятся!

Important.svg При загрузке все нулевые значения отрезаются и не вводятся!

note

Замечание, пометка.

{{note}} Этот размер различен для различных операционных систем и определяется для каждой из них отдельно.

Note.svg Этот размер различен для различных операционных систем и определяется для каждой из них отдельно.

tip

Совет, подсказка.

{{tip}} Каждый вопрос имеет ответ по умолчанию, который принимается 
при нажатии кнопки «Enter»

Crystal Clear app ktip.svg Каждый вопрос имеет ответ по умолчанию, который принимается при нажатии кнопки «Enter»

warning

Предостережение, скорее относящееся к действиям пользователя (а не к свойствам оборудования или софта — это «caution»).

{{warning}}'''Нельзя''' получать новые версии файлов другим путем, 
  кроме как выполнением команд <tt>update</tt> или <tt>checkout</tt>. 
  Копирование новых версий файлов с другого компьютера 
  может привести к потере данных! 

Attention niels epting.svgНельзя получать новые версии файлов другим путем, кроме как выполнением команд update или checkout. Копирование новых версий файлов с другого компьютера может привести к потере данных!

Отдельные рекомендации

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

  • Чтобы создать статью, вставьте ссылку в то место, откуда на нее предполагается переход, а затем перейдите по этой ссылке.
  • Ответственно относитесь к названию статьи, так как множество названий в рамках вики — общее.
  • Укажите категории для статьи с тем, чтобы она попала в классификаторы по категориям.
  • Если хотите завести статью-"песочницу" для своих личных целей (поиграться, попробовать некоторые возможности, подготовить драфт статьи), то заводите ее в своем «личном» пространстве, используя свой логин, как префикс. Например, Стас Фомин ( [[User:StasFomin]] ) может завести статью User:StasFomin/Песочница1:
[[User:StasFomin/Песочница1]] 
Эти статьи не будут никому мешать и попадатся на глаза — их не будет в списках некатегоризованных статей, и всем будет понятно, что здесь ведется единоличное редактирование.
  • Не следует дублировать заголовок статьи заголовком первого уровня в ее тексте. Вики считает, что заголовок статьи уже есть, а внутри статьи должны быть только подзаголовки.
  • У списков вики есть неприятная особенность: их разрывает даже перевод строки. Это особенно печально для нумерованных списков, так как сбивается нумерация. Поэтому не используйте нумерованные списки для фиксации важных положений, подлежащих обсуждению: в них практически невозможно вставить замечания.
  • Используйте специальные символы — кавычки, тире и так далее для оформления статьи. Для замены символов в тексте можно также использовать викификатор.
  • Ответственно подходите к флагу малозначимых изменений при записи. Исходите из того, что автор и другие заинтересованные лица наблюдают за статьей и хотят получать уведомления именно о значительных изменениях.
  • Когда делаете существенное изменение, заполняете его описание, которое сохранится в истории.
  • Если вы планируете внести в статью много изменений, то ее лучше редактировать целиком, а не по отдельным разделам — чтобы запись об изменениях была одна.
  • Если по статье идет обсуждение и у нее много наблюдателей, не делайте существенные правки оформления или викификацию статьи: на сравнении версий наблюдатели получат много малозначимых изменений. Или, если решили сделать, оформите их отдельной версией и сохраните описание.

Вот, в целом, и все.


Любые правки этой статьи будут перезаписаны при следующем сеансе репликации. Если у вас есть серьезное замечание по тексту статьи, запишите его в раздел «discussion».

Репликация: База Знаний «Заказных Информ Систем» → «Справка:Советы»


Статья реплицируется в SMWiki, SBWiki, RDWiki, GZWiki, DPWiki, HRWiki, CBWiki, ORWiki, RAWiki, ITWiki, CRMWiki, NordeaWiki, EvolWiki, TMSWiki.