私のチームで行っているドキュメント管理方法の紹介(GitHub Actions, S3, AsciiDoc) | DevelopersIO
ドキュメントツールのインストール(Windows) Macの場合の設定方法は、本項の後に記載 PowerShellの起動 各種ツールをインストールするため、PowerShellを管理者として実行 Windowsボタンを押下 powershell と入力 右クリックで管理者として実行 を選択します Chocolateyのインストール 本手順は前述で起動したPowerShellを利用 1.Chocolatey のサイトにアクセスし、インストールコマンドをクリップボードへコピー 2.前項でコピーしたコマンドをPowerShellにペーストして実行します Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServiceP
概要 CC BY 3.0ライセンス（Attribution 3.0 Unported）に基づいて翻訳・公開いたします。 英語記事: toptal/active-job-style-guide: This Background Jobs style guide is a list of best practices working with Ruby background jobs. 原文更新日: 2020/07/17 著者: Phil Pirozhkovほか 本スタイルガイドは、バックエンドにSidekiqを用いたActive JobでRubyバックグランドジョブを扱うときのベストプラクティスを一覧できるようにしたものです。 一般に思われているのと異なり、このガイドラインに沿うことでかなりうまくやれるようになります。 SidekiqはActive Jobなしでも使えますが、Active J
マニュアルや操作説明書など、改版を繰り返す文書や、共同で執筆する文書などは、バージョン管理システムにより、最新版や改版履歴の管理が必要です。 Wordなどで作成されることが多いと思いますが、バージョン管理システムとの親和性やテキストデータの流用性、検索性に優れた軽量マークアップ言語の AsciiDoc を紹介します。 ここで紹介する AsciiDoc は、PDF形式の出力を前提に、Asciidoctor, Asciidoctor-pdf について説明します。 この文書も、AsciiDocで記述し、Git(バージョン管理システム)で修正履歴を管理しています。
こんにちは、デジタルペンテスト部のねいちゃーどです。 普段は チート対策ペネトレーションテストサービス の診断員として、主にゲームに関わるサービスの脆弱性診断を担当しています。 私たちのチームでは、お引き受けさせていただいた案件に対する成果物として「報告書」を作成・提出しています。 報告書には「発見した脆弱性についての詳細なレポート」などが記載されています。 端的に還元すれば「報告書を作成するのが本業」と言っても過言ではありません。 その報告書の作成には以前まで Microsoft Word (以下、Word) を用いていました。 しかし Word を用いた報告書作成には、以下の問題がありました。 共同編集機能を用いた際に、編集内容が競合することがある その結果、同ファイルをリネームして上げ直さないといけなくなったり、代表者がローカルに落として編集した事例が過去にあった 「【最新版】打ち合
Windows上のVisual Studio Codeで、AsciiDocのプレビュー環境の構築 - シナプス技術者ブログ
シナプスの技術部 システム開発課の蔵坪と申します。 弊社は、10年近くソースコードは、Subversionで管理しておりましたが、昨年、GitLabに移行しました。 弊社でお世話になっているパートナーさんから、GitLabはAsciiDocが利用できるので、仕様書などのドキュメントは、AsciiDocがお勧めだとアドバイスをもらいました。そこで、Windows上のVisual Studio CodeでAsciiDocのプレビューできる環境を構築してみました。 AsciiDocとは AsciiDocとは、メモ、ドキュメンテーション、記事、本、電子ブック、スライドショー、Webページ、マニュアルページ、ブログを書くためのテキスト文書フォーマットです。 試した環境 OS : Windows 10 Professional (1809) AsciiDocのプレビューに必要なツール Chocolat
Ruby for ebook publishing
A lot of times, people ask what’s Ruby good for apart from Rails. Ruby is great for various tasks from several different domains, and today, I would like to share how anybody can use Ruby in publishing ebooks. Since I used some Ruby tasks in publishing my first-ever ebook Deployment from Scratch, it crossed my mind to write down why I think Ruby is great for publishing ebooks. PDF publishing There
はじめに 2019_09_Asciidocを使っていてせっかくAsciidoctor-PDF環境を構築したのに出力したPDFの日本語が表示されなくて困っている人へ で困っていた人になって動いている環境をそーっとしておいたのですが、再度調べたら本家が対応してくれていたのがわかったので書いておきます。 さきに結論（いままで使っていた方向け） -r asciidoctor-pdf-cjk に代わって -a scripts=cjk を使います。 asciidoctor-pdf-cjk はメンテナンス終了なので利用を止めたほうがよいです。asciidoctor-pdf 1.6.0で使うと以下のようにエラーが出ます。
Asciidocで技術文章を作成する - Qiita
はじめに Asciidocは、Markdownとほとんど同じような記述法でお手軽にかけて、規模の大きい文章を書くことにも適しています。 例えば、Pro Gitは、日本語版PDFで500ページを超えるGitの解説書ですがAsciidocで書かれています。 ソフトウェアの設計書など、そこそこの規模になる技術文章を記述するのにAsciidocが良いと思い導入してみました。 参考にしたページの紹介と、実際に使ってみて、感じた利点などを紹介します。 参考 以下のリンクのComparison by exampleにMarkdownの記法と比較して、どう書くかが記載されているので参考になります。 AsciiDoc vs Markdown, asciidoctor docs 少し分量が多いですが、日本語化されたリファレンスもあります。 Asciidoctor 文法クイックリファレンス(日本語訳) とりあえ
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か
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Rails: Active Jobスタイルガイド（翻訳）｜TechRacho by BPS株式会社
AsciiDoc文書作成入門:: Asciidocによる文書作成環境の構築 [AFFRIT Portal]
AsciiDoc で「イイ感じ」な文書を作る - ラック・セキュリティごった煮ブログ
asciidoctor-pdfで日本語を含むPDFの出力を行う - Qiita
WSL2上のDockerを用いてAsciidocの文書，スライドを書く - 粗大メモ置き場