Kiyoshi Sakata sankitch

name

japanese-tech-writing

description

日本語の技術文書・書籍原稿の文章規範。整形（一文一行、引用ブロック、脚注、コラム記法）、段落と論証の構成（パラグラフライティング）、論証の厳密さ（ツッコミどころの除去）、読み手の負荷の管理、視点と語り、演出の抑制、LLM っぽい空句の禁止、冗長の排除を定める。日本語で技術書の章、草稿、記事、解説文を書くとき、または推敲・リライトするときに使用する。

日本語技術文書の文章規範

日本語で技術的な原稿（書籍の章、記事、解説文）を書く・推敲するときは、以下の規範に従う。

整形

MQTT コトハジメ

更新:	2014-05-14
バージョン:	0.0.12
作者:	@voluntas
URL:	http://voluntas.github.io/

とても詳しいまとめがありますので、ますはそちらを見ることをオススメします。

時雨堂コトハジメ

更新:	2026-08-01
作者:	@voluntas
バージョン:	2026.2
URL:	https://voluntas.github.io/

typo などは https://x.com/voluntas までご連絡ください。

時雨道場

日時:	2014-06-15
作:	時雨堂
バージョン:	1.0.4
url:	http://shiguredo.jp/

時雨堂を支える技術

時雨堂を支える技術

日時:	2025-05-13
作:	時雨堂
バージョン:	2025.3
URL:	https://shiguredo.jp/

言語

rbenvとruby-buildでRuby環境を最新に保つ

更新日:2014/11/19

rbenv, ruby-buildを更新

$ cd ~/.rbenv
$ git pull origin master
$ cd ~/.rbenv/plugins/ruby-build
$ git pull origin master

	require 'capistrano/git'

	class Capistrano::Git
	module SubDirectoryStrategy
	include DefaultStrategy

	def release
	git :archive, fetch(:branch), fetch(:project_root), '\| tar -x -C', release_path, "--strip=#{fetch(:project_root).count('/')+1}"
	end
	end

	#
	# Sample nginx.conf optimized for EC2 c1.medium to xlarge instances.
	# Also look at the haproxy.conf file for how the backend is balanced.
	#

	user "nginx" "nginx";
	worker_processes 10;

	error_log /var/log/nginx_error.log info;

	#
	# Show branch name in Zsh's right prompt
	#

	autoload -Uz VCS_INFO_get_data_git; VCS_INFO_get_data_git 2> /dev/null

	setopt prompt_subst

	function rprompt-git-current-branch {
	local name st color gitdir action