Stumpwmのソースを表示

[[Category:タイル型ウィンドウマネージャ]]
[[en:Stumpwm]]
StumpWM は全てが Common Lisp で書かれた、タイル型のフルスクリーンウィンドウマネージャです。カルト的な人気がある [[Ratpoison]] ウィンドウマネージャの後継として ("GNU Screen to the power of X")、StumpWM には common lisp の完全な柔軟性・ハッカビリティがあり、たとえ動作中であってもウィンドウマネージャのソースを変更することが可能です。

[http://www.nongnu.org/stumpwm/ StumpWM のホームページ] より:

:''チャンネルを変えるようにテーマを変えるのに、また、たった一つのことを除いて完璧なウィンドウマネージャからどこか他のところが壊れているウィンドウマネージャに移るのに飽いてしまった場合、Stumpwm がお役に立てるかもしれません。''
:''Stumpwm はカスタマイズを可能にしながら視覚的に最小限度を保つことを目標としています。ウィンドウ装飾や、アイコン、ボタンは存在しません。Stumpwm には個人カスタマイズを加えるための様々なフック、設定変数があります。''

実際に動作しているところを見たいですか？StumpWM ユーザーが[http://www.archive.org/details/TheStumpWMExperience 動画] を作成しています。

== インストール ==

=== SBCL を使う (推奨、高速) ===

==== Quicklisp を使う (推奨) ====

{{Warning|root だけを使って SBCL をインストールしてください、必要であれば、"make install" を実行してください。}}

# SBCL をインストール
#* {{Ic|pacman -S sbcl}}
# [http://beta.quicklisp.org Quicklisp ウェブサイト] で Quicklisp を入手
#* {{Ic|curl -O http://beta.quicklisp.org/quicklisp.lisp}}
# SBCL で Quicklisp をロード
#* {{Ic|sbcl --load quicklisp.lisp}}
# Quicklisp をインストール
#* {{Ic|(quicklisp-quickstart:install)}} or {{Ic|(quicklisp-quickstart:install :path "path/of/your/choice")}}
# Quicklisp を SBCL init ファイルに追加
#* {{Ic|(ql:add-to-init-file)}}
# Quicklisp のアップデートを確認 (ダウンロードしたばかりなら必要ありません)
#* {{Ic|(ql:update-client)}}
# Quicklisp 上のアップデートを確認
#* {{Ic|(ql:update-all-dists)}}
# CLX と CL-PPCRE をインストール
#* {{Ic|(ql:quickload "clx")}}
#* {{Ic|(ql:quickload "cl-ppcre")}}
# (quit) で SBCL を終了
# StumpWM の git バージョンを入手
#* {{Ic|git clone https://github.com/stumpwm/stumpwm.git}}
# stumpwm フォルダに入れてコンパイルを開始
#* {{Ic|cd stumpwm && ./autogen.sh && ./configure && make}}
#* "Component STUMPWM not found" というエラーが発生する場合は次を試して下さい:
#* {{Ic|1=env CL_SOURCE_REGISTRY=$PWD: sbcl --load make-image.lisp}}
# 任意で root で "make install" を実行できます。
#* "Don't know how to REQUIRE STUMPWM" というエラーが発生する場合は次を試して下さい:
#* {{Ic|1=env CL_SOURCE_REGISTRY=$PWD: make install}}
# StumpWM バイナリのパスを .xinit に記述してお楽しみ下さい！ :)

''任意: ''リアルタイムハッキング''のための slime/swank をインストール:
# swank server をインストール
#* {{Ic|(ql:quickload "swank")}}
# slime-helper をインストール
#* {{Ic|(ql:quickload "quicklisp-slime-helper")}}
# 以下を dot-emacs に貼り付け
#* {{Ic|(load (expand-file-name "/path/to/slime-helper.el"))}}
#* {{Ic|(setq inferior-lisp-program "sbcl")}}
# 以下を .stumpwmrc に記述、または stumpwm-session で eval
#* {{Ic|(require 'swank)}}
#* {{Ic|(swank:create-server)}}
# 次のコマンドで Emacs/Slime を stumpwm-session に接続
#* {{Ic| M-x slime-connect}}

==== AUR を使う ====
# SBCL をインストール
#* {{Ic|pacman -S sbcl}}
# AUR から {{AUR|clx}}{{Broken package link|{{aur-mirror|clx}}}} をインストール
#* この PKGBUILD を使いたくない場合は、asdf-install を使って clx をインストールすることもできます。
# {{AUR|cl-ppcre}} をインストール
#* 同じく、PKGBUILD を使いたくない場合は、asdf-install でインストールできます。
# git をインストール
#* {{Ic|pacman -S git}}
# AUR から {{AUR|stumpwm-git}} をインストール
#* または、[http://www.nongnu.org/stumpwm/ ホームページ] にあるように、git リポジトリから直接チェックアウトすることもできます。StumpWM wiki を読んでコンパイルしてください。

=== Clisp を使う ===

# makepkg のインストールの依存関係を満たすように以下の順番でパッケージを AUR から入手・作成 (makepkg -s):
#* {{AUR|clisp-new-clx}}
#* {{AUR|cl-asdf}}{{Broken package link|{{aur-mirror|cl-asdf}}}}
#* {{AUR|cl-ppcre}}.  To get this to install, I had to comment out the dependency line in the PKGBUILD.
#* {{AUR|stumpwm-git}}。または最新のバージョンをウェブサイトからダウンロードしてインストールの指示に従って下さい。実行可能ファイルは home ディレクトリツリーに置くことができます。
# それぞれのパッケージを順番通りにインストール (sudo pacman -U name.pkg.tar.gz)。
# AUR からダウンロード・インストールする方法の詳細は [[Makepkg|Makepkg]] を参照 (パッケージのコンパイル・作成とインストール)。

また、問題が発生した場合は[https://bbs.archlinux.org/viewtopic.php?pid=543537#p543537 この投稿]も見て下さい。

== ドキュメントとサポート ==

手動で StumpWM をインストールしてソースに手を入れられてない場合、TeXInfo マニュアルがあります。

その他に [https://github.com/sabetts/stumpwm/wiki wiki], Freenode の IRC チャンネル
(#stumpwm), メーリングリストも存在します。もちろん、[http://www.nongnu.org/stumpwm/ プロジェクトのウェブサイト] も参照してください。

== 設定 ==

.stumpwmrc の様々な便利な設定が wiki に載っています。

あなたが emacs ユーザーであるならば、StumpWM ソースの contrib/ ディレクトリに StumpWM ファイル編集用の emacs マイナーモードがあります ({{Ic|stumpish}} プログラムのインターフェイスにもなります、詳しくは下記参照)。clisp を使っている場合、このファイルは {{Ic|/usr/share/stumpwm/}} にもあります。

{{Ic|stumpish}} は STUMP ウィンドウマネージャインタラクティブシェルです。ターミナルから (もしくは emacs モードを使って) 楽に、実行中の StumpWM と対話することができるプログラムになります。StumpWM ソースの contrib/ ディレクトリに存在します。clisp を使っている場合、このファイルは {{Ic|/usr/bin/}} にもあります。

== トラブルシューティング ==
* マルチモニターの設定で問題が起こる場合は、おそらく 'xorg-xdpyinfo' パッケージをインストールする必要があります。

* stumpwm を起動できず、以下が出力される場合:
            debugger invoked on a SB-INT:SIMPLE-PARSE-ERROR in thread
        #:
        no non-whitespace characters in string "".
        Type HELP for debugger help, or (SB-EXT:QUIT) to exit from SBCL.
        (no restarts: If you did not do this on purpose, please report it as a bug.)
        (PARSE-INTEGER "" :START 0 :END NIL :RADIX 10 :JUNK-ALLOWED NIL)

REPL では、ホームディレクトリの .Xauthority を削除することで解決できます。[https://github.com/sabetts/stumpwm/issues/1 github の issue] も参照してください。