Partkeepr: Вики Сообщества

На данный момент единственное, что мне удалось заставить "работать", - это использовать кэшированные страницы googles. Вы просто ищете соответствующую вики-страницу, Google показывает результат, а затем, вместо того, чтобы щелкать ссылку, щелкните маленькую стрелку вниз рядом с ней, а затем щелкните кэшировано. Он будет без стиля, но контент есть. Или перейдите с помощью archive.org: http://web.archive.org/web/20180310044536/http : //wiki.partkeepr. org: 80 / wiki / Main_Page

Я очень надеюсь, что в какой-то момент вики вернется, даже если только в виде чистого HTML в папке на github (или на вкладке вики здесь).

Похоже, вики снова в сети.

Отличные новости! Закрытие.

В любом случае, кто-нибудь знает, где находится вики? Ответственность за это до сих пор лежит на @Drachenkaetzchen? В другом выпуске описывается проблема, с которой Парткипр немного застрял на данный момент. Это может быть хорошим способом помочь @Drachenkaetzchen и взять на себя ответственность за это на других плечах. Затем необходима резервная копия Wiki / SQL.

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

Я использую @christianlupus , я бы сказал, что разместите его в разделе wiki githubs, что должно немного снизить нагрузку на серверы и плечи

Ввиду желательности долгосрочного решения и предложений @ C44Supra и @christianlupus попытаться поддержать Felicia @Drachenkaetzchen путем архивирования этих данных и их независимого размещения через github, я снова открываю это. Информация в вики очень полезна для устранения неполадок при установке - особенно в нишевых ситуациях, не описанных в основном руководстве по установке. Эта информация должна быть доступна вместе с кодовой базой для максимального удобства использования. Мне очень приятно видеть, что вики-сайт был восстановлен, но, возможно, его можно было бы без особых усилий объединить с разделом вики-страницы github, который также содержит некоторую полезную, но дополнительную и различную информацию.

Если кто-то может предоставить способ автоматического перемещения размещенной вики на GitHub, пожалуйста, дайте мне знать, но только если вы действительно протестировали такой механизм. Простой гугл дает много результатов для такого механизма, и у меня нет времени и сил разбираться в них.

Если вам нужен какой-то доступ к API для текущей вики или дампа БД, дайте мне знать.

Я был бы готов попытаться это подготовить. Попробую перейти на вики в личном кабинете. Насколько я видел, я могу перенести только последнюю версию вики, и требуются некоторые ручные настройки.

Я попытался перенести вики-файлы на github. Результат виден в этом репо . Все еще необходимы незначительные изменения (например, удаление опечаток, переименование страниц, организация файлов и т. Д.).

К сожалению, автоматический экспорт в XML (стандартный способ экспорта из mediawiki) имеет некоторые недостатки. Таким образом, история страниц теряется, и никакие медиафайлы не экспортируются. Я загрузил их вручную, но метаданные (например, заголовок и альтернативный текст) не были перенесены. Кроме того, wiki github немного более ограничена, чем Mediawiki, что, например, приводит к невозможности создания списков подстраниц, насколько я узнал.

@Drachenkaetzchen Я прошу вас убедиться, что вики можно использовать таким образом. Затем вы можете просто установить страницы из моего репозитория на страницу Partkeepr, если вам это подходит. Свяжитесь со мной в случае возникновения вопросов, я буду очень рад и рад помочь.
PS: Я добавил вас в качестве соавтора в репо, чтобы вы могли поиграть с ним.

Все остальные могут просмотреть вики-поиск ошибок, которые я пропустил.

@Drachenkaetzchen Я прошу вас убедиться, что вики можно использовать таким образом.

Я запуталась, что именно мне нужно проверить?

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

Думаю, стоит спросить у пользователей;) Я редко пользуюсь вики.

Предлагаю запросить обратную связь по списку рассылки

Я оставил сообщение в списке рассылки . Перекрестная ссылка здесь только для завершения.

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

@Drachenkaetzchen Я не получил особого внимания и отклика от других пользователей по поводу миграции вики. У вас есть расписание или как мы будем действовать здесь? Я бы подготовил миграцию, чтобы ссылки работали, а имена файлов были полезными. Так как это ручная работа, я бы предпочел не делать этого, если позже не будет использоваться.

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

Хорошо, тогда я прошу @dromer высказать свое мнение.

Привет всем, я не видел обсуждения переноса вики на github.

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

Мой опыт работы с вики и страницами github практически отсутствует, поэтому я не могу там комментировать.

[править: страницы были бы похожи на сайт jekyll или что-то в этом роде. есть ли предпочтения в пользу автоформатирования?]

а страницы были бы похожи на сайт jekyll или что-то в этом роде.

Ага, вот и все. Кстати, вики тоже. Разница в том, что страницы предназначены для использования на сайте, а вики - для приблизительного набора более или менее коротких фрагментов информации, которые не отсортированы / не упорядочены. У меня (во время моего первого теста миграции) возникли некоторые проблемы, поскольку имена файлов автоматически угадываются базовым сервером, например, проблемы с учетом регистра.

Что вы имеете в виду под своим предложением

какие предпочтения в пользу автоформатирования?

Вы про стиль / верстку?

Извините, я имел в виду генератор сайта. Я считаю, что на страницах github можно использовать не только jekyll?

Я не уверен, что jekyll будет самым простым / лучшим способом организовать вики, но какое именно преимущество перед вики на github?

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

Я думаю, что на вики-странице github есть несколько фрагментированных страниц. Все это должно сводиться только к актуальной и правильной информации для текущего состояния проекта.

Извините, я имел в виду генератор сайта. Я считаю, что на страницах github можно использовать не только jekyll?

Без проблем. Может быть, я еще не до конца разобрался.

Я не уверен, что jekyll будет самым простым / лучшим способом организовать вики, но какое именно преимущество перед вики на github?

Что ж, разница незначительная, если честно, насколько я понимаю. Оба берут уценку (или любой другой формат, который может читать pandoc) и красиво форматируют.
Я обнаружил проблему в том, что вики не позволяет использовать пространства имен, а сопоставление ссылок и соответствующего имени файла является своего рода эвристикой:

• Вики есть две страницы, которые отличаются только заголовком ( 1 , 2 ). Мне пришлось вручную удалить один из них, чтобы эвристика выбрала правильный.
• Подпапки (используемые как своего рода пространство имен) могут быть созданы только при проверке с помощью git вручную. Ссылки не соблюдают этот интервал имен, поэтому вы можете иметь каждое имя файла только один раз, что делает структуру папок нецелесообразной. Я не знаю, как github выбирает страницу для имени в случае, если два файла имеют одинаковое имя.

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

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

Нет, я думаю, что сейчас он находится в хорошем месте.
Хотя я мог бы отметить, что была (?) Идея использовать github для главной домашней страницы. В случае необходимости можно перейти на github (если финансовое положение Drachenkaetzchen ухудшится, и у нее возникнут проблемы с оплатой сервера).

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

Я думаю, что на вики-странице github есть несколько фрагментированных страниц. Все это должно сводиться только к актуальной и правильной информации для текущего состояния проекта.

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

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

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

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

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

Сегодня у меня немного больше энергии, поэтому вот несколько мыслей:

• Текущая вики затрудняет предоставление документации людьми, так как мне пришлось отключить регистрацию, и мне пришлось вручную создавать пользователей.
• Интегрированная вики-страница GitHub затрудняет навигацию, особенно если на главной странице есть много страниц, на которые нет ссылок.
• Публикация документации должна быть простой. Предпочтительно, когда пользователи могут просто щелкнуть кнопку «Изменить страницу» для редактирования существующего содержимого и кнопку для создания нового содержимого. Пример, который мне нравится, можно найти здесь: http://marlinfw.org/docs/configuration/configuration.html - изменения приведут к запросу на вытягивание, чтобы его можно было просмотреть и правильно связать с сопровождающим документации.
• Однако в предыдущем примере нет кнопки «Новая страница», не знаю, как это можно сделать.

• Текущая вики затрудняет предоставление документации людьми, так как мне пришлось отключить регистрацию, и мне пришлось вручную создавать пользователей.

Это как-то противоречит вики, но я понимаю потребности.

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

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

• Публикация документации должна быть простой. Предпочтительно, когда пользователи могут просто щелкнуть кнопку «Изменить страницу» для редактирования существующего содержимого и кнопку для создания нового содержимого. Пример, который мне нравится, можно найти здесь: http://marlinfw.org/docs/configuration/configuration.html - изменения приведут к запросу на вытягивание, чтобы его можно было просмотреть и правильно связать с сопровождающим документации.
• Однако в предыдущем примере нет кнопки «Новая страница», не знаю, как это можно сделать.

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

Пользователь активно собирает информацию в локальном WIKI, который доступен по адресу https://readthedocs.web.cern.ch/display/PARTK.
Он предложил перенести эту информацию в другое место, но требуется руководство команды проекта. Обсуждение этого можно найти в группах Google PartKeepr https://groups.google.com/g/partkeepr-users/c/ehqapXqyY0o/m/1VWkA00dDAAJ