MS Sandcastle - Есть ли какой-нибудь быстрый способ «предварительного просмотра» того, что будет на выходе, без перекомпиляции всей справки? - PullRequest
1 голос
/ 12 июля 2011

Ну, заголовок спрашивает все это.

У меня есть графический редактор Sandcastle Help File Builder.Я могу создавать файлы справки, но мне было интересно, есть ли более быстрый способ увидеть результаты, кроме перекомпиляции всего файла справки.


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

Ответы [ 2 ]

2 голосов
/ 13 июля 2011

Нет, нет возможности предварительного просмотра, но есть некоторые настройки SHFB, которые позволяют значительно сократить время сборки.В моем случае моя сборка с 16 до 18 минут была уменьшена до 3 минут.

То, что вы хотите настроить, это Кэшированные компоненты сборки .И не бойтесь, регулировка этих 3 компонентов не требует никаких тайных манипуляций или сложных вращений.

  1. Просто перейдите в раздел Build в графическом интерфейсе SHFB и найдите строку рядом с верхней частью, помеченную ComponentConfigurations .
  2. Нажмите наполе значения для отображения скрытой кнопки с многоточием (...).
  3. Нажмите эту кнопку, чтобы открыть диалоговое окно Выбор и настройка компонентов сборки .
  4. Выбор по очереди каждогоиз трех записей, начинающихся Cached ... и выберите действие Add.
  5. Они не требуют настройки, поэтому закройте диалоговое окно, и в случае успеха главное окно SHFB теперь должно показывать 3пользовательские компоненты сборки .

Обязательно ознакомьтесь с документацией по вышеуказанной ссылке для получения более подробной информации.

Просто для полноты, два других вопроса, представляющих интерес:

Взгляните на это сообщение на форуме ( Сборка Sandcastle занимает несколько часов, чтобы завершить ), где обсуждается, как ваше оборудование может оказать огромное влияние и на время сборки Sandcastle.

Посмотрите на мое искусствоicle Укрощение Sandcastle: Руководство программиста .NET по документированию вашего кода на Simple-Talk.com, в котором обсуждается довольно много советов и ошибок Sandcastle и SHFB - по иронии судьбы я раскрыл здесь свой совет о компонентах кэшированной сборкипосле того, как эта статья вышла в печать, так что вы не найдете ее там!

0 голосов
/ 28 апреля 2017

В графическом интерфейсе SandCastle перейдите в меню «Окно» и откройте окно «Просмотр темы».

Если у вас установлено приложение Visual Studio и расширение Sandcastle VSiX, перейдите в меню «Вид» Visual Studio> Другие окна и нажмите «Просмотр темы».Окно.

См. https://ewsoftware.github.io/SHFB/html/d3c7584d-73c0-4725-87f8-51e4ad956694.htm.

...