Standards.RESTStandards.REST A collection of standards and specifications, that help make fantastic HTTP/REST APIs. Don't reinvent the wheel, use fantastic wheels, hashed out by experts, that solve problems you hadn't even considered yet. Contribute Main Website
GraphiQL: GraphQL’s Killer App
Maybe you haven’t heard of GraphQL. It’s a query language for front-end engineers to retrieve data from the back-end. It might be helpful to think of GraphQL as an alternative to REST or JSON-API. So why does GraphQL matter? Why ditch known quantities like REST, SOAP, or whatever homegrown system you’re using? The specification’s Overview has some good points, but let me appeal to you in a differe
中間ファイル*.doctreeの内容をみてSphinxがどのようにreSTをparseしているか知りたい :: ドキュメンテーションツール スフィンクス Sphinx-users.jp
中間ファイル *.doctree の内容をみてSphinxがどのようにreSTをparseしているか知りたい¶ SphinxはreSTフォーマットで書かれたドキュメントを中間形式に変換してから、出力形式に書き出します。例えば make html を行うと以下の順番に処理が行われます。 make html を実行する conf.py等の環境情報を _build/doctree/environment.pickle に出力する 各 *.rst の内容を _build/doctree/*.doctree に出力する environment.pickle と *.doctree を元に _build/doctree/*.html を生成する ここで出力されたdoctreeファイルに、ドキュメントの中間形式 = Sphinxのドキュメントツリー情報が格納されています。これを見ると、reStrucut
Designing a RESTful API with Python and Flask
In recent years REST (REpresentational State Transfer) has emerged as the standard architectural design for web services and web APIs. In this article I'm going to show you how easy it is to create a RESTful web service using Python and the Flask microframework. What is REST? The characteristics of a REST system are defined by six design rules: Client-Server: There should be a separation between t
Best Practices for Designing a Pragmatic RESTful API
Your data model has started to stabilize and you're in a position to create a public API for your web app. You realize it's hard to make significant changes to your API once it's released and want to get as much right as possible up front. Now, the internet has no shortage on opinions on API design. But, since there's no one widely adopted standard that works in all cases, you're left with a bunch
An Overview of REST Metadata Formats
Although the REST community initially took a stance against metadata for REST APIs, a number of metadata standards have none-the-less emerged over the last couple of years, mainly fueled by the need to document APIs for their consumers. As an added benefit, the same metadata is now often used to generate code (both client and server), create test harnesses, production monitors and perform real-tim
ReStructuredText 入門
以下の文章中に "(quickref)" という形式のリンクがあります。これは、 Quick reStructuredText ユーザリファレンスへの相対リンクです。このリンクが 切れている場合は、 オンラインのクイックリファレンス を参照してください。 構造 まずはじめに、"Structured Text" （構造化されたテキスト）という呼び方には、 いくぶん不適切なところがあると指摘しておきます。実際には、首尾一貫したパターンを使う "Relaxed Text" （形式ばらないテキスト）とでも呼ぶべきものです。そのパターンを HTML コンバータで変換することで、WEB ブラウザで扱えるような「非常に構造化された テキスト」が生成されるのです。 最も分かり易くて基本的なパターンは、 パラグラフ（段落） (quickref) です。 （1つ以上の）空行で区分されたテキストのひとかたまりが
Sphinxの過去と、未来
Sphinxの過去と、未来¶ 著者: Georg Brandl 日付: 2012/12/25 原文: Sphinx, past and future 翻訳: @r_rudi, @shimizukawa このエントリーは日本語の Sphinx Advent Calendar 2012 に参加してくれないかというリクエストに応えて書いています。彼らはすごいよ！彼らは今年Sphinx Conferenceを開催して、イベントには70人もの人たちが集まったんだ！ Sphinx はいまや5歳になってるし、たぶん今までの歴史を振り返り、将来を語るのに良い時期じゃないかな。 このプロジェクトは2007年前半のいつ頃かに始まった。この投稿は私がPythonメーリングリストで見つけた中で一番古い。この時、Pythonのドキュメント作成のためのソースはLaTeXで書かれていた。私は科学的な文章を書くときには絶
emacs の rest-mode のバインディング - 科学と非科学の迷宮
id:ymotongpooのreST記事は素晴らしいのですが、現在の rst.el のバインディングは記事を書いたときよりも大分変わっているようなのでまとめておきます。 ヘルプのバインディング一覧から引っ張ってきただけでろくにチェックしてません(一応一通り動作確認はしましたが)。 多分そのうち更新すると思います。 DL版 rst.el と MacOS X Lion 付属 rst.el とでバインディングが違っていたので更新しました(2011/12/26) 基本系 キー(MacOS X Lion 標準付属) キー(DL版) 関数名 説明 C-=, C-c C-=, C-c C-a C-=, C-c C-= rst-adjust 見出しレベルの変更 C-c C-n C-M-a rst-forward-section 次の(下の)見出しにジャンプ C-c C-p C-M-e rst-backwa
reStructuredText(reST)をEmacsで書く際のまとめ - YAMAGUCHI::weblog
はじめに こんにちは、非モテエンジニアです。長らくExcelで仕様書を書くのがブームらしいですが、Sphinxでドキュメントを書くと耳から脳漿垂れ流しになってしまうほど楽しくなってしまうというもっぱらの噂（俺の中で）なので、EmacsでreSTを書く際の便利機能をまとめてみました。 参照 404 Not Found 手前味噌ですが自分が関わっているSphinxの日本ユーザ会のサイトです。そもそもSphinxってなによ？Sphinx自体をどうやって導入したらいいのよ？って方はご参照ください。もちろん既にご存知の方にも最新情報含め有益な情報が満載です。 Emacs Support for reStructuredText rst.elの本家。英語ですがrst-modeについて一番詳しい説明がある場所だと思います。 rst.elの色設定 - DiaryException 色設定について詳しく説明
はやわかり reStructuredText
本マークアップ記法の完全な詳細は reStructuredText のページに示されています。このテキストは、覚書としての性格の文書です。 "(詳細)" というリンクを辿ると reStructuredText 仕様書を参照できます。 ただし、相対リンクとなっていますので、リンク切れの場合は、 原版の "Quick reStructuredText" から参照してください。 目次 インライン マークアップ バックスラッシュによるエスケープ 章立ての構造 段落 記号つきリスト 番号つきリスト 定義リスト フィールドリスト オプションリスト 整形済みブロック ラインブロック 引用 Doctestブロック 表 区切り線 明示的マークアップ 脚注 出典 リンクターゲット 外部ターゲット 内部ターゲット 間接ターゲット 暗黙ターゲット ディレクティブ 代入参照とその定義 コメント 助けを得たい場合は
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
http://rest-layer.io/
Handy two-page restructedtext cheat sheet - Reinout van Rees
Online reStructuredText editor