Wie MSDN wie Links in Sandcastle Dokumentations-Website erstellen?

StackOverflow https://stackoverflow.com/questions/1007555

Frage

Ich habe eine Website Dokumentation meines Projekts mit Sandcastle generiert. Diese Website benutzt Frames so, wenn ich auf, obwohl Websites meine URL in Browser nicht ändert.

Ich möchte URL in Browser geändert haben, wenn ich über die Website Dokumentation blättern mit Sandcastle generiert. Warum? Weil ich möchte konkrete Unterseiten der Dokumentation aus anderen Teilen meiner Entwicklungsumgebung verbinden.

Und mehr weiter würde Ich mag diese permanenten Links haben. Also, wenn ich noch einmal Dokumentation von neuer Version meines Projektes erzeugen, Links nicht so ändern, dass ich nicht alle Links zu neuen ändern müssen.

Ist das möglich und wie dies zu erledige?

War es hilfreich?

Lösung

Um eine korrekte Links zu bestimmten Unterseiten der Dokumentation erstellen Sie ähnliche Anforderung verwenden: $ DOCUMENTATION_ROOT $ / Index.aspx Thema = html / $ topic_id $ .htm

z. http: // www. ewoodruff.us/shfbdocs/Index.aspx?topic=html/8dcbb69b-7a1a-4049-8e6b-2bf344efbbc9.htm statt http://www.ewoodruff.us/ shfbdocs / html / 8dcbb69b-7a1a-4049-8e6b-2bf344efbbc9.htm

Andere Tipps

Wenn Sie den Code unten nach oben von SplitScreen.js der Browser „injizieren“, um die TOC-Rahmen und konzentrieren sich auf die Inhalte hinzufügen Sie direkt verbunden (mit dem Trick Vitaly Shibaev zeigte). 

if (window==top) {
    window.location = "/?topic=" + (window.location.pathname.substring(1));
}

Dieser Code funktioniert es die Dokumentation an der Wurzel Ihrer Website platziert wird -., Wenn Sie es in einem Unterverzeichnis haben Sie auf „? / Thema“ erweitern müssen und den Unterordner Teil aus dem Pfad Teil entfernen

Mit dieser Änderung können Sie die „direkte Verbindungen“ verwenden. Ich erwarte, dass auch Menschen, die Sie über Google erhalten eine bessere Erfahrung (immer die Inhalte, die sie für und die TOC-Bar gesucht) zu finden.

Vitaliy und mawtex gelöst haben der Teil Ihrer Frage ‚wie Dokumentation subpages zu verknüpfen‘.

Die „machen Links permanent, so dass sie sich nicht ändern, wenn Dokumentation Regenerieren“ Teil Ihrer Fragen automatisch gelöst wird, da die HTML-Datei erstellt Namen auf einem Hash des Themas Standardnamen basieren. D. h Wenn Sie nicht den Teil des Codes ändern, die Sie dokumentieren, dann wird es die gleichen Dateinamen verwenden.

Sie können die Art und Weise ändern, dass HTML-Dateinamen generiert werden, aber alle angegebenen Methoden auf dem Mitgliedsnamen oder einen Hash des Themas ID basieren, so Links sollten nicht brechen, wenn der Code nicht geändert hat.

Siehe Sandcastle Help Builder Datei

Nicht verbunden mit StackOverflow
scroll top