指令大接龍!!!!

[moto]

函數？！

基本上這邊是指系統管理上的指令喔，並未深入到程式設計，所以我想原則上是不會有這樣的部分..

[kanru]

Gtk , Qt , Tk 等等還有其他的函式庫通常都會有完整清楚的手冊可以查閱，不妨先到官方網站上找找。

[幸福的形狀]

那何時這個版面才會出爐阿...我好期待蔫..
剛從rh跳過來...
既興奮又期待

[訪客]

嗨，萬用止痛書(aka 無痛起步法)下方有一章節為 Unix Tools -- 一般 Unix 系統中常見的工具，歡迎請開始填空

至於 Debian 相關的則寫在 DebianSystemManagement -- Debian 軟體管理深入淺出，其實還有 ifupdown 等工具。待頁面持續整理

http://wiki.debian.org.tw/ThePainLessBook

[訪客]

訪客再說:
基本上，內容是 3W - What、Why、hoW

What - 指令名稱、包含於何種軟體，簡要功能說明。
Why - 為甚麼使用這種工具來使用何種功能或解決何種問題
hoW - 如何使用。

範例: http://wiki.debian.org.tw/index.php?page=procps

建議每個指令以分裝的計畫名稱來區別。例如 ps 屬於 procps，但 procps 又包含 /sbin/sysctl、/bin/kill、/bin/ps、/usr/bin/uptime、/usr/bin/tload、/usr/bin/free、/usr/bin/top、/usr/bin/vmstat、/usr/bin/watch、/usr/bin/skill、/usr/bin/pmap、/usr/bin/pgrep、/usr/bin/w.procps、/usr/bin/pkill、/usr/bin/snice 等。以計畫作為分類，各項指令才不至於混亂。例如以 rlogin 而言，實作的就有 netkit (rsh-client) 以及 Rsh-redone(rsh-redone-client)，實作不同，用法便略有差異，這是需要特別注意的。

[訪客]

BTW, 目前絕大部份的文字都是 Tetralet 的傑作唷！

此外，如果有人願意撰寫 APIs 的函式，我想 WikiWiki 也是很好發揮的場所。積少成多。在夜深人靜，逐一試驗每個函式的用途時，可以將心得及範例留下。決大部份的 man pages 或 info pages 只介紹參數及語法，甚少有範例演示。

但是名稱的取法恐怕要特別注意，或許該以不同的分類整理之，例如
php4/apache_setenv

[訪客]

接下來討論範例的設計，原則上範例以愈明顯易懂愈佳。簡而言之，就是 KISS。Keep It Simple Stupid。

每個指令的範例著重於該指令的基本用法與用途，因此盡可能不與其他指令相搭配較妥。

而範例的例子應該以實際示範較易懂。目前的 wiki 頁面中許多範例像是

代碼: 選擇全部

cat FileName


對於生手，許多虛設參數反而另人困惑，照打指令卻出現

代碼: 選擇全部

cat: FileName: No such file or directory


或許可改以類似

代碼: 選擇全部

cat /etc/passwd


等範例，生手只需照打，而不至於出現錯誤訊息，還傻呼呼來問，為甚麼會有錯誤訊息。此外，範例中如果要讀取特定系統檔案或使用特定指令，應該以 base system 存在的檔案或程式為標的，盡量不使用生手可能未安裝的軟體。範例說明應詳細敘述目前假設的環境為何。(如 IP, gateway 等參數)

預設使用的 shell 應以普遍使用的 "bash" 為基本。範例中如果使用 shell script，應明確指明使用的 shell 名稱。避免使用 #!/bin/sh ，由於某些系統可能將 /bin/sh 以其他如 csh/tcsh 取代。

代碼: 選擇全部

#!/bin/bash
echo "Hello World"


系統 locale 應該設置為 "C"，標準語系，而不以簡體或繁體中文。避免因為翻譯上的誤差造成疑惑。

代碼: 選擇全部

LC_ALL=C


範例中，如無必要使用 root，便盡量少用。如 apt-cache serach 便無須 root 權限。

代碼: 選擇全部

apt-cache search apt


為顯示目前使用的帳號與權限，必須指定 shell prompt 以明顯區分差別。應該以統一的 hostname 與 username 為標準。
如標準用戶

代碼: 選擇全部

user@debian:~$ PS1='user@debian:\w\$ '
user@debian:~$ cd /tmp
user@debian:/tmp$ pwd
/tmp
user@debian:/tmp$


超級用戶(root)

代碼: 選擇全部

debian:~# export PS1='debian:\w\$ '
debian:~# cd /etc
debian:/etc# pwd
/etc
debian:/etc#


範例中如果有特殊名詞，如 loopback、root ，則以新頁面說明。

範例必須以 <code></code> 函括。

[moto]

推~~~ 訪客兄說的真好.... 照這樣的架構統一起來，我想對於剛接觸的朋友一定幫助很大..

[lss888]

期待中

[cfw8521]

請問這計畫的網頁在那呢?@@

[zhang10369]

不錯的想法．
我是新手.支持各位大大！！！！

[tea]

幾年前
對岸大陸有個中文 manual page 計劃 (CMPP, 但是官網http://cmpp.linuxforum.net/ 已經掛掉一年多了)
將所有指令都翻譯成中文

目前有人接續其成果就是 manpages-zh
官網在 http://code.google.com/p/manpages-zh/

在 ubuntu 下
如果安裝了manpages-zh 套件
那在 Gnome 終端機中 使用 man 指令
就能得到中文的指令說明
不過指令的範例倒是沒有
因為原文中就是沒有