March 2022
Intermediate to advanced
208 pages
2h 18m
Japanese
Content preview from Sphinxをはじめよう 第3版
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.
付録DMarkdownで書いてみよう
2021年現在、Markdownはとても人気のあるマークアップ言語です。GitHubをはじめとする各種Webサービスで採用されているほか、エディタやビューアなどの関連ツールの開発も活発です。その結果、多くの開発者が日々利用しています。
Sphinxはメインのマークアップ言語としてreStrucutedTextを採用していますが、Sphinx拡張を追加することであらたなマークアップ言語を扱えるようになります。ここでは、Sphinx拡張 MyST-Parser 1 を使い、Markdownで記述された原稿をSphinxで変換する方法を紹介します 2 。
- 1
- 2
以前はMarkdown向けのSphinx拡張としてrecommonmark (https://github.com/readthedocs/recommonmark)がよく用いられていましたが、近年メンテナンスが終了となったため、本書ではMyST-Parserを取り上げます。
D.1 Markdownの歴史
はじめに、Markdownの歴史についてひも解いていきましょう。
Markdownは2004年にJohn Gruber（ジョン・グルーバー）によって策定されました。シンプルで覚えやすい記法と、HTMLへの変換ツールの出来によって、Markdownはすぐに幅広い用途に使われるようになりました。今日では、とても多くのWebサービスやツール、ライブラリがMarkdownに対応しています。
サービス名 |
|---|
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access
More than 5,000 organizations count on O’Reilly
O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.Julian F.
I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.Addison B.
I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.Amir M.
I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.