44種類のフォーマットに対応したPandocでMarkdownをHTML形式に変換する | DevelopersIO
今回紹介するMarkdownやHTMLは当然として、reStructuredText、Textile、LaTeX、何故かCSV，EPUB、docx（Word）や、pptx（PowerPoint）、Jupyter notebook、各種Wiki形式、PDFに対応しています。 魅力②「メタデータや独自フォーマットへの豊富な対応」 Pandocは、Markdownのシンタックス拡張や、ドキュメントメタデータ、テーブル、脚注、箇条書き、上付き文字、下付き文字、順序付きリストに対応しています。文書変換時に、このあたりのフォーマット情報がきちんと変換されるのは心強い。 魅力③「定期的なアップデート」 Pandoc - Releasesを見るとわかりますが、ほぼ3ヶ月に一度ほど定期的に更新されています。最新のリリースは2020年2月15日と非常にフレッシュ！ 自分実はPandoc自体は3年ぐらい前からそ
WSL2上のDockerを用いてAsciidocの文書，スライドを書く - 粗大メモ置き場
9/6 メモ吐き出し。 3行まとめ Docker on WSL2はいいぞ なぜAsciidocを使うのか Asciidoc文章の所感 Asciidoc スライドの所感 Asciidoc を使う Asciidocのイメージをインストール Revealjsのプレゼン資料を作る Gitlab CIと連携して静的なページを作成する。 まとめ 3行まとめ WSL2上で動かすDockerはいいぞ Windowsだと設定が面倒なAsciidocも簡単に使えるぞ ということです。 Docker on WSL2はいいぞ 自前の環境を汚さずになにか作業したい場合，Dockerは非常に便利なツールです。 WSL1やDOSネィティブの環境でDockerを使おうとした場合，従来はHyper-Vが必要（Windows Homeでは無理）だったのですが，WSL2のUbuntu環境を立てることで，Ubuntu上でaptか
技術文書をAsciidoc で書いて、GitlabでCIしている話 - Qiita
うちのチームでは、AsciiDoc で仕様書や技術メモを書きGitlab で管理しています。 あるとき、Redpenを紹介されたのを機会に、ドキュメントのCIを回すようにしたので、そのお話です。 AsciiDoc って？ 軽量マークアップ言語の一つです。 以下のような過程を経て、AsciiDocを利用するようになりました。 Word を共有フォルダで管理 重い。差分管理しづらい。同時編集がしづらい Markdown をgitlabで管理 軽い。Gitで編集履歴が簡単に確認可能。 Gitlab上で、整形された状態でプレビュー可能。 方言がある（エディタのプレビューではきちんと表示されても、gitlab上で崩れる） テーブルの編集が大変（特に更新の時が。。。） AsciiDoc をgitlabで管理 軽い。Gitで編集履歴が簡単に確認可能。 テーブル編集が楽。複雑な構造のテーブルもかける。As
脱Word、脱Markdown、asciidocでドキュメント作成する際のアレコレ - Qiita
asciidocとは asciidocはMarkdownなどのような軽量マークアップ言語の一つで、Webページなどをプレーンテキストで記述することができる(拡張子は.adoc) asciidocを使うようになった経緯 これまではWordで機能仕様書とか書いていたが、Wordは重い、変更場所が分からない、複数人同時に修正とか面倒で、いい加減Wordを使うのは止めたくなった なので軽量マークアップ言語にしよう、一番メジャー？なMarkdownにしたら、以下の制約とかでいくらなんでもイマイチ。。 表でセルの結合ができない 表のセル内で箇条書きができない 目次が作れない 文字に色がつけられない 上記に対応しようとすると、プラグインやらMarkdown亜種がいろいろ。。 そこで、Markdownより表現方法が豊富なasciidocを使用し、実際に使って、特徴・課題を挙げてみた。 asciidocto
asciidoc to markdown - Qiita
ググったけど結局いい感じのものが見つからなかったので、自分用のメモを兼ねて。 asciidocをmarkdownに変換しようとしてハマった話です。Linuxは参考にした記事を、Macはこの記事を参考にすることで解決の糸口になるかもしれませんが、Windowsは検証する環境が現在無いため、わかりません。。。あしからず。 TL;DR ココ見てConvert asciidoc to markdown pandoc, asciidoc をインストールする asciidocのコマンドでdocbookに変換したら、docbookをpandocでmarkdownに変換する 背景 少し周りでasciidocの話を聞いてみたので実際に試してみようと思い、ブログ記事をかき始めた。 ブログサービスではmarkdownをサポートしているため、変換する必要があった。 そこでPandocでサクッと変換してブログ記事の
技術書典5で頒布する予定の本のコードの動作チェックや、文章の校正をCIでするようにした話
TL;DR (概要) Crystalのような破壊的変更がアクティブなプログラミング言語の本を作る場合、バージョンアップで本の内容が壊れることが よくある。 この問題に対処するため、技術書典5で頒布する予定の本では、サンプルコードが正しく動作することをCIで確認するようにした。 ソースコードのフォーマット忘れが無いかもチェックするようにした。 ↑のようなことができたのはAsciidoctorのソースコードをincludeする機能の力が大きい。 ついでにRedPenで文章の校正も行なうようにした。 長期間に渡ってメンテナンスする予定の本であればこのような工夫するのは当然だし、そうでなくても本の品質を高める意味でこの工夫には価値があると思う。 はじめに(ポエム) Crystal-JPというプログラミング言語Crystalの日本語ユーザーグループで、Crystalの普及に勤しんでいる、ということに
Atom Flight Manual
CompanyEngineeringProductSunsetting AtomWe are archiving Atom and all projects under the Atom organization for an official sunset on December 15, 2022. January 30, 2023 Update: Update to the previous version of Atom before February 2 On December 7, 2022, GitHub detected unauthorized access to a set of repositories used in the planning and development of Atom. After a thorough investigation, we hav
asciidocのimage記法 – Aimless
背景 asciidoctor-pdfで画像入りのPDFを作り始めたものの、センタリングやサイジングなどMarkdownには存在しない記法が覚えられません。asciidocは高機能ですが、使いこなせなければ意味がない。 というわけで、公式のユーザガイドから使いそうなものをまとめました。 実践 画像の種類 インラインとブロックがあります。違いはコロンの数です。 区分 記法
AsciiDoc と PlantUML と mermaid.js で素敵なテキストベース仕様書ライフ
以前からテキストベースで仕様書(PDF)などを管理したいと思っていたのですが、ようやくその環境が整い、一度実際に運用してみてかなりいい感じだったので紹介したいと思います。 基本テキストは AsciiDoc で記述する UML は PlantUML で記述する フローチャートとかは必要に応じて mermaid.js も使う つまり基本テキストで表現・管理できるものはテキストで書く 成果物は PDF形式。目次(Table of Contents) はつける。 動作確認環境 macOS Sierra 10.12.3 ruby 2.3.1 Asciidoctor 1.5.5 Asciidoctor PDF 1.5.0.alpha.14 Asciidoctor Diagram 1.5.4 mermaid 7.0.0 AsciiDoc とは AsciiDoc Home Page 軽量マークアップ言語の
AsciiDoc と PlantUML (仮) - Qiita
GitLab CE が AsciiDoc ドキュメントへの PlantUML埋め込み に対応しました。また、AsciiDoc JebBrains Plugin を使えば、IntelliJ Idea で AsciiDoc をプレビューすることができます。(しかも、PlantUML に対応しています) 今まで難しかった設計書の管理を GitLab CE/EE でできそうな気がしてきました。まだどこかの開発で使ったという話ではありませんが、調べてみた結果を掲載します。また、マニュアルを書くのにもとても役に立ちそうです。 はじめに AsciiDoc とは? AsciiDoc は公式サイトでこのように書かれています。記事やドキュメントや書籍などを書くためのフォーマットで、HTMLやPDFやEPUBなどに出力できます。 AsciiDoc is a text document format for wr
AsciiDoc入門 - Qiita
AsciiDocとは AsciiDocはMarkdownなどのような軽量マークアップ言語の一つです。 利用例 Pro Git book - Github オライリーの書籍 Clojure Cookbook - Github Programming Scala Mastering Bitcoin - Github Open Government - Github O’Reilly Atlas Neo4j documentation - Github Git User's Manual なぜAsciiDocを使うのか 表現力と可読性 技術文書を書く場合HTMLは汎用性が高いが可読性が低い、一方Markdownは可読性が高いがテーブル記法がないなど表現力が乏しい。 AsciiDocは可読性が高く表現力もある程度高いので、技術文書等を書くには最適である。 表現力：HTML > AsciiDoc >
Atom Flight Manual
CompanyEngineeringProductSunsetting AtomWe are archiving Atom and all projects under the Atom organization for an official sunset on December 15, 2022. January 30, 2023 Update: Update to the previous version of Atom before February 2 On December 7, 2022, GitHub detected unauthorized access to a set of repositories used in the planning and development of Atom. After a thorough investigation, we hav
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
https://github.com/asciidoctor/asciidoctor/blob/master/README-jp.adoc
[支える技術]エクセルやパワーポイントのドキュメントを捨てて、超美麗なドキュメント作成をasciidoctorで実現しよう！![[支える技術]エクセルやパワーポイントのドキュメントを捨てて、超美麗なドキュメント作成をasciidoctorで実現しよう！](https://cdn-ak-scissors.b.st-hatena.com/image/square/e45f65486901307445fa766ae58c9833f354eda9/height=288;version=1;width=512/https%3A%2F%2Fprice-checker.jp%2Fwp-content%2Fuploads%2F2015%2F01%2Fpicjumbo.com_HNCK4034.jpg)
CDK — cdk v0.0.8 documentation
GitHub - asciidoctor/asciidoctor-reveal.js: :crystal_ball: A reveal.js converter for Asciidoctor and Asciidoctor.js. Write your slides in AsciiDoc!
Redirect Notice
AsciiDoc の使い方
AsciiDoc チートシート
Githubで書く電子書籍