目的 自習用のメモ用途。お外の人と共有するのは主目的でない。 数学・工学用途のPDFを作りたい PlantUMLなどと親和性の高いツールを使いたい PDFにしたいのは次の理由 オフラインでも参照したい 自習目的の数式は途中の数式は省略しないので長くなりがちで、MathJaxだと表示のたびに、非常に時間を要する。 PDFの埋め込み画像は、PNGだと汚くなるので、SVGを採用したい → 英語(Windows-1252)だけでなく、Unicodeを含む文字も埋め込めるようにする 前提環境/使用ソフトウェア OS: Ubuntu18 ruby 2.5.1p57 asciidoctor: 1.5.8 asciidoctor-mathematical mingwの環境ではビルドできず。仕方なく、UbuntuのVMとした。 インストールが必要だったもの sudo apt-get -qq -y insta
気軽にドキュメントを書くシリーズです。 asciidocで書き、asciidoctor-pdfでさくっとPDFにするというソリューションがあるようなので試行錯誤を繰り返した結果、この.adocをこのPDFに変換できるようになりました。 使い方ではまった箇所をメモしておきます。 インストール# githubのREADMEに書いてある通り、gemでインストールするだけ。 $ gem install --pre asciidoctor-pdf デフォルトのテーマでPDFに変換する# asciidoctor-pdfコマンドを利用します。 $ asciidoctor-pdf basic-example.adoc 自作テーマを利用してPDFに変換する# Asciidoctor PDF Theming Guideに記載されている通り、自分なりのテーマを作ることができます。テーマを自作するにあたっては、デ
【コスト削減約30％以上】AsciiDocとGitHubでPDF、HTMLマニュアルのデータを部署をまたいで一元管理 ヤマハ株式会社様 ヤマハ株式会社グループ 概要 ・設立：1897年10月 ・資本金：285億34百万円 ・従業員数： 連結 20,175人 ・事業内容： 楽器事業、音響機器事業、部品・装置事業 ご利用サービス ・マニュアル作成 ・翻訳 ・AsciidocとGitHubを利用したドキュメント編集＆管理システム構築 導入したマニュアル作成フロー 通常のドキュメントの制作フローで使うシステムやツール類を、各種オープンソースソフトウェア（ATOM/RedPen）やGitHub、SourceTreeなどIT分野に馴染みのあるツール類に代替しました。 各工程のデモ動画 1. テキストエディタATOMでAsciiDocを編集し、GitHubでデータを管理する手順です。 2. AsciiD
シナプスの技術部 システム開発課の蔵坪と申します。 昨年書いた下記の記事の続きになります。 tech.synapse.jp 今回は、Windows上のVisual Studio Codeで、AsciiDocからPDFを生成する手順を紹介したいと思います。 AsciiDocとは AsciiDocとは、メモ、ドキュメンテーション、記事、本、電子ブック、スライドショー、Webページ、マニュアルページ、ブログを書くためのテキスト文書フォーマットです。 試した環境 項目 バージョン 備考 OS Windows 10 Professional (1909) Visual Studio Code 1.43.1 asciidoctor 2.0.10 gem list asciidoctorで確認 asciidoctor-pdf 1.5.3 gem list asciidoctorで確認 AsciiDocか
シナプスの技術部 システム開発課の蔵坪と申します。 弊社は、10年近くソースコードは、Subversionで管理しておりましたが、昨年、GitLabに移行しました。 弊社でお世話になっているパートナーさんから、GitLabはAsciiDocが利用できるので、仕様書などのドキュメントは、AsciiDocがお勧めだとアドバイスをもらいました。そこで、Windows上のVisual Studio CodeでAsciiDocのプレビューできる環境を構築してみました。 AsciiDocとは AsciiDocとは、メモ、ドキュメンテーション、記事、本、電子ブック、スライドショー、Webページ、マニュアルページ、ブログを書くためのテキスト文書フォーマットです。 試した環境 OS : Windows 10 Professional (1809) AsciiDocのプレビューに必要なツール Chocolat
はじめに 流用性・検索性が高いドキュメントの作成は今後のエンジニアに求められるスキルの一つです。 一方で社内ではPowerPointやWordによるドキュメント作成が頻繁に行われる事が多いのではないでしょうか？PowerPointやWordは即時性が高いフォーマットですが、流用性・検索性を確保し続ける事が困難です。 エンジニアが気軽に出版レベルのドキュメントを作成したり、Wikiより管理の容易なナレッジを作成するのに役立つAsciiDocをご紹介するとともに、より柔軟な運用について提案したいと思います。 目次 AsciiDocとはAsciiDocの記述方法AsciiDocを利用すべき理由社内ドキュメントとの共存編集中のAsciiDocをプレビューするにはAsciiDocでHTMLやPDF等を出力するにはAsciiDocとは AsciiDocは軽量マークアップ言語の一つで可読文書記述形式です
Intro こちらの技術書を執筆しました。15Stepで踏破 自然言語処理アプリケーション開発入門 本稿は書籍そのものの紹介ではなく、私が技術書を執筆するために利用した技術・用意した環境についての解説です。 私が執筆を始めた当時（2017年下旬）はWebを漁ってもあまり技術書執筆のノウハウがなく、本稿の内容も割と手探りでした。今ググってみると技術書展のおかげで大量に情報が出てきますね。それらと被る部分もありそうですが、自分が１冊書いてみて得たノウハウみたいなものをここに吐き出してみたいと思います。 執筆フォーマットの決定 まずは執筆に使うツールを決めます。 商業誌の場合、出版社（編集者）がそのフォーマットでの入稿を受け付けてくれるかどうかにも依るため、執筆者の一存で決められないこともあるようです。 私の場合は幸運にも、こちらの希望に合わせてくれる編集者が入ってくれました。 色々調べて↓あた
本来なら「Vagrant で Docker コンテナ立ち上げて Ansible でプロビジョニングして開発環境を用意しよう！」のその3を書くところですが。 今回は脱線して軽量マークアップ言語 AsciiDoc について普及したいと思います！ 結論から言うと こんな感じに書けるよ！ AWSによるクラウド入門 Markdown よりも表現力が豊かだよ！ Git 並に覚えるのは大変だよ！ 軽量マークアップ言語とは？ Wikipedia によると、軽量マークアップ言語とは次の通り。 軽量マークアップ言語（けいりょうマークアップげんご、英語: lightweight markup language）は、人間がシンプルなテキストエディタを使っての入力が容易になるように設計された、簡潔な文法をもつマークアップ言語である。 引用：『フリー百科事典 ウィキペディア日本語版』より。 エンジニア界隈で有名どころ
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
