考えを整理しながらドキュメントを書くのにMarkdownが便利ですが、資料を印刷して持ってきてとか言われると困ったりします。 そんな時にPandocを使ってdocxなどの形式に変換して印刷すると便利です。(PDFにも出来ますが、フォントサイズなどの微調整も出来るのでdocxにすることが多いです) pandocは、Haskell製のドキュメント変換ツールです。 対応している形式などは以下を参照してください。 Pandoc - About pandoc インストール インストールは以下を参考にしてください。PDFへ変換するには別途依存するライブラリを入れる必要があります。 http://johnmacfarlane.net/pandoc/installing.html MacとWindows向けにはインストーラが提供されているので、それを使ってインストールすると楽です。 Releases ·
この記事は、著者の許可を得て配信しています。 Why programmers don’t write documentation 最近ではずっとコードのドキュメンテーションに関連した記事を書いていたので、当然、私のMediumのおすすめ記事には「開発者がドキュメントを書かない本当の理由」という記事が表示されるようになりました。この記事では、ドキュメントを書くための優れたツールがないことが、ソフトウェアエンジニアが自分の作業や判断をドキュメンテーションする意欲を失わせる最大の原因について書いています。 私は普段、特定の記事を批判したりはしませんが、この記事には怒りを覚えました。このライターは図解ツールについていくつかメリットに関して述べてはいますが、全体的に誤解を招くような内容になっており、この重要な問題をより分かりにくくさせています。2つの図解ツールを比較して、どちらも不十分なツールである
VSCode拡張機能 Draw.io Integration導入方法 先人の方がまとめて下さってます。⇒ VSCodeでDraw.ioが使えるようになったらしい! Draw.ioでsvg形式のファイルを作成する 拡張子を.drawio.svgまたは.dio.svgにしてファイル作成すると、Draw.ioに関連付けられ、svg形式のファイルを作画&作成できます。 mdファイルにsvgを埋め込む mdファイルに以下のように作成した画像(.drawio.svg)を埋め込むことができます。 マークダウン構文![](ファイルパス)またはimgタグで記述します。 mdファイルの編集画面からDraw.io画面を開ければ... マークダウン構文で記載した場合、画像ファイルを cmd + クリック で開くことはできますが... 残念ながら、テキストエディタが開いてsvgのソースが表示されます。 Draw.i
追記 versionによっては設定を変えないとエクスポートができないようです。 エクスポートできない方はこちらの記事をご参考に設定いただくとエクスポートできるかもしれません。 現状バージョン0.4ではこちらの設定が必要となります。 VSCodeでDraw.io Integration使用時にエクスポートできないことがある問題への対処 2020/10/18追記 現在のバージョン0.7ではdrawio拡張子のエクスポートがうまくいかないようです。 その場合はオフラインモードに移行変更していただくか、drawio.pngやdrawio.svg拡張子でファイルを作成してもらうことで直接編集もできた上で、エクスポートとせず末尾の拡張子ファイルとして利用することができます。 はじめに VSCodeで簡単にDraw.ioで描画できるようになったみたいなので、 導入方法と使い方を備忘として残していきます。
SVGファイルのカンタンな編集方法についてです。 www.4g15maimai.com www.4g15maimai.com 背景が透過されていないSVGに注意 【GTSPORT】グランツーリスモSPORTのリバリーエディターで使える!SVGファイルをDLできるサイトと注意点! - 劇的カーライフ worldvectorlogo.com Worldvectorlogoや、その他サイトで配布されているSVGファイルは、背景が透過されていないものが偶にあります。 透過されていないとどうなるか? 上のCastrolロゴが背景が透過されているもの、下のHONDAロゴが背景が透過されていないものです。 背景が透過されていないSVGをアップロードして、リバリーエディターで貼り付けると…こうなります。 HONDAの文字だけ貼りたいのに、背景の白い部分が邪魔。とても残念な気持ちに…。 透過処理されているC
ここでは USB メモリに角藤亮先生の W32TeX(x86) や,TeX 文書作成に関連するソフトをインストールして,ポータブルな TeX 組版環境を構築する方法を紹介します. 高専生が生まれる前から連綿と使われている TeX も,様々な改良・拡張が加えられて進化しています. 最初期から使われてきた (p)LaTeX や upLaTeX を「レガシー TeX」,より新しい XeLaTeX や LuaLaTeX を「モダン TeX」と呼び分けるようになりつつあるようです. レガシー TeX は,ページ内の文字の配置を定める組版処理では文字を囲む箱の寸法情報を使い,字形情報は含まない DVI (DeVice Indepent) 形式のファイルを出力します. そして,画面表示 (プレビュー) やプリンタへの印刷を行う段階で,実際の字形情報を描き込みます. このようにすることで,現代の技術水準か
背景 Word ファイルにおいて,特定の章に記載されているテーブルの内容を読み取りたいシチュエーションは良くあるかと思います. 例えば次のような表が複数含まれる文書において,「そして」という章に含まれる表のみを読み取る場合です. これを実現するのが次のスクリプトです. スクリプト #!/usr/bin/env ruby # -*- coding: utf-8 -*- Encoding.default_internal = "utf-8" Encoding.default_external = "utf-8" require 'win32ole' require 'pp' def get_pos_map(doc, style_name) pos_map = {} doc.Paragraphs.each do |para| next if (para.Range.Style.NameLocal
前回公開したエントリ「開発者向けのソフトウェア設計書は必要か? - 勘と経験と読経」へのフィードバックで、保守には設計書が必要なのではないか、というものがあった。その点については思うことがある。というわけで、保守という観点でソフトウェア設計書に関する考えをまとめてみた。ソフトウェア構築時に必要とされる設計書と、保守の際に必要とされるものは異なるのではないかと考えている。 議論の前提:仕様書と設計書 再掲になるけれども、ここでは仕様書と設計書という用語を以下のように定義する。 仕様書 … 開発者とユーザー(仕様決定者)が、ソフトウェアの振る舞いや動きに関してコミュニケーションするために必要な文書類のこと。 設計書 … 開発者どうしがソフトウェアを作成するにあたっての、構造や仕様についてコミュニケーションするために必要な文書類のこと。 そして、改めて説明する必要は無いと思うけれども仕様書は保守
2016年 7月1日 16時55分 7年前 node.jsでmarkdownからPDFに変換するライブラリ「markdown-pdf」の紹介です。 Markdownでドキュメントを書くのはスイスイ書けて Webページではパース出来ますが、問題は作成したドキュメントファイルを配布する時じゃないでしょうか。 " Markdownで作成したドキュメントをそのままエンドユーザーに送る "と考えると、難しい部分があり 配布先にプレビュー出来る環境を用意してもらう必要がでてきます。 そのような手間を省いてもらう為に、" markdown-pdf "を使って、MarkdownからPDFに変換しましょう! markdown-pdfはnode.js用のライブラリなので、npmコマンドを使ってインストールします。 # markdown-pdfのインストールコマンド npm install markdown-p
利用事例としては Pythonのドキュメント があります。そもそもSphinxは、もともとはPythonのドキュメントを書くために作られたそうです。 拙著「入門Redmine」の執筆は、第3版以降はWordからSphinxに切り替えました。作業のしやすさやツールの扱いやすさにより、効率向上やモチベーション維持に効果があったと感じています。 Sphinxの便利な点 テキスト形式で記述できる Sphinxで最も便利に感じているのは、reST(reStructuredText)と呼ばれるテキストファイルで原稿を書けることです。テキスト形式ですのでMercurialやGitなどのバージョン管理システムでの更新履歴がやりやすいです。自分が普段使っている、手慣れたテキストエディタで書けるのもうれしいです。 grepやsed などのコマンドラインのテキスト処理用のツールが利用できるのも便利です。例えば用
A fast text processor & publishing toolchain for converting AsciiDoc to HTML5, DocBook & more. = Hello, AsciiDoc! Doc Writer <doc@example.com> An introduction to http://asciidoc.org[AsciiDoc]. == First Section * item 1 * item 2 [source,ruby] puts "Hello, World!" Asciidoctor is a fast, open source, Ruby-based text processor for parsing AsciiDoc® into a document model and converting it to output for
2015年11月17日, Visual Studio Code はベータ版に昇格した。以下の記事内容は既に古いものなのでご注意を。 Announcing Visual Studio Code Beta - Visual Studio Code - Site Home - MSDN Blogs [速報]無償のコードエディタ「Visual Studio Code」が、Go言語/Pascal/Reactなどに対応。ベータ版にも到達。Microsoft Connect(); 2015 - Publickey [速報]オープンソース版.NETがリリース候補版に到達。Windows、MacOS X、Linuxで同一の.NETアプリが実行可能に。Microsoft Connect(); 2015 - Publickey Microsoft から Visual Studio Code の preview
Markdown記法のチートシートです。 記法はGitHub Flavored Markdownに準拠し、一部拡張しています。 Qiitaでシンタックスハイライト可能な言語一覧については、 シンタックスハイライト可能な言語 をご覧下さい。 Code - コードの挿入 Code blocks - コードブロック たとえば、「Ruby」で記述したコードをファイル名「qiita.rb」として投稿したいときは、 バッククオート(`) か チルダ(~) を使用して以下のように投稿するとシンタックスハイライトが適用されます。 コードブロック内でコードブロックを書きたい場合は異なる記号を使うことで書けます。
Markdownで書く電子書籍開発環境 #niku_sushi 自己紹介 Name : azu Twitter : @azu_re Website: Web scratch, JSer.info JavaScript Plugin Architecture JavaScript Plugin Architecture 電子書籍の開発中にやったこと やりたかったこと [Markdown] 電子書籍開発環境 · Issue #42 Markdown/文章のLint インラインコードのLint ファイルのincludeするMarkdown拡張 Markdown to HTML or PDF エディタ [Markdown] 電子書籍開発環境 · Issue #42 Markdown/文章のLint => textlint インラインコードのLint => ESLint ファイルのincludeする
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く