Generare un file della guida di Sandcastle per un sito Web senza l'opzione "File di documentazione Xml"

Question

Sto cercando di generare un file della guida di Sandcastle per un sito Web. Nella finestra delle proprietà del progetto non sono presenti opzioni per la creazione del file di documentazione XML richiesto per Sandcastle.

La scheda Genera nelle pagine delle proprietà contiene solo le opzioni per: Avvia azione, Crea soluzione soluzione e Convalida accessibilità. Non ho opzioni per Output o file di documentazione XML, come hanno fatto i miei altri progetti.

Il sito Web con cui sto lavorando non ha un vero file .proj, che potrebbe essere il problema. Se questo è il problema, qual è il modo migliore per crearne uno per un progetto che è sotto il controllo del codice sorgente e su cui stanno lavorando molte persone con interruzioni minime?

Questo utilizza Visual Studio 2005 Professional.

Answer 1

Il problema con i siti Web in VS2k5 è che, quando vengono compilati, le dll risultanti sono un disastro. Nessuno spazio dei nomi, nomi strani, ecc.

Se vuoi veramente generare un file di aiuto di Sandcastle, cerca di convertire il tuo sito Web in un'applicazione web. Per questo puoi sicuramente generare documenti di codice sorgente.

Answer 2

Non l'ho ancora provato, ma potresti voler provare quanto segue Documentazione di siti Web / progetti dal sito di Eric Woodruff . Fornisce i dettagli su come può essere fatto.

Aggiornamento: l'ho provato e funziona per i normali siti Web. L'unico problema che posso vedere è che i siti Web non hanno spazi dei nomi. Quindi quando lo eseguo ottengo un argomento da FolderName_WebPage Formato della classe senza alcun raggruppamento logico. Quindi è alhpabetical di nome della cartella e della pagina. Una volta creato il contenuto, è possibile modificare il file della guida utilizzando un helpcompiler / builder e raggruppa gli argomenti secondo necessità.