5

Sandcastle を使用してプロジェクトの Web サイト ドキュメントを作成しました。このウェブサイトはフレームを使用しているため、サイトをクリックしてもブラウザの URL は変わりません。

Sandcastle で生成された Web サイトのドキュメントを参照するときに、ブラウザーで URL を変更したいと考えています。なんで？開発者環境の他の部分からドキュメントの具体的なサブページにリンクしたいからです。

さらに、このリンクを永続的にしたいと考えています。したがって、プロジェクトの新しいバージョンからドキュメントをもう一度生成しても、リンクは変更されないため、すべてのリンクを新しいものに変更する必要はありません。

これは可能で、これを達成する方法は?

4

3 に答える 3

4

ドキュメントの特定のサブページへの正しいリンクを作成するには、同様のリクエストを使用できます：$ DOCUMENTATION_ROOT $ / Index.aspx？topic = html / $ TOPIC_ID $ .htm

例：http ：//www.ewoodruff.us/shfbdocs/html/8dcbb69b- の代わりにhttp://www.ewoodruff.us/shfbdocs/Index.aspx?topic=html/8dcbb69b-7a1a-4049-8e6b-2bf344efbbc9.htm 7a1a-4049-8e6b-2bf344efbbc9.htm

于 2010-08-08T16:03:32.497 に答える
4

以下のコードをSplitScreen.jsブラウザーの上部に追加すると、TOC フレームが「挿入」され、直接リンクしたコンテンツに焦点が当てられます (Vitaly Shibaev が示したトリックを使用)。

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

このコードは、ドキュメントが Web サイトのルートに配置されている場合に機能します。ドキュメントがサブフォルダーにある場合は、「/?topic」を展開し、パス名部分からサブフォルダー部分を削除する必要があります。

この変更により、「直接リンク」を使用できるようになります。また、Google 経由であなたを見つけた人がより良い体験を得ることも期待しています (検索したコンテンツと TOC バーを取得します)。

于 2010-09-08T13:06:35.100 に答える
0

Vitaliyとmawtexは、質問の「ドキュメントのサブページにリンクする方法」の部分を解決しました。

作成されたhtmlファイル名はデフォルトでトピック名のハッシュに基づいているため、質問の「リンクを永続的にして、ドキュメントを再生成しても変更されないようにする」部分は自動的に解決されます。つまり、ドキュメント化するコードの一部を変更しない場合、同じファイル名が使用されます。

HTML ファイル名の生成方法は変更できますが、指定されたすべてのメソッドはメンバー名またはトピック ID のハッシュに基づいているため、コードが変更されていない場合、リンクが壊れることはありません。

詳細については、Sandcastle Help File Builder のNamingMethodドキュメントを参照してください。

于 2010-10-13T05:37:54.233 に答える