Локализованное руководство по чтению
wiki-ado-convertНазначение, использование и источник
КонвертируетVitePress/GFMПреобразует вики-маркировку в формат, совместимый с Azure DevOps Wiki. ГенерируетNode.jsскрипт сборки, который преобразует синтаксис Mermaid, удаляет метаданные, исправляет ссылки и выводит ADO-совместимые копии вdist/ado-wiki/.
Источник получен:
- Репозиторий-источник
- microsoft/skills
- SKILL.md
.github/plugins/deep-wiki/skills/wiki-ado-convert/SKILL.md- Звёзды репозитория
- 3,157
- Последнее обновление репозитория
- 2026-10-31
- Категории Skills
- Интеграция инструментов
- Время последнего сбора
Лицензия: MIT
Приведенные фрагменты описания рабочих процессов являются вспомогательными средствами для чтения, а не исполняемыми инструкциями от Codez. Для создания этой страницы не использовались сторонние инструменты.
Приведённые ниже фрагменты, описывающие цели и рабочие процессы, представляют собой исходный материал, систематизированный и переведённый для удобства чтения. Они отличаются от отдельно обозначенного редакционного анализа Codez.
Что делает этот навык
КонвертируетVitePress/GFMПреобразует вики-маркировку в формат, совместимый с Azure DevOps Wiki. ГенерируетNode.jsскрипт сборки, который преобразует синтаксис Mermaid, удаляет метаданные, исправляет ссылки и выводит ADO-совместимые копии вdist/ado-wiki/.
Как работает рабочий процесс на вышестоящем уровне
ADO Wiki Converter
СгенерироватьNode.jsсоздать скрипт, который преобразуетVitePress/GFMПреобразование документации в формате Markdown в формат, совместимый с Azure DevOps Wiki. Исходные файлы остаются неизменными — скрипт создает преобразованные копии.dist/ado-wiki/.
Разрешение репозитория исходного кода (ОБЯЗАТЕЛЬНО СДЕЛАТЬ В ПЕРВУЮ ОЧЕРЕДЬ)
Перед генерацией скрипта сборки определите контекст исходного репозитория: Проверьте наличие удаленного репозитория Git: Выполнитеgit remote get-url origin
Почему это необходимо
В вики-страницах Azure DevOps используется диалект Markdown, который отличается от GFM и VitePress по нескольким важным параметрам. Документация, которая идеально отображается в VitePress, при публикации в виде вики-страницы ADO будет содержать неработающие диаграммы, необработанные вводные данные, неработающие ссылки и проблемы с отображением.
проход вверх по течению · L24 ↗function stripFrontMatter(content) {
if (!content.startsWith('---')) return content;
const endIndex = content.indexOf('\n---', 3);
if (endIndex === -1) return content;
let rest = content.slice(endIndex + 4);
if (rest.startsWith('\n')) rest = rest.slice(1);
return rest;
}Требования и настройка
ПРОБЛЕМ НЕТ (совместимо как есть)
✅ Стандартные таблицы Markdown, цитаты, горизонтальные линии ✅ Эмодзи Unicode, блоки кода с идентификаторами языка
проход вверх по течению · L51 ↗Ограничения и проверки качества
Важные примечания
Исходные файлы НИКОГДА не изменяются — в них только копии.dist/ado-wiki/Изображения также необходимо скопировать — если в исходном файле есть изображения, скопируйте их, используя те же относительные пути.
Начните с безопасного пробного периода.
- Проверьте поддерживаемый хост и инструкции по установке репозитория. Храните каталог Skill, а также связанные с ним скрипты, ресурсы и документацию вместе;SKILL.mdВ одиночку можно опустить зависимости.
- Предоставьте агенту ваши реальные входные данные, желаемый результат и критерии приемки. Синтаксис вызова и доступные инструменты зависят от хоста; данный сайт не предполагает универсальной команды установки.
- Попробуйте запустить исходный рабочий процесс в тестовом проекте или в его копии. Перед тем как разрешить операции, изменяющие файлы, удаленные сервисы или оплачиваемые ресурсы, проверьте их.
- Проверьте выходные данные на соответствие исходным проверкам качества и вашим собственным требованиям. Успешный запуск или большое количество звезд в репозитории не гарантируют корректного результата.
Подробнее читайте в источнике.
- ADO Wiki Converter
- Разрешение репозитория исходного кода (ОБЯЗАТЕЛЬНО СДЕЛАТЬ В ПЕРВУЮ ОЧЕРЕДЬ)
- Почему это необходимо
- ПРОБЛЕМ НЕТ (совместимо как есть)
- ADO Wiki Mermaid Поддерживаемые типы диаграмм
- Структура скрипта сборки
- 1. Удалить метатег YAML
- 2. Преобразовать блоки русалки
- 3. Преобразовать родительские ссылки относительно родительского источника
- 4. Преобразование директив контейнера VitePress (необязательно)
- Пропустить каталоги
- Контрольный список проверки
- Создание индексной страницы (КРИТИЧНО)
- Логика
- ADO Wiki
.orderФайлы - Сохранение цитирования и диаграмм
- Важные примечания
Смежные навыки
Перевод и сфера применения
В этом руководстве по чтению представлены избранные отрывки из закрепленного текста выше по течению.SKILL.mdПеревод выполнен с помощью переводчика. Это не полное руководство и не гарантия проверенной совместимости. Перед использованием ознакомьтесь с оригиналом и указанными в нем файлами.
Данное введение относится к закрепленной ниже версии; текущая активность в репозитории и время сбора данных отображаются отдельно.
- Закрепленный источник
- Прочитайте оригинал ↗
- Источник получен
- Исходный коммит
00d66a64919edca5bca2c673373444e36a4b5461- Исходный SHA-256
afb330d4d5b43c470e83693ef73caee21f99c149dd5011f8543c424a751cebc3