問題タブ [docco]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票する
3 に答える
3397 参照

c++ - docco のような C/C++ 用のソース コード ドキュメント ジェネレーターはありますか?

doccoで生成された出力のように、文書化された C++ 実装ファイル (ヘッダー ファイルではない) で同様の出力を取得したいと思います。そのようなツールはありますか?

0 投票する
1 に答える
493 参照

node.js - Docco が広告どおりに機能しない

doccoを使用して、coffeescript を自動文書化しようとしています。以下の例では、コメントが適切に出力されます。しかし、コードは右ペインの出力に表示されません...出力として「undefined」だけです。さて、再確認したところ、前提条件のパッケージである Node.js、Pygments、CoffeeScript は既にインストールされています。

例: もの.コーヒー

私が考えることができる唯一のことは、ピグメントが正しいものを出力していないということです。これは、doccoから得たフィードバックです。

足りないものはありますか?

ありがとう

0 投票する
1 に答える
466 参照

coffeescript - docco / markdownでセクションに名前を付けますか?

CoffeeScriptとDoccoを使用して、生成されたHTMLでセクションが作成され、リンクとして使用できます。

これらのセクションに名前を付ける方法があるかどうか誰かが知っているので、代わりに(たとえば):

編集:これは、HTMLを手動で追加するだけで実現できるようです。

しかし、他に、おそらくもっとエレガントな方法はありますか?

0 投票する
1 に答える
298 参照

ant - docco で docs ディレクトリ ツリーを作成する Ant タスク

doccoで coffeescript ドキュメントを生成するための ant ファイルがあります。現在、すべてのドキュメント ファイルが docs フォルダーにダンプされていることを除いて、正常に動作します。すべてのファイルを 1 つのディレクトリにフラットにダンプするのではなく、docs フォルダーにスクリプト ディレクトリの構造を反映させたいと考えています。

docco に --output 引数があることは知っていますが、ファイルセット内の各ファイルの docs フォルダーに docs ディレクトリ パスを 1 つずつ調べずに生成する方法がわかりません。

0 投票する
3 に答える
532 参照

java - Java Maven プロジェクトの Marginalia / Docco など?

Maven を使用する Java (マルチモジュール) プロジェクトでMarginaliaを実行することは可能ですか?

または、これを行うことができる Marginalia やDoccoに似た他の代替手段はありますか?

私にとって重要なことは、それをいくつかのパブリック Maven リポジトリから依存関係として追加し、たとえば Docco の Node.js などの追加のものをインストールせずにすぐに使用できることです。これは Java プロジェクトであるため妥当です。

0 投票する
1 に答える
370 参照

gruntjs - タイトルのみのgrunt-dox生成htmlファイル

私はgrunt-dox grunt プラグインを使用して、 JsDocドックブロックを含む JavaScript ファイルから docco ドキュメントを生成してます。

grunt タスクを実行すると、指定したタイトルだけの HTML ファイルしか取得できません。grunt-dox のインストールまたはタスクの実行にエラーはありません。

私は Mac OS X 10.8.3 を使用していますが、それが機能しない理由ではないと強く感じています。

参照用の関連ファイルを次に示します。

私は何か間違ったことをしていますか?誰かがこれを機能させましたか?ところでgrunt test、doxタスクが含まれている実行中です。

私はこれに2日間立ち往生していて、あきらめる準備ができているので、助けていただければ幸いです.

更新:実行しようとしましdox --title POC public/javascripts/build/docs/docs.js > public/docs/index.htmlたが、永遠にハングします。

うーん。

0 投票する
1 に答える
446 参照

linux - Linuxコンソールのコマンドにフォルダからファイルを再帰的に送信する方法は?

コーヒー スクリプト ファイルのドキュメントを生成したいと考えています。ドコを使いたい。

私が使用するとき:

それはエラーをスローします。フォルダーがファイルリストにあるためだと思います。私が使用するとき:

ルートフォルダーに何もないため、いくつかのファイルが見つかりません。

すべての *.coffee ファイルをコンソールのコマンドに再帰的に与える方法は?

0 投票する
2 に答える
715 参照

javascript - Docco ページを整理するためのより良い方法

大規模なバックボーン スタイルのアプリケーション (最大 100 ファイル) があり、ドキュメントを自動化するための最適な方法を選択しようとしています。

docco ( grunt-docco2 を使用)を試していますが、問題が発生しています。私が持っているすべてのファイルを左側にリストしてから、スクロールする方法がないままウィンドウを通り過ぎます。おそらくドロップダウンのスタイルで、それらをグループ化することは可能ですか?

また、インデックスページなどを生成してもらうことは可能でしょうか? Docco は私が望むすべてのことの 99% を行うようですが、この 2 つのことが私を夢中にさせています!

0 投票する
1 に答える
639 参照

coffeescript - Docco はコメント ブロックを無視します

coffeescript ドキュメントを作成するためのツールとして docco を使用しています。

デフォルトでは、coffeescript ソースで作成したすべてのコメントはドキュメントとして扱われ、左側 (説明) の列に移動されます。問題は、私のソースにはコメントアウトされたコード行がいくつかあり、代替オプションとして残されているため、右側の (コード) 列に残しておきたいことです。

docco-「それには触れないでください。これは通常のコードのように残してください」と伝える方法はありますか? 「#!」または「#ignore」でしょうか?前もって感謝します。