Блог

Исправлено: в исходном запросе указано добавление созданных Doxygen HTML-страниц на сайт связи SharePoint. Однако Doxygen может генерировать документацию в других форматах, помимо html. Хотя я не так хорошо знаком с использованием документации Doxygen в других форматах, возможно, некоторые из этих альтернативных форматов имеют преимущество в том, что они более автономны и, следовательно, более совместимы с SharePoint. Я открыт для их рассмотрения, если кто-то может предложить эффективное решение. Ключевой желательной функцией по-прежнему будет некоторый уровень способности ссылаться (или, по крайней мере, размещать) на соответствующий пункт в документации (например, открыть документацию для определенного класса). Решение, которое просто представляет документацию в виде (потенциально очень длинной) «книги» для последовательного чтения, было бы плохим решением.

Исходное описание проблемы в терминах HTML-страниц приведено ниже:

Doxygen может создавать интегрированный набор html-страниц для документирования кода. Страницы на сайте связи Microsoft SharePoint могут ссылаться на доступные извне веб-страницы и потенциально могут ссылаться на страницы, созданные Doxygen, если они размещены в другом месте.

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

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

Я предпринял несколько попыток использовать HTML-страницы после их загрузки в иерархию папок в библиотеке документов. Однако я не смог найти способ, который затем мог бы корректно отображать их в браузере. Некоторые методы, казалось, разделяли страницы до голого html главной страницы без правильного применения таблиц стилей и т. Д. (Страницы, созданные Doxygen, включают файлы типов .css и .js, а также .html, .png и .svg.) Это не сработало, даже несмотря на то, что синхронизация была завершена.

Когда я направляю браузер (например, Microsoft Edge) на те же страницы в соответствующих папках на моем ноутбуке, тот же браузер отлично отображает страницы. (Это доступ к ним как к файлам с диска, а не через https через Интернет, но содержимое страницы и папки точно такое же.) Этот браузер может работать с этими HTML-страницами Doxygen и отображать их, но он не работает (пока?), Чтобы попытаться получить доступ к ним внутри сайта связи.

Заранее спасибо за информацию о том, как сделать так, чтобы страницы сайта связи ссылались на готовые страницы html (а также css, js и png), добавленные на коммуникационный сайт SharePoint.

p.s. Если вы хотите узнать, есть ли у вас решение этой головоломки, приложение Doxygen wizard упрощает создание некоторых страниц документации Doxygen html для любого приложения, которое у вас есть. Попробуйте сделать это с включенной панелью навигации для созданных страниц. Затем вы увидите, может ли ваш подход отображать правильное поведение страницы, даже если она связана со страницами внутри сайта связи. Спасибо.