Kuralları SHFB uygulanan ne'In İntelliSenseComponent'çıkış klasörü s?

SORU

15 ŞUBAT 2012, ÇARŞAMBA

Kuralları SHFB uygulanan ne'In İntelliSenseComponent'çıkış klasörü s?

Noda Time XML belgeleri gemiler ne yazık ki iç ve özel üyeleri de içeren bu dosya karşı issue vardır.

Neyse ki, Sandcastle Help File Builder bir özel vardır tam olarak doğru şeyi yapan bileşen- IntelliSenseComponent - teori kurmak. Ne yazık ki, dünya düzgün yapılandırmak için nasıl çözemiyorum.

Belgelere şu örneği veriyor:

 <output includeNamespaces="false" namespacesFile="Namespaces"
   folder="{@OutputFolder}" />

ve devletler:

Yukarıda verilen örnek kumdan kaledeki Builder yapılandırma dosyası Yardım alınır. Birlikte kullanıldığında, yedek etiketler {@SHFBFolder} ve {@OutputFolder} dosya yolları yardım builder klasör ve proje çıktı klasörüne dosya eklemek için kullanılır. Bu uygun değerleri ile oluşturma zaman değiştirilir. Eğer kendi bileşenini kullanarak komut dosyaları oluşturmak, bileşen montaj ve çıkış klasörü sırasıyla bir göreli veya mutlak bir yol ile etiketleri değiştirmek.

BenamSHFB kullanarak, böylece çalışmak için beklerdim. Ancak, alamıyorumhiçbir şeymutlak bir yol dışında çalışmak. Denedim:

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

(Sadece kolay aramak için bir şey olarak XYZZY kullanıyorum.)

** 30, bakarak bir ortam değişkeni kullanabilir miyim diye ümit ediyorum, ama bu olmuyor

folder="�%\XYZZY"

bu yapmış olmasına rağmen...

folder="%USERPROFILE%\XYZZY"

Bu gibi çalışır:

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

... ama gerçekten bir mutlak yol adı var istemiyorum.

Belgeleri, bu çok daha kolay... neyi kaçırıyorum? öneriyor

Sürümleri dahil:

SHFB: 1.9.3.0
Kumdan kaleyi: 2.6.10621.1

CEVAP

17 ŞUBAT 2012, Cuma

Deneylerim SHFB İntelliSenseComponent gösterdiyaptı{@OutputFolder} doğru tedavi, ama bir nüans var.

Eğer folder özniteliği belirtildi

<output includeNamespaces="false" namespacesFile="Namespaces"
        folder="..." />

bir klasöre işaretiçinde17* *klasörü (sizin durumunuzda.\docs\api) sonra SHFB işlem inşa bir proje klasörü oluşturur, ama o zaman web içeriğini oluşturmadan önce siler:

Last step completed in 00:00:34.5875
-------------------------------
Combining conceptual and API intermediate TOC files...

Clearing any prior web output
    Last step completed in 00:00:00.2360
-------------------------------
Extracting HTML info for HTML Help 1 and/or website...

Sorun varsayılan değer {@OutputFolder} tam olarak aynı değeri $(OutputPath), Bu nedenle eğer koymak gibi bir şey {@OutputFolder}\foo folder öznitelik sonra asla Göremezsiniz foo sonra inşa etti bitirdi.

Basit çözüm: bulunan bir klasörü belirtindışarıdabu gibi projenizin çıkış klasörü:

<output includeNamespaces="false" namespacesFile="Namespaces"
        folder="{@OutputFolder}\..\distilledApi" />
<!--                            ^^       -->

Bu yardımcı olur umarım.

Bunu Paylaş: