SandCastle tarafından oluşturulan iki sayfayı tek bir ana sayfaya birleştirmek mümkün mü? Projede her sınıf için

Question

, SandCastle (diğerlerinin yanı sıra) oluşturur iki sayfa:

• bilgi ile T_class_full_name olarak adlandırılan ana sayfa,, sözdizimi, Kalıtım Hiyerarşi ve
• üye sayfası Ayrıca Bkz, , Constructor'u, Yöntemler, Fields ile, AllMembers_T_class_full_name olarak adlandırılan vb

birlikte bu iki birleştirmek için bir yolu var mı - members page ile ana sayfaya ekleniyor?

Answer 1

Bunun için bir çalışma cevap veremez ama birisi onunla etrafında kesmek için istekli olup olmadığını çalışabilir bazı fikirler sunabilir:

1. yapılandırma htmlBody.xsl bazı tanımlar üyeler için bir test içeren bir bölüm içeren yapı: <xsl:if test="$subgroup='members'"> Eğer bu sınıf seviyesinde açılmışsa (veya sadece doğruya ayarlanmışsa, bu çıktının nasıl üretildiğine dair bir fikir verebilir. (Sihirli bir mermi olacağını düşünmüyorum)

2. Burada (sanırım) üye alt gruplarının bağlantılarının eklendiği yer de, bununla da oynayacağım:

<!-- add a link to the member list section for this subgroup --> 
<a href="#{$elementVisibility}Toggle" onclick="OpenSection({$elementVisibility}Toggle)"> 

3. diğer fikirler yapısıyla etrafında oynamaya çalışıyor, ancak herhangi açık bir cevap temin etmek azından ben kesmek gerekir var. Ben htmlBody.xsl bunu yapmak için yer olduğunu emin bile yakın değilim. Aslında burada bir ihtiyaç olsaydı ben yaparak hedefinize en kolay elde edebiliriz düşünüyorum şu:

• oluşturulan belgeleri ayrıştırın standart bir şekilde belgelere oluşturun ve DOM/XML ayrıştırıcı kullanılarak ikisini birleştirme (yani kod ve çıkış geçerli sayfada çapa güncellendi URL'ler ile yeni bir tek sayfa HTML belgesi içinde ikisini birleştirme)

güzel bir şey oluşturulan dosya ve linkler kullanılan tutarlı bir adlandırma şeması olmasıdır Bu yüzden bu süreci yazmanın ve bağlantıların tüm bağlantı noktalarını güncellemenin daha kolay olacağını düşünüyorum. Şablonlarla çok fazla uğraşmak. Bunun aslında bu tür belge manipülasyonuyla deneyimlenen biri için başarmanın oldukça kolay olacağını düşünüyorum.

Savunma: Bir SandCastle uzmanına yakın bile değilim, sadece bir yıldan fazla bir süre önce kullanmıştım. Aynı zamanda, hacklemeyi nasıl ele alacağımı düşünerek, bugüne kadar hiç vakit harcamamıştım, sadece kutunun dışında kullanıyordum. Diğer cevapların olmaması dışında buna cevap bile vermezdim. Bunu gerçekleştirmek için desteklenen bir yapılandırma yolu olabilir, ancak sıradan bir kullanıcı olarak nasıl yaklaşacağımı bile düşünemiyorum.

Ayrıca, HTML çıktısının SHFB ile olan deneyimime dayanarak nasıl görüneceğine dair bazı varsayımlar yapıyorum. Orada da uzanabilirim. Artık sandcastle dökümantasyonunu oluşturabileceğim bir projem yok, ama SandCastle'ın bir HTML çıktısına bir bağlantı gönderebilir ve bu yaklaşımla ilgilenirse daha fazla yardımcı olmaktan mutluluk duyarım.