3

Sandcastle Help File Builderを使用していますが、「概念コンテンツ」に色付きのHTMLコードスニペットを含めたいと思います。これは可能ですか？もしそうなら、どのように？

<code>、<codeExample>、および<sampleCode language ="HTML"/>を試しました。

これまでのところ最良の結果は、サンプルHTMLをHTMLエンコードし、そのように.snippetsファイルに配置することです。

<?xml version="1.0" encoding="utf-8" ?>
<examples>
   <item id="htmlSnippet">
      <sampleCode language="HTML">
         &lt;span&gt;My Html&lt;/span&gt;
      </sampleCode>
   </item>
</examples>

次に、.amlファイルでそれを参照します。

<codeReference>htmlSnippet</codeReference>

色付けしたいのですが、フォーマットを追加する方法がわかりません。

4

3 に答える 3

1

これが古いことは知っていますが、Sandcastle は html を としてサポートしていxmlます。私と同じように他の誰かがこの投稿に出くわした場合に備えて、コメントする必要があると思いました.

これはうまくいくはずです：

<?xml version="1.0" encoding="utf-8" ?>
<examples>
   <item id="htmlSnippet">
      <sampleCode language="xml"><!CDATA[[
         <span>My Html</span>
       ]]>
      </sampleCode>
   </item>
</examples>

Sandcastle ヘルプ ファイル ビルダーを使用している場合は、ここと ここで説明されているように、独自の構文パーサーを作成できますが、既定では xml が使用可能です... XAML フィルターのジェネレーターを使用します。構成を確認する場合は、ここで定義されています:

<generator type="Microsoft.Ddue.Tools.XamlUsageSyntaxGenerator"
    assembly="{@SandcastlePath}ProductionTools\SyntaxComponents.dll">
    <filter files="{@SandcastlePath}Presentation\Shared\configuration\xamlSyntax.config" />
</generator>
于 2012-04-11T15:45:38.227 に答える
1

コード ブロック コンポーネントの SHFB ドキュメントによると、<code>.

問題なく動作しました。これが私がしたことです：

test.html

<html>
    <head>Something!</head>
    <body>
        <h1>Heading</h1>
<!-- #region myhtml -->
        <p>Paragraph</p>
        <div>Div for <strong>Good</strong> <em>measure</em>.</div>
<!-- #endregion -->
    </body>
</html>

何かまたはその他.aml

<code language="html" source="../Examples/test.html" region="myhtml" />

結果：

SHFB での HTML ハイライト

プレビューでは、サンプルは強調表示されていない XML として表示されますが、ドキュメントをビルドすると、すべて問題なく表示されることに注意してください。

于 2013-01-08T01:41:02.983 に答える