2012-02-03 1 views
5

Sono stato con Sandcastle con l'aiuto Sandcastle File Builder e per impostazione predefinita offre tre stili di presentazione: Hana, prototipo e VS2005.Sandcastle può generare documentazione HTML con lo stile MSDN più recente?

Anche se lo stile vs2005 sembra a posto, mi piace particolarmente lo stile leggero MSDN più leggero. C'è un modo per configurare Sandcastle in modo tale da generare documentazione con questo stile?

risposta

5

Le rispettive politiche di prodotto Microsoft/strategie sono davvero un po 'strano e in certa misura in contrasto con il passaggio ad un processo di sviluppo più aperto negli ultimi anni - Documentation comments, SandCastle and new documentation transforms è un buon rant che riassume lo stato ufficiale degli affari.

Detto questo, sembra che vi sia una soluzione non ufficiale (e quindi legalmente discutibile in discussione, vedi sotto) disponibili: Progetto sandcastle-presentationmira a creare nuovo modello di presentazione per il Castello di sabbia che genera la documentazione nello stile di MSDN Marchio leggero.

In particolare, si mira ad integrazione con il altamente raccomandato Sandcastle Help File Builder (SHFB), che affronta altri deficit menzionati suddetto rant, cioè è stato creato per colmare le lacune, fornire le funzionalità NDoc simili mancanti che vengono utilizzati più spesso e fornire strumenti grafici e a riga di comando per creare un file di guida in modo automatico.

Si prega di rivedere la SHFB discussione filo MSDN presentation style available on google code! per i diversi punti di vista circa la legalità di castello di sabbia-presentazione utilizzo e rendere il proprio giudizio di conseguenza.