Sandcastle Aiuto File Builder Can not Trova fonte di documentazione

Question

Sto costruendo il doc di un progetto C 2010 VS. con il Builder di file guida di Sandcastle. Ho aggiunto la documentazione .xml generata dal compilatore e il file di progetto di Visual Studio .sln alle fonti di documentazione . Ho anche aggiunto l'eseguibile del progetto .exe a Riferimenti. Tuttavia, non sta costruendo. Mi arriva avvisi e gli errori:

SHFB: Avviso BE0006: Impossibile individuare eventuali fonti di documentazione per 'C: \ Users \ user \ Musica \ Documenti \ Visual Studio 2010 \ Projects \ SFML_Platformer \ SFML_Platformer.sln '(Configurazione: Debug Piattaforma: AnyCPU)

SHFB: BE0042 Errore: È necessario specificare almeno una fonte di documentazione nella forma di un file di soluzione di Visual Studio/progetto

montaggio o Qual è la problema?

Answer 1

È consigliabile aggiungere i file di documentazione XML come Origine documento. Le DLL vengono aggiunte automaticamente dopo aver aggiunto i file XML.

Answer 2

Qui la risposta di Eric a.k.a EWoodruff lo sviluppatore di Sandcastle Help File Builder.

BE0006 significa che non è stata trovata la fonte della documentazione basata sul progetto . BE0042 è un risultato secondario di quello che significa che ha trovato niente da documentare. Che tipo di progetti ci sono nella soluzione ? Se si tratta di un progetto di sito Web, tenere presente che in genere non producono alcun assembly elencato come output nel progetto né alcun file di commenti XML. In tal caso, è necessario aggiungere i provider di codice Web al progetto per ottenere i commenti XML e aggiungere manualmente la cartella. \ Bin del sito Web come origine della documentazione in il progetto SHFB. C'è un argomento sulla documentazione dei siti web nella sezione Per iniziare, se questo è il caso.

Tutti gli altri tipi di progetto dovrebbero funzionare. Se tutto il resto fallisce, prova ad aggiungere direttamente all'assembly e ai file di commenti XML. Suppongo sia possibile le edizioni Express utilizzano ID di tipo di progetto diverso. Se riesci a inviarmi il file di soluzione e il file di progetto , posso dare un'occhiata a loro e vedere perché non sta trovando gli obiettivi. Il mio indirizzo e-mail è nella casella Informazioni su nella GUI standalone e nel footer delle pagine nel file di guida .

Un altra cosa, assicurarsi che le impostazioni di configurazione e della piattaforma selezionato nella barra degli strumenti SHFB corrisponde alla configurazione e della piattaforma impostazioni utilizzate per costruire il vostro progetto (cioè Debug/AnyCPU, rilascio/AnyCPU, Debug/x86, ecc) . In caso contrario, non sarà possibile trovare target di output corretti.

Eric

source

Answer 3

ho avuto questo problema si verifica quando sono passato di generazione del progetto in VS.NET relativa alla mia domanda principale Debug-Release. Presumo che non possa più trovare il file .dll che avevo specificato per creare la documentazione. Avrei potuto correggere la mappatura, ma tornare a Debug ha funzionato bene per me per rimuovere questo errore.

Answer 4

Non dimenticare di ricostruire la soluzione dopo averla pulita prima di eseguire Build in Sandcastle.