Какие правила применяются к выходной папке SHFB IntelliSenseComponent?

Noda Time имеет проблему против того, что файл документации XML, который он отправляет, также содержит все внутренние и частные члены, что является стыд.

К счастью, Sandcastle Help File Builder имеет специальный компонент сборки - IntelliSenseComponent - который делает именно то, что нужно ... теоретически. К сожалению, я не могу понять, как его правильно настроить.

В документации приводится этот пример:

 

и говорится:

Приведенный выше пример взят из файла конфигурации Sandcastle Help File Builder. При использовании с ним заменяющие теги {@SHFBFolder} и {@OutputFolder} используются для вставки папки построителя файлов справки и выходной папки проекта в пути к файлам.Они заменяются во время сборки соответствующими значениями. При использовании компонента в собственных сценариях сборки замените теги относительным или абсолютным путем к сборке компонента и выходной папке соответственно.

Ну, я использую SHFB, так что я ожидал, что это сработает. Однако я не могу получить ничего , кроме абсолютного пути к работе. Я пробовал:

folder="."
folder="{@OutputFolder}"
folder="{@OutputFolder}XYZZY"
folder="{@OutputFolder}\XYZZY"
folder="{@OutputFolder}/XYZZY"
folder="{@OutputFolder}/XYZZY/"

(я просто использую XYZZY как нечто, что легко найти.)

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

folder="%CD%\XYZZY"

хотя это сработало ...

folder="%USERPROFILE%\XYZZY"

Это работает:

folder="c:\users\jon\test\xyzzy"

... но мне действительно не нужен абсолютный путь.

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

Используемые версии:

  • SHFB: 1.9.3.0
  • Sandcastle: 2.6.10621.1

43
задан Jon Skeet 15 February 2012 в 21:09
поделиться