Swagger APIはインタラクティブに動く REST API のドキュメントを比較的簡単に作ることができて便利です。自分も実際に業務やプライベートアプリに使っています。
この機能を使う場合、YAML と言われるフォーマットをベースにした記述方法で API の仕様を記述するだけで動く API ドキュメントページを作ることができます。
で、この YAML で仕様を記述する際に「コメント」を記述したくなることがあります。実質的にプログラミングする必要なく API テストページを作れるのは便利で、プログラミング時と同様にコメントを残したくなることもあると思います。 が、YAML でコメントを書いたことがなかったので、改めて明示的にコメントを残そうとした際の手法がわからず、調べてみました。
答えとしては「# から行末までがコメント」となるようです。つまり一行単位でコメントが生成されます。「ここからここまで」という範囲コメントは存在していないようです。
なお、コメント扱いにしたくない # を含めたい場合は \# のようにバックスラッシュでエスケープすることで実現できます。
この機能を使う場合、YAML と言われるフォーマットをベースにした記述方法で API の仕様を記述するだけで動く API ドキュメントページを作ることができます。
で、この YAML で仕様を記述する際に「コメント」を記述したくなることがあります。実質的にプログラミングする必要なく API テストページを作れるのは便利で、プログラミング時と同様にコメントを残したくなることもあると思います。 が、YAML でコメントを書いたことがなかったので、改めて明示的にコメントを残そうとした際の手法がわからず、調べてみました。
答えとしては「# から行末までがコメント」となるようです。つまり一行単位でコメントが生成されます。「ここからここまで」という範囲コメントは存在していないようです。
info: description: 普通の行 # description: コメント行 titie: タイトル # ここはコメント
なお、コメント扱いにしたくない # を含めたい場合は \# のようにバックスラッシュでエスケープすることで実現できます。
コメント
コメント一覧 (1)
yamlをテキストで開き、必要なものを書き込みして使うのですが
Twitterを自動に動かすものです
APIなどのKEYはできておりますが
timeline_params: # 検索したキーワードのツイート情報を用いる機能のパラメータ
keyword: # 検索するキーワード(適宜検索オプションを調べて追加してください)
- "抽選 懸賞 -100万円 -現金プレゼント -rt -filter:replies min_retweets:100 -source:twittbot.net -source:Botbird tweets"
どこで調べるのか
突然にこのようなメールしてすみません
youme_hanabi@yahoo.co.jp からであればもつと詳しく送れる(ファイル)ので見てほしいです