Как устроена «Википедия» — самая большая энциклопедия в мире

«Википедия» — энциклопедия, статьи в которую может писать любой. Никаких формальных критериев компетентности для участников не устанавливается. Но, как это ни парадоксально, качество готовых статей «Википедии» не уступает лучшим мировым энциклопедиям, таким, например, как «Британика». А по объему это самая большая энциклопедия в мире — в ней уже более трех миллионов статей на ста языках.

В 2005 году очень активно развивалась русскоязычная версия «Википедии». Об этом проекте одного рассказывает один из его администраторов, научный сотрудник института психологии Российской Академии Наук, кандидат психологических наук Станислав Козловский.

Давайте начнем с простого: что представляет собой «Википедия», если объяснить максимально просто?
«Википедия» — электронная энциклопедия, где статьи может писать любой желающий, причем любой желающий может вносить исправления в любые уже написанные статьи. Вся прелесть «Википедии» в том, что не требуется никому статьи отсылать, нет никаких специальных редакторов, корректоров. Человек видит статью, нажимает кнопку «править», вносит свои исправления, нажимает «сохранить страницу», и все изменения видны на сайте. Все происходит мгновенно – два клика мышкой и готово. Даже не надо специально регистрироваться на сайте. Сейчас в русской «Википедии» пользуются такой возможностью десять тысяч человек, в английской «Wikipedia» — около 800 тысяч человек. Со статьями русской «Википедии» в среднем работают каждый день около ста человек, и они делают ежедневно около ста правок.

Насколько качественны эти изменения? Наверняка есть шутники, хулиганы, да и просто некомпетентные, несведущие люди.
Безусловно, хулиганов в Интернете хватает. Но в «Википедии» сохранятся все версии каждой страницы. Любой человек может посмотреть историю изменений и восстановить любую версию статьи. Соответственно, ничего стереть или ухудшить невозможно, потому что все можно восстановить. Конечно, какое-то время ошибки будут выставлены на сайте, но как правило ненадолго. В английской «Википедии» проводился эксперимент. Журналисты «Нью-Йорк Таймс» внесли изменения в статьи. Среди этих изменений были явные – некоторые статьи удалили целиком, а некоторые изменения были довольно тонкие, например, в некоторых статьях изменили даты. Сделав свое «черное» дело журналисты засекли время, когда все исправится. Удаленные статьи восстановились очень быстро, некоторые статьи, в которых были сложные изменения, были восстановлены в течение часа. Но те пользователи, которые исправляли статьи, не просто «откатили» изменения назад, они просмотрели источники, дописали некоторые абзацы, изменили не очень удачные формулировки, и в результате статьи стали только лучше оттого, что привлекли внимание. Конечно, если количество изменений составляет сотни в час, если не в минуту, человеку будет трудно их отслеживать, но для этого в «Википедии» есть специальные инструменты. Каждый может следить за интересующими его статьями, которые он сам писал, либо в которых он является специалистом. Имеется ссылка «Ваш список наблюдения», и человек в любой момент может посмотреть статьи, которые его интересуют, в том числе, как они изменялись за последние несколько дней. Человек может стать куратором, интересующих его статей.

А вот здесь возникает серьезный вопрос. Дело в том, что есть, конечно, надежные, качественные научные сведения, но есть и огромное количество псевдонаучных, просто сомнительных сведений. Наверняка появились в «Википедии» представители «Новой хронологии» Фоменко, создатели торсионных генераторов, вечных двигателей. Что они пишут?
Одно из правил «Википедии» — нельзя помещать оригинальные исследования, которые нигде не публиковались, которые проповедует только один человек. Естественно, некоторые области науки или, скажем так, лженауки, та же теория Фоменко «Новая хронология», имеет приверженцев, есть публикации на эту тему и не написать статью в энциклопедию было бы неправильно. Но статья пишется с нейтральной точки зрения. Она должна отражать именно факты. На чем основана теория Фоменко, что он брал в качестве постулатов, как он доказывает свои гипотезы. Если сторонники этой (или какой-то другой) теории будут править статьи по-своему, а противники будут доказывать, что это все преднамеренная фальсификация, если это будет продолжаться и не удастся убедить участников прийти к компромиссу, статья закрывается от редактирования, и обсуждение статьи выносится на отдельную страницу. И только когда участники придут к какому-то согласию, статья вновь открывается для редактирования и изменения вносятся в нее в нормальном, штатном порядке. Добиться согласия удается почти всегда, благодаря тому, что в обсуждение вступает множество других участников энциклопедии, которые придерживаются по данному вопросу вполне нейтральной точки зрения. «Википедия» – произведение коллективное, но не вполне анонимное. У каждой статьи есть страница истории. Читатель может в любой момент посмотреть, кто эту статью писал и кто редактировал. Причем, кликнув по ссылке, с именем участника, можно попасть на его страницу в «Википедии», если он о себе что-то написал, и узнать подробности. На самом деле, активные участники «Википедии» — это достаточно квалифицированная публика, где-то процентов десять – это кандидаты наук, 15-20% — это аспиранты университетов, остальные – это, чаще всего, студенты старших курсов.

А насколько можно доверять информации, которую размещают студенты и аспиранты, если, скажем, в традиционных энциклопедиях пишут статьи ведущие специалисты в соответствующих областях?
Казалось бы, парадоксальный факт. Недавно научный журнал Nature провел исследование: они сравнили энциклопедию «Британника», в которой пишут авторитетнейшие ученые и «Википедию», оказалось, что и там, и там нашли приблизительно одинаковое количество ошибок. Причем именно грубых ошибок было в «Британике» больше, чем в «Википедии».

Проект развивается свободным образом. Все материалы энциклопедии, во-первых, делаются безвозмездно, во-вторых, почти анонимно и, тем не менее, в ней идет процесс накопления правильности. Для того чтобы весь этот порядок поддерживался, все-таки в «Википедии» есть определенная иерархия, которая управляет ее созданием. Как она устроена?
Во-первых, есть участники, они могут писать статьи, могут их изменять. Дальше имеются администраторы «Википедии», которые могут удалять статьи, блокировать их от изменений. В русскоязычной «Википедии» около 20 человек администраторов, где-то на пятьсот участников один администратор. В английской версии 800 администраторов, один администратор на тысячу человек. Администратор избирается всеми участниками из тех, кто уже достаточно долго работает в проекте, по крайней мере несколько месяцев, кто сделал более тысячи правок, и правки были действительно полезные, и за него проголосовали участники. Администраторов назначает бюрократ — это такая должность в «Википедии». Бюрократ может делать то же, что администратор, плюс у него есть право превращать обычного пользователя в администратора, а вот забрать администраторские права он не может. Бюрократов в российской «Википедии» три человека. Один живет в Томске, другой — в Петербурге, и третий в Калининграде. Выше в российской «Википедии» никого нет. Но вообще выше Бюрократа находятся так называемые стюарды, которые могут забирать права у администраторов. Стюард может забрать права администратора.

В последние месяцы в Китае заблокировали доступ к «Википедии», в Германии отобрали домен «Википедии», в СШA высказывались претензии к содержанию статей. Это не создает угрозы для всего проекта? Проект содержит массу информации, а значит, затрагивает интересы самых разных людей и организаций.
В Китае сейчас запретили доступ уже в третий раз, так что они то закрывают, то открывают. В основном, в Китае не любят статьи о Тайване. Если в статьях Википедии появляются клеветнические сообщения, их удаляют тут же. В Америке разгорелся скандал, когда один из журналистов обнаружил, что в его биографии написано будто бы он принимал участие в убийстве Джона Кеннеди, и корреспондент устроил скандал на CNN. Хотя в принципе, он мог бы нажать кнопку «править» и тут же удалить ложные сведения. Но есть и другая проблема, она возникла, в частности, в Германии – это проблема privacy, проблема частной жизни. Есть некоторые факты, которые люди хотели бы о себе сообщать. Но это действительно факты. Допустим, человек в каком-то интервью что-то о себе сказал, и оно попало в «Википедию» – это факт. Но человек этого не хочет. Конечно, он может подать в суд. Но есть фонд Wikimedia, который занимается судебными разбирательствами. В принципе, какая-то одна статья вряд ли может поставит под угрозу весь проект.

Сейчас «Википедия» российская содержит 55 тысяч статей. Этот объем пополняется постоянно, как я понял, до нескольких десятков или сотен статей в день. А зачем люди тратят многие часы своего времени на то, чтобы такую бесплатную статью?
На самом деле, писать в «Википедию» очень интересно. Во-первых, происходит структуризация знаний. Человек знает о чем-то, хочет писать и понимает, что у него есть какие-то пробелы. Он обращается к источникам, пишет статью и у него кристаллизуются его собственные знания, он лучше начинает понимать предмет. Кроме того некоторые хотят оставить о себе след. Ну и потом, люди болеют за какие-то области знаний и хотели бы, чтобы они были отражены каким-то образом. Есть еще много людей, которые писали энциклопедии и размещали на сайте «Народ.ру», например, а потом увидели, что можно перенести свои знания в общий проект и ими будут интересоваться очень много людей.

Что нужно для того, чтобы начать? Нужно ли для этого обладать какими-то техническими знаниями, способы работы с вэб-сайтами, обработки картинок?
На самом деле тут ничего этого знать не требуется. Достаточно уметь работать в «Word», набирать текст. Чтобы сделать гиперссылку на другую статью в «Википедии», достаточно вокруг слова просто поставить двойные квадратные скобки, и автоматически будет сгенерирована ссылка на статью. Причем что интересно: если такая статья существует, то ссылка будет синего цвета, если такой статьи нет, ссылка будет красного цвета. И любой, щелкнув по этой ссылке, может написать эту статью. Каждый желающий может прямо сейчас принять участие в «Википедии». Нужно только кликнуть по ссылке http://ru.wikipedia.org/, а дальше вы попадете на сайт, и можете начать работу: например, найти статью, которая вас интересует, внести изменения, либо написать статью, которой еще нет. Единственное ограничение, о котором следует помнить: нельзя писать только о себе любимом, статьи должны быть именно энциклопедические.

А если я хочу продвинуть продукцию своей компании?
Такую статью, скорее всего, удалят. В принципе, это можно обсудить, и если большинство участников выскажется за удаление, и их аргументы будут адекватными, статью удалят. Но в «Википедии» нет демократии, решает не большинство голосов. Если сильные аргументы привел даже один человек, решение может быть принято. Главное – это аргументированность точки зрения. А окончательно решение об удалении выносит администратор.

Тысячная избранная статья. Как устроено рецензирование в Википедии / Хабр

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

А давайте ее удалим?

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

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

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

Консенсус и война правок

При обсуждениях и правках активно используется понятие консенсуса. Любопытная картинка, показывающая то, как в Википедии приходят к согласию. На оси х — редакции статьи, а y визуализирует цветом, кому принадлежит тот или иной кусок статьи. Видите пилообразную структуру? Это в статье один участник добавил какое-то предложение, а другой эту правку отменил. А первый отменил отмену правки. Ну и так далее. Кстати, тема статьи на картинке — «Шоколад». Всем желающим предлагаю представить, что творится на статье про аборты, феминизм или Трампа.

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

Участник А: Вот в этом месте статьи ты должен переделать так-то и так-то.
Участник B: Мне кажется, что достаточно переделать так-то и так-то (обосновывает, почему).
Участник А: (обиженно молчит)

Ну раз молчит, значит теперь все в порядке. А если продолжает настаивать, приводя все новые аргументы — может прийти кто-то третий и все же принудить сделать так, как просят, или найти другой компромисс. В наиболее сложных случаях дело передается в формируемый из наиболее опытных участников Арбитражный комитет, который выслушивает мнения сторон, выносит решение и имеет право карать тех, кто после вынесения решения не подчиняется. Если тема, вызывающая постоянные споры, продолжает всплывать, может появиться статья, уточняющая правила. Например, есть закон ВП: УКР, описывающий, что можно, а что нельзя говорить в статьях про Украину и Крым.

Рецензирование

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

Отзывов и предложений становится больше, автор может объявить рецензирование завершенным, когда увидит, что дискуссия затихла. Собственно, выставление на рецензирование и общение в тематических Порталах — основной способ привлечения внимания к своей статье. Чем больше ошибок выявляется на этом этапе, чем больше будет придирок — тем легче будет на номинации.

Следующий шаг — выставление статьи в список Хороших. Сейчас их во всей Википедии 2750 штук. Хорошая статья будет висеть на Главной странице от одного до двух дней, что отлично сказывается на трафике. На графике посещаемости видны два всплеска: наибольший — в недели, когда фильм вышел в прокат и второй, поменьше — в дни нахождения на Главной.

Чтобы статья была признана Хорошей, помимо прочих требований, она должна быть полной. Как это понять? Во-первых, глянуть в список других Хороших и Избранных статей по схожей тематике и изучить структуру их разделов. К примеру, в статье о фильме должен быть раздел, в котором описываются детали создания картины, восприятие фильма критикой, кассовые сборы и т.д. В случае с панфиловцами у меня было огромное количество новостей в качестве исходного материала — тут отлично помогают вертикальные поисковики по новостям от Google и особенно Яндекса. Федеральные новости следует предпочитать региональным, еще лучше, если источник будет академическим.

Авторитетные источники

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

Авторитетность источника определяется двумя вещами: кто автор и кто публикует (отвечает за материал и рецензирует). Скажем, пишем раздел о том, как фильм был воспринят кинокритиками. Кто для этого раздела будет авторитетным источником? Можно ли вставить туда мнение Гоблина-Пучкова или Bad Comedian’a? Начинаем читать правила, попутно общаясь с другими авторами статей о кино. Приходим к выводу, что более авторитетными критиками считаются участники гильдий и союзов кинематографистов, колумнисты по теме кино и штатные кинообозреватели давно существующих изданий, ну и, разумеется люди, имеющие публикации в академических журналах по киноведению: Искусство кино, Киноведческие записки, Сеанс.
Еще интереснее, когда речь заходит об авторитетных источниках в области истории. Так например, если заслуженный киновед начнет рассуждать об исторической основе фильма, его слова можно спокойно пропускать мимо ушей — он вышел за пределы своей области экспертизы.

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

• Является источник первичным или вторичным? Мемуары вашего дедушки (или товарища Жукова) или справка-доклад генпрокуратуры СССР — это первичные источники. Это сырой материал, в котором должны разбираться историки: сверять с другими документами, выявлять противоречия и пр. После того, как историк это сделает, он публикует статью в академическом журнале — и это-то и является нашей основной опорой. Использовать первичку в википедии крайне не рекомендуется, так как это часто приравнивается к запрещенным оригинальным исследованиям.
  Для вторичных источников мы можем посмотреть на следующие факторы.
• Имеет ли автор публикации в ВАКовских журналах по истории?
• Имеет ли автор профильное историческое образование?
• Где было высказано мнение?
  
  • В своем блоге или нерецензируемой книге? Значит, никто его не проверял, и уровень доверия должен быть минимальным.
  • В СМИ или в интервью кому-либо? Уже лучше, особенно если уровень издания федеральный. Есть вероятность, что откровенную глупость не пропустят в редакции, но немалый риск, что издание будет искусственно нагнетать градус сенсационности — достаточно вспомнить канал RenTV. Со СМИ стоит обращаться крайне осторожно, ведь их цель — не поиск истины, а скорее донесение позиции редакции.
  • На сайте академической организации, такой как Российская Академия Наук? Неплохо, ведь если сказать необоснованную отсебятину там, репутационные риски понесет вся академия.
  • В рецензируемой статье или рецензируемой монографии? Идеально, можно ссылаться без опаски, но предварительно проверить, где эта статья цитируется — возможно, в других статьях будет опровержение, уточнение или критика вашего источника. ELibrary и Google Scholar — лучшие помощники в поиске информации, если вы пишете по-русски, для английского раздела поисковиков гораздо больше.
• Доступен ли источник для проверки? Бумажная книга — это не так хорошо, как доступная в электронном виде публикация. Если источник большой (например, трехсотстраничный кирпич), то совершенно необходимо сослаться на конкретную страницу и привести оттуда цитату.
  На этапе выдвижения статьи на статус Хорошей каждая фраза, содержащая какой-либо значимый факт, должна быть подкреплена ссылкой на хороший авторитетный источник. Сам список источников к этому моменту, скорее всего, разрастется до невообразимых масштабов.

Какая награда ожидает написавшего избранную статью? Три дня на Главной странице, малиновые штаны, уважение сообщества и огромный приток читателей, соавторов и парней, проставляющих буквы ё. А также некоторый иммунитет к беспорядочным правкам — в избранных статьях вандализм и не подтвержденные ссылками утверждения быстро откатывают другие участники.

Мне кажется, что не всякая статья может стать избранной. Некоторые темы настолько взрывоопасны, что в соответствующих статьях будут вестись вечные войны правок. Например, очень сложно представить себе консенсусную статью об Иосифе Сталине, правильном питании или о присоединении Крыма. Другие темы настолько обширны, что статья всегда будет казаться недоделанной: например, статья о США, Германии или, скажем статья Homo Sapiens. Если же вам повезло с темой, то избрание не будет сопряжено с чрезмерной болью. Просто приготовьтесь к тому, что у вас появится больше рецензентов, и многие из них будут более компетентными, чем вы. Появятся историки, которых вы не могли найти, когда они были нужны, появятся киноведы, которые будут удивляться тому, как бестолково вы цитировали критиков. В этот период можно научиться очень многому, если помнить, что ваша цель — улучшить статью, а не доказать кому-то свою правоту.

Формальные требования на этом этапе такие же, как и в случае с хорошими статьями, но вот за их исполнением коллеги-википедисты следят гораздо пристальнее. Букву ё еще простят (после избрания на статью налетают полчища редакторов, расставляющих точки над e), а вот за малейший намек на ангажированность или некачественные источники будут долго возить лицом по столу.

Изображения и видео

Отдельно хочется сказать о картинках, фотографиях и авторских правах. В фонде Викимедиа работает двести человек. При этом Википедия занимает пятое место в мире по посещаемости. Фонд не может позволить себе нанять тысячи юристов, поэтому политика по авторским правам крайне жесткая — и надо быть к этому готовым. Для любого изображения должен быть указан источник (желательно — сайт фотографа), автор и лицензия. Лучше всего — если автор фото напишет лицензию на своем сайте или пришлет письмо в Фонд, в котором скажет, что его изображение можно использовать под Creative Commons. На практике это означает, что либо фотографии в твоей статье будут плохими/отсутствовать, либо ты научишься связываться с фотографами и убеждать их тебе помогать.

Я пришел к выводу, что для изображений действует этакая презумпция виновности — если ты загрузил картинку и в источнике что-то не кристально понятно, изображение удаляется, и надо проходить процедуру восстановления. Лучшая стратегия в этом случае — принять правила, и сразу после загрузки обращаться к имеющим права на удаления: дескать, дружище, погляди на мои файлы и проверь, все ли хорошо в них с лицензиями. На Викискладе (хранилище изображений и видео, из которого их можно использовать во всех википедиях) я даже не представляю, как по-другому можно выжить.

Ах да! Видео! В Википедии нельзя просто взять и выложить видео в каком-нибудь человеческом формате. Только самые свободные и open source’ные кодеки! В общем, готовьтесь к тому, что придется собирать свой ffmpeg. Волшебная команда выглядит так:

./ffmpeg -i ~/Pictures/panf/panfilov\ mechanical\ hand.mp4 -f ogg -c:v libtheora -q:v 9 -c:a libvorbis -q:a 6 mechanical_hand.ogv

Итог

Пока я писал статью, я успел лично познакомиться со съемочной группой фильма, посетил творческую лабораторию компании, делавшей спецэффекты, сходил на места натурных съемок и посоветовался с историческими консультантами, приобрел кучу новых товарищей-википедистов и много чему научился. Что интересно, так это то, что когда ты говоришь, что пишешь статью в вики, тебя начинают воспринимать примерно как журналиста New York Times — все ведь знают о том, насколько популярен этот ресурс. И действительно, отредактировав статью, ты можешь принести очень много пользы, ведь вики давно стала справочным ресурсом по умолчанию для многих людей. Википедия будет существовать столько же времени, сколько человеческая цивилизация, и я очень рекомендую всем попробовать внести свой вклад в нее.

UPD: Итоги избранности статьи. Посещаемость выросла весьма существенно (на 1000% по сравнению с daily average) и составила 60% от максимально зарегистрированной (в неделю, когда фильм вышел в прокат). Публикация на Geektimes дала около 2000 дополнительных людей, что при ~8 тысячах просмотрах означало неплохую конверсию в 25%.

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

Изменение и форматирование вкладки Wiki в Teams

Команды Майкрософт

Приложения и сервисы

Приложения и сервисы

Изменение и форматирование вкладки Wiki в Teams

Microsoft Teams Больше… Меньше

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

Чтобы внести изменения на страницу или раздел вкладки Wiki , просто щелкните ее и начните печатать. У вас есть все обычные параметры форматирования, такие как полужирный, курсив и подчеркнутый текст, выделение, заголовки и списки.

Ваша вкладка Wiki автоматически сохраняет ваши изменения, как только вы закончите редактирование, поэтому, как только вы щелкнете по разделу, ваша работа останется в целости и сохранности.

В этой статье

• Добавить страницу или раздел

• Удалить страницу или раздел

• Изменить порядок страниц и разделов

• Совместная работа с другими на странице

Добавить страницу или раздел

Чтобы добавить новую страницу на вкладку Wiki , просто откройте оглавление и нажмите Создать новую страницу . Вы можете перетащить новую страницу куда угодно.

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

Удалить страницу или раздел

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

Чтобы удалить раздел, наведите указатель мыши на название раздела и нажмите Дополнительные параметры > Удалить .

Изменить порядок страниц и разделов

Чтобы переместить страницу или раздел на вкладке Wiki , перейдите к оглавлению. Рядом с заголовком страницы или раздела нажмите Дополнительные параметры > Вверх или Вниз .

Совместная работа с другими на странице

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

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

Вики | GitLab

• Просмотр вики проекта
• Настройка ветки по умолчанию для вашей вики
• Создание домашней страницы вики
• Создать новую вики-страницу
  • Создавать или редактировать вики-страницы локально
  • Специальные символы в заголовках страниц
  • Ограничения длины имен файлов и каталогов
• Редактировать вики-страницу
  • Создать оглавление
• Удалить вики-страницу
• Переместить вики-страницу
• Просмотр истории страницы вики
  • Просмотр изменений между версиями страницы
• Отслеживание событий вики
• Включение или отключение вики проекта
• Ссылка на внешнюю вики
• Отключить вики проекта
• Редактор контента
  • Использовать редактор контента
  • Вернуться к старому редактору
  • Поддержка GitLab Flavored Markdown
• Устранение неполадок
  • Рендеринг слагов страницы с помощью обратного прокси-сервера Apache
  • Воссоздание вики-проекта с помощью консоли Rails

История версий

• Загрузка страницы изменена на асинхронную в GitLab 14. 9.
• Метод кодирования слагов страницы изменен на ERB::Util.url_encode в GitLab 14.9.

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

Вики GitLab поддерживают Markdown, Rdoc, AsciiDoc и Org для контента. Вики-страницы, написанные в Markdown, поддерживают все функции Markdown, а также обеспечить некоторое поведение, специфичное для вики для ссылок.

В GitLab 13.5 и более поздних версиях Вики-страницы отображают боковую панель, которую вы можете настроить. Этот боковая панель содержит неполный список страниц вики, отображаемый в виде вложенного дерева, с родственными страницами, перечисленными в алфавитном порядке. Чтобы просмотреть список всех страниц, выберите Просмотреть все страницы на боковой панели:

Просмотреть вики проекта

Чтобы получить доступ к вики проекта:

1. В верхней панели выберите Главное меню > Проекты и найдите свой проект.
2. Чтобы отобразить вики, выполните одно из следующих действий:
   • На левой боковой панели выберите Wiki .
   • На любой странице проекта используйте г + ш сочетание клавиш вики.

Если Wiki не указан на левой боковой панели вашего проекта, администратор проекта отключил его.

Настройте ветку по умолчанию для вашей вики

Представлено в GitLab 14.1.

Ветка по умолчанию для вашего вики-репозитория зависит от вашей версии GitLab:

• GitLab версии 14.1 и выше: вики наследуют имя ветки по умолчанию, настроенное для ваш экземпляр или группу. Если пользовательское значение не настроено, GitLab использует main .
• GitLab версии 14.0 и более ранние: GitLab использует мастер .

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

Создать домашнюю страницу вики

При создании вики она пуста. При первом посещении вы можете создать пользователи домашней страницы видят при просмотре вики. Эта страница требует определенного заголовка для использования в качестве домашней страницы вашей вики. Чтобы его создать:

1. На верхней панели выберите Главное меню .
   • Для вики проекта выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Wiki .
3. Выберите Создайте свою первую страницу .
4. GitLab требует, чтобы эта первая страница называлась home . Страница с этим title служит главной страницей вашей вики.
5. Выберите формат для оформления текста.
6. Добавьте приветственное сообщение для своей домашней страницы в разделе Content . Ты можешь всегда редактируйте его позже.
7. Добавить сообщение фиксации . Git требует сообщения фиксации, поэтому GitLab создает его если вы не введете его самостоятельно.
8. Выберите Создать страницу .

Создать новую вики-страницу

Пользователи хотя бы с ролью разработчика могут создавать новые вики-страницы:

1. На верхней панели выберите Главное меню .
   • Для вики проекта выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Wiki .
3. Выберите Новая страница на этой странице или на любой другой вики-странице.
4. Выберите формат содержимого.
5. Добавьте заголовок для своей новой страницы. Использование заголовков страниц специальные символы для подкаталогов и форматирования, и имеют ограничения по длине.
6. Добавьте контент на свою вики-страницу.
7. Дополнительно. Прикрепите файл, и GitLab сохранит его в Git-репозитории вики.
8. Добавить сообщение фиксации . Git требует сообщения фиксации, поэтому GitLab создает его если вы не введете его самостоятельно.
9. Выберите Создать страницу .

Локальное создание или редактирование вики-страниц

Wiki основаны на репозиториях Git, поэтому вы можете клонировать их локально и редактировать их, как вы бы сделали с любым другим репозиторием Git. Чтобы клонировать вики-репозиторий локально выберите Клонировать репозиторий с правой боковой панели любой вики-страницы, и следуйте инструкциям на экране.

Файлы, которые вы добавляете в свою вики локально, должны использовать один из следующих поддерживаемые расширения, в зависимости от языка разметки, который вы хотите использовать. Файлы с неподдерживаемыми расширениями не отображаются при отправке в GitLab:

• Расширения Markdown: . mdown , .mkd , .mkdn , .md , .6markdown .6
• Расширения AsciiDoc: .adoc , .ad , .asciidoc .
• Другие расширения разметки: .textile , .rdoc , .org , .creole , .wiki , .mediawiki , .mediawiki , , , .

Специальные символы в заголовках страниц

Вики-страницы хранятся в виде файлов в репозитории Git, поэтому некоторые символы имеют особое значение:

• При сохранении страницы пробелы преобразуются в дефисы.
• Дефисы ( - ) преобразуются обратно в пробелы при отображении страницы.
• Косая черта ( / ) используется в качестве разделителя пути и не может отображаться в заголовках. Если вы создайте заголовок, содержащий / символов, GitLab создаст все подкаталоги необходимо построить этот путь. Например, заголовок docs/my-page создает вики страница с путем /wikis/docs/my-page .

Ограничения длины для имен файлов и каталогов

Представлено в GitLab 12.8.

Многие распространенные файловые системы имеют ограничение в 255 байт. для имен файлов и каталогов. Git и GitLab поддерживают пути, превышающие те пределы. Однако, если ваша файловая система налагает эти ограничения, вы не можете извлечь локальная копия вики, имена файлов которой превышают это ограничение. Чтобы предотвратить это проблема, веб-интерфейс и API GitLab применяют следующие ограничения:

• 245 байтов для заголовков страниц (10 байтов резервируются для расширения файла).
• 255 байт для имен каталогов.

Символы, отличные от ASCII, занимают более одного байта.

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

Редактировать вики-страницу

Для редактирования вики-страницы вам необходима роль не ниже разработчика:

1. На верхней панели выберите Главное меню .
   • Для вики проекта выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Wiki .
3. Перейдите на страницу, которую хотите отредактировать, и одним из следующих способов:
   • Используйте сочетание клавиш e вики.
   • Выберите значок редактирования ().
4. Редактировать содержимое.
5. Выберите Сохранить изменения .

Несохраненные изменения вики-страницы сохраняются в локальном хранилище браузера для предотвращения случайной потери данных.

Создать оглавление

Чтобы создать оглавление из подзаголовков вики-страницы, используйте тег [[_TOC_]] . Для примера прочтите Оглавление.

Удалить вики-страницу

Для удаления вики-страницы вам нужна как минимум роль разработчика:

1. На верхней панели выберите Главное меню .
   • Для вики проекта выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Wiki .
3. Перейдите на страницу, которую хотите удалить.
4. Выберите значок редактирования ().
5. Выбрать Удалить страницу .
6. Подтвердить удаление.

Переместить вики-страницу

Для перемещения вики-страницы вам нужна как минимум роль разработчика:

1. На верхней панели выберите Главное меню .
   • Для вики проектов выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Wiki .
3. Перейдите на страницу, которую хотите переместить.
4. Выберите значок редактирования ().
5. Добавьте новый путь в поле Заголовок . Например, если у вас есть вики-страница звонил по поводу под компания и вы хотите переместить его в корень вики, изменить название с около до / около .
6. Выберите Сохранить изменения .

Просмотр истории вики-страницы

Изменения вики-страницы с течением времени записываются в вики-репозиторий Git. На странице истории отображается:

• Ревизия (Git commit SHA) страницы.
• Автор страницы.
• Сообщение фиксации.
• Последнее обновление.
• Предыдущие версии, выбрав номер версии в Столбец Версия страницы .

Чтобы просмотреть изменения для вики-страницы:

1. На верхней панели выберите Главное меню .
   • Для вики проекта выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Wiki .
3. Перейдите на страницу, для которой вы хотите просмотреть историю.
4. Выберите История страниц .

Просмотр изменений между версиями страниц

Представлено в GitLab 13.2.

Вы можете увидеть изменения, сделанные в версии вики-страницы, аналогично просмотрам версий файлов различий:

1. На верхней панели выберите Главное меню .
   • Для вики проекта выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Wiki .
3. Перейдите на интересующую вас вики-страницу.
4. Выберите История страниц , чтобы просмотреть все версии страниц.

5. Выберите сообщение фиксации в столбце Изменения для интересующей вас версии.

Отслеживание событий вики

История версий

• Представлено в GitLab 12.10.
• События Git появились в GitLab 13.0.
• Флаг функции для событий Git был удален в GitLab 13.5.

GitLab отслеживает события создания, удаления и обновления вики. Эти события отображаются на этих страницах:

• Профиль пользователя.
• Страницы активности, в зависимости от типа вики:
  • Активность группы.
  • Проектная деятельность.

Коммиты в вики не учитываются в аналитике репозитория.

Боковую панель, представленную в GitLab 13.8, можно настроить, нажав кнопку Изменить боковую панель .

Для настройки вики требуется как минимум роль разработчика боковая панель навигации. Этот процесс создает вики-страницу с именем 9. 0160 _sidebar который полностью заменяет боковую панель навигации по умолчанию:

1. На верхней панели выберите Главное меню .
   • Для вики проекта выберите Projects и найдите свой проект.
   • Для групповых вики выберите Группы и найдите свою группу.
2. На левой боковой панели выберите Wiki .
3. В правом верхнем углу страницы выберите Изменить боковую панель .
4. По завершении выберите Сохранить изменения .

A _sidebar пример, отформатированный с помощью Markdown:

 ### [Home](home)
- [Привет, мир] (привет)
- [Фу] (фу)
- [Бар](бар)
---
- [Боковая панель](_sidebar)
 

Включить или отключить вики проекта

Вики по умолчанию включены в GitLab. Администраторы проекта можно включить или отключить вики проекта, следуя инструкциям в Общий доступ и разрешения.

Администраторы самоуправляемых установок GitLab могут настроить дополнительные параметры вики.

Вы можете отключить групповые вики в настройках группы

Чтобы добавить ссылку на внешнюю вики из левой боковой панели проекта:

1. На верхней панели выберите Главное меню > Проекты и найдите свой проект.
2. На левой боковой панели выберите Настройки > Интеграция .
3. Выберите Внешняя вики .
4. Добавьте URL-адрес вашей внешней вики.
5. Дополнительно. Чтобы проверить подключение, выберите Test settings 9.0170 .
6. Выберите Сохранить изменения .

Теперь вы можете увидеть опцию Внешняя вики в вашем проекте. левая боковая панель.

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

Чтобы скрыть ссылку на внешнюю вики:

1. В верхней панели выберите Главное меню > Проекты и найдите свой проект.
2. На левой боковой панели выберите Настройки > Интеграция .
3. Выберите Внешняя вики .
4. В разделе Включить интеграцию снимите флажок Активный .
5. Выберите Сохранить изменения .

Отключить вики проекта

Чтобы отключить внутреннюю вики проекта:

1. На верхней панели выберите Главное меню > Проекты и найдите свой проект.
2. Перейдите в свой проект и выберите Настройки > Общие .
3. Развернуть Видимость, функции проекта, разрешения .
4. Прокрутите вниз, чтобы найти Wiki и отключите его (выделено серым цветом).
5. Выберите Сохранить изменения .

Внутренняя вики теперь отключена, а пользователи и участники проекта:

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

Ранее добавленные вики-страницы сохраняются на случай, если вы хотите снова включить вики. Чтобы снова включить его, повторите процесс чтобы отключить вики, но включить ее (синим цветом).

Редактор контента

История версий

• Представлено в GitLab 14.0.
• В GitLab 14.7 добавлено переключение между функциями редактирования с помощью флага wiki_switch_between_content_editor_raw_markdown . Включено по умолчанию.
• Переключение между функциями редактирования, обычно доступными в GitLab 14.10. Флаг функции wiki_switch_between_content_editor_raw_markdown удален.

GitLab предоставляет возможность редактирования WYSIWYG для GitLab Flavored Markdown в вики.

Поддержка включает:

• Форматирование текста, в том числе использование жирного шрифта, курсива, кавычек, заголовков и встроенного кода.
• Форматирование нумерованных списков, ненумерованных списков и контрольных списков.
• Создание и редактирование структуры таблицы.
• Вставка и форматирование блоков кода с подсветкой синтаксиса.
• Предварительный просмотр диаграмм Mermaid, PlantUML и Kroki (представлено в GitLab 15.2).
• Создание и редактирование комментариев HTML (появилось в GitLab 15.7).

Использовать редактор содержимого

1. Создайте новую вики-страницу или отредактируйте существующую.
2. Выберите Markdown в качестве формата.
3. Над Содержимое выберите Редактировать форматированный текст .
4. Настройте содержимое своей страницы, используя различные параметры форматирования, доступные в редакторе содержимого.
5. Выберите Создать страницу для новой страницы или Сохранить изменения для существующей страницы.

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

Вернуться к старому редактору

1. Если вы редактируете страницу в редакторе контента, прокрутите до Контент .
2. Выбрать Редактировать источник .

Поддержка GitLab Flavored Markdown

Поддержка всех типов контента GitLab Flavored Markdown в редакторе контента находится в стадии разработки. Статус текущей разработки поддержки CommonMark и GitLab Flavored Markdown см.:

• Основные расширения форматирования Markdown epic.
• Эпические расширения GitLab Flavored Markdown.

• Настройки вики для администраторов
• Project wikis API
• API хранения групповых репозиториев
• Group wiki API
• Горячие клавиши Wiki

Устранение неполадок

Отрисовка слагов страницы с помощью обратного прокси-сервера Apache

В GitLab 14.9 и более поздних версиях слаги страниц теперь кодируются с помощью ERB::Util. url_encode 9Метод 0161. Если вы используете обратный прокси-сервер Apache, вы можете добавить аргумент nocanon к ProxyPass . строку вашей конфигурации Apache, чтобы убедиться, что слаги вашей страницы отображаются правильно.

Воссоздание вики-проекта с помощью консоли Rails

предупреждение

Эта операция удаляет все данные в вики.

предостережение

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

Чтобы удалить все данные из вики-проекта и создать его заново в пустом состоянии:

1. Запустите сеанс консоли Rails.

2. Запустите следующие команды:

    # Введите путь к вашему проекту
   p = Project.find_by_full_path('<имя-пользователя-или-группы>/<имя-проекта>')
   # Эта команда удаляет вики-проект из файловой системы. 
   GitlabShellWorker.perform_in(0, :remove_repository, p.repository_storage, p.wiki.disk_path)
   # Обновить состояние вики-репозитория.
   p.wiki.repository.expire_exists_cache
    

Все данные с вики удалены, и вики готова к использованию.

Помощь и обратная связь

Документы

Редактировать эту страницу чтобы исправить ошибку или добавить улучшение в мерж-реквест.
Создать задачу чтобы предложить улучшение этой страницы.
Показать и опубликовать комментарии чтобы просмотреть и оставить отзыв об этой странице.

Продукт

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

Доступность функций и пробные версии продуктов

Посмотреть цены для просмотра всех уровней и функций GitLab или для обновления.
Попробуйте GitLab бесплатно с доступом ко всем функциям на 30 дней.