Google アプリ スクリプト ライブラリの自動生成ドキュメントを使用する場合、prettyprintコード サンプルに Google クラスを使用できますか? preタグ
に含めてみました：<pre class="prettyprint">
しかし、生成中に取り除かれるようです。
@see コマンドを使用して、コード ドキュメント内の関数や外部リソースを参照する方法はありますか?
1 に答える
1
google-apps-script でサポートされている gsdoc タグには多くの制限があり、そのうちの 2 つだけを説明しました。html 要素属性のサポートなしと、doc タグの制限です。How to preview jsdoc comments in google doc scripts で、他のいくつかの問題について説明しました。
未解決の問題もあります。
- スクリプト エディター内から jsDoc ドキュメントをプレビューする
- ライブラリで @example をサポートすることで、例を簡単に表示できます
- ライブラリのドキュメントによるオブジェクト指向インターフェイスのサポート
特定の懸念事項に対して新しい問題を追加できます。この@seeタグは特に奇妙です。これは、Base Services のドキュメントで使用されているように見えるため、タグが Google だけで機能するか、代わりに html が使用されているかのいずれかです。
1 つのオプションは、別のプラットフォームまたはホスティング サービスでドキュメントをビルドしてホストすることです。これは、 2D Array Libraryなどのいくつかの注目すべきライブラリで行われていることです。次に、jsdoc を使用してドキュメントを生成し、タグ セット全体の豊富な機能を利用できます。
于 2012-12-19T22:07:33.497 に答える