Generieren Sie eine Sandburg-Hilfedatei für eine Website ohne die „XML-Dokumentationsdatei“ Option

Question

Ich versuche, eine Sandburg-Hilfedatei für eine Website zu generieren. Im Fenster Eigenschaften für Projekt, gibt es keine Optionen für die Erstellung der XML-Dokumentationsdatei, die für Sandcastle.

Die Registerkarte Erstellen in den Eigenschaftenseite enthält nur die Optionen für: Aktion starten, Build-Lösung Aktion und Zugänglichkeit Validierung. Ich habe keine Optionen für die Ausgabe oder XML-Dokumentationsdatei, wie meine andere Projekte haben.

Die Website, die ich mit gerade arbeite nicht eine tatsächliche .proj Datei haben, was das Problem sein könnte. Wenn dies das Problem ist, was ist der beste Weg, ein für ein Projekt zu schaffen, die unter Quellcodeverwaltung ist und von vielen Menschen mit minimaler Unterbrechung gearbeitet wird?

Dies wird mithilfe von Visual Studio 2005 Professional.

Answer 1

Das Problem mit Websites in VS2k5 ist, dass, wenn sie kompiliert bekommen, sind die resultierenden dlls ein Chaos. Keine Namensräume, seltsame Namen, etc.

Wenn Sie wirklich eine Sandburg-Hilfedatei erstellen möchten, suchen Sie Ihre Website in eine Web-Anwendung zu konvertieren. Sie können auf jeden Fall Quellcode-Dokumentation für das erzeugen.

Answer 2

Ich habe es noch nicht ausprobiert, aber Sie könnten die folgende versuchen wollen Dokumentieren Websites / Projekte von Eric Woodruffs Website . Es gibt die Einzelheiten, wie es getan werden kann.

Update: Ich habe es versucht und es funktioniert für normale Websites. Das einzige Problem, das ich sehen kann, ist dass die Websites haben keine Namensräume. Also, wenn ich es laufen lasse, bekomme ich ein Thema von FolderName_WebPage Klasse-Format ohne logische Gruppierung. So ist es alhpabetical durch Ordner und Seitennamen. Sobald Sie den Inhalt erstellt wurde, können Sie die Hilfedatei bearbeiten mit ein helpcompiler / Builder und gruppieren Sie die Themen nach Bedarf.