update.
[fsij-homepage-html.git] / feeds / system.atom.xml
1 <?xml version="1.0" encoding="utf-8"?>
2 <feed xmlns="http://www.w3.org/2005/Atom"><title>Free Software Initiative of Japan</title><link href="http://www.fsij.org/" rel="alternate"></link><link href="http://www.fsij.org/feeds/system.atom.xml" rel="self"></link><id>http://www.fsij.org/</id><updated>2014-05-29T00:00:00+09:00</updated><entry><title>FSIJサイトでの pelican の使い方について</title><link href="http://www.fsij.org/system/web-services/pelican-usage-fsij.html" rel="alternate"></link><updated>2014-05-29T00:00:00+09:00</updated><author><name>webmaster@fsij.org</name></author><id>tag:www.fsij.org,2014-05-29:system/web-services/pelican-usage-fsij.html</id><summary type="html">&lt;p&gt;本サイトのソースにおける pelican の使い方について説明します。&lt;/p&gt;
3 &lt;div class="section" id="id1"&gt;
4 &lt;h2&gt;ディレクトリ構成&lt;/h2&gt;
5 &lt;p&gt;「固定のページ」と「記事」の二種類があります。
6 「固定のページ」は左のメニューにリストされます。
7 「記事」は新しい順に列挙されます。&lt;/p&gt;
8 &lt;pre class="literal-block"&gt;
9 content/
10        extra/ ページや記事以外のものの置き場所
11        images/ 画像の置き場所
12        static/ ファイルなどの置き場所
13
14        pages/ 固定のページ
15        pages/gnuk/ 固定のページで Gnuk のカテゴリ
16        pages/monthly-meetings/ 固定のページで月例会のカテゴリ
17        pages/news/ 固定のページ、 News
18        pages/system/ 固定のページ、システム関連
19        gnuk/ Gnukの記事
20        monthly-meetings/ 月例会の記事
21        news/ News の記事
22        system/ システム関連の記事
23
24 plugins/ プラグインで pelican の動作を拡張
25 theme/ CSS と Jinga2 の template で見栄えを変更できます
26
27 output/ &amp;lt;---- HTML の出力先
28 &lt;/pre&gt;
29 &lt;/div&gt;
30 &lt;div class="section" id="timestamp"&gt;
31 &lt;h2&gt;timestampに注意&lt;/h2&gt;
32 &lt;p&gt;timestampは保持される情報ではない、ということに注意する。&lt;/p&gt;
33 &lt;p&gt;Gitを使う場合はファイルのtimestampのメタ情報はリポジトリ内にデータとして記録されず、
34 操作をした結果としてローカルなファイルシステムでtimestampが変わる。
35 異なる場所でGitから取得して操作する場合、それらのtimestampは同じわけではない。&lt;/p&gt;
36 &lt;p&gt;また、staticなHTMLを生成するという運用では、生成した時点のtimestampがつく。&lt;/p&gt;
37 &lt;p&gt;timestampに依拠した運用はしない。timestampは気にしない、ということを覚えておく。&lt;/p&gt;
38 &lt;p&gt;ファイルの履歴を追うのは Git の履歴で確認します。&lt;/p&gt;
39 &lt;/div&gt;
40 </summary></entry><entry><title>このサイトについて</title><link href="http://www.fsij.org/system/site-colophon.html" rel="alternate"></link><updated>2014-05-26T00:00:00+09:00</updated><author><name>webmaster@fsij.org</name></author><id>tag:www.fsij.org,2014-05-26:system/site-colophon.html</id><summary type="html">&lt;p&gt;このサイトで利用しているソフトウェアやその使い方に関して、ここに記します。
41 本サイトの運営/保守に資するとともに、同様のサイトでの利用に役立てばと思います。&lt;/p&gt;
42 &lt;div class="section" id="id2"&gt;
43 &lt;h2&gt;このサイトで利用しているソフトウェア&lt;/h2&gt;
44 &lt;div class="section" id="web-server"&gt;
45 &lt;h3&gt;Web server&lt;/h3&gt;
46 &lt;p&gt;Apache 2.2 を使っています。&lt;/p&gt;
47 &lt;/div&gt;
48 &lt;div class="section" id="pelican-python"&gt;
49 &lt;h3&gt;Pelican &amp;amp; Python&lt;/h3&gt;
50 &lt;p&gt;Static Site Generator の &lt;a class="reference external" href="http://getpelican.com/"&gt;Pelican&lt;/a&gt; というソフトウェアを使っています。
51 &lt;a class="reference external" href="http://python.org/"&gt;Python&lt;/a&gt; で書かれています。&lt;/p&gt;
52 &lt;/div&gt;
53 &lt;/div&gt;
54 &lt;div class="section" id="source-code"&gt;
55 &lt;h2&gt;Source code&lt;/h2&gt;
56 &lt;p&gt;このサイトは Git でリポジトリを管理しています。こちら: &lt;a class="reference external" href="http://git.fsij.org/"&gt;http://git.fsij.org/&lt;/a&gt;&lt;/p&gt;
57 &lt;/div&gt;
58 </summary></entry><entry><title>FSIJ の WWW を自分のマシンで動かす</title><link href="http://www.fsij.org/system/web-services/run-fsij-web-on-your-machine.html" rel="alternate"></link><updated>2014-05-26T00:00:00+09:00</updated><author><name>webmaster@fsij.org</name></author><id>tag:www.fsij.org,2014-05-26:system/web-services/run-fsij-web-on-your-machine.html</id><summary type="html">&lt;!-- author gniibe --&gt;
59 &lt;div class="section" id="git"&gt;
60 &lt;h2&gt;Git のリポジトリから取ってくる&lt;/h2&gt;
61 &lt;p&gt;このサービスのソースコードは FSIJ の Git リポジトリに入っています。
62 ここから、下記のようにして取ってきます。&lt;/p&gt;
63 &lt;pre class="literal-block"&gt;
64 $ git clone git://git.fsij.org/fsij-homepage.git
65 $ cd fsij-homepage
66 &lt;/pre&gt;
67 &lt;p&gt;もしくは SSH の鍵が登録してあれば、下記のようにします。&lt;/p&gt;
68 &lt;pre class="literal-block"&gt;
69 $ git clone git-fsij&amp;#64;git.fsij.org:fsij-homepage.git
70 $ cd fsij-homepage
71 &lt;/pre&gt;
72 &lt;/div&gt;
73 &lt;div class="section" id="id1"&gt;
74 &lt;h2&gt;必要なパッケージをインストールする&lt;/h2&gt;
75 &lt;p&gt;python-pelican, python-docutils および python-jinja2 が必要です。
76 Debian Jessie で利用可能です。&lt;/p&gt;
77 &lt;pre class="literal-block"&gt;
78 # apt-get install python-pelican python-docutils python-jinja2
79 &lt;/pre&gt;
80 &lt;/div&gt;
81 &lt;div class="section" id="id2"&gt;
82 &lt;h2&gt;ページの保守&lt;/h2&gt;
83 &lt;p&gt;このページや月例会案内など、ReST (ReStructured Text)で書いています。&lt;/p&gt;
84 &lt;/div&gt;
85 &lt;div class="section" id="id3"&gt;
86 &lt;h2&gt;ページの生成&lt;/h2&gt;
87 &lt;p&gt;make で pelican を起動し、HTMLを生成します。&lt;/p&gt;
88 &lt;pre class="literal-block"&gt;
89 fsij-homepage$ make html
90 &lt;/pre&gt;
91 &lt;/div&gt;
92 &lt;div class="section" id="id4"&gt;
93 &lt;h2&gt;ページの表示&lt;/h2&gt;
94 &lt;p&gt;下記のようにして動かし、http://127.0.0.1:8000/ にアクセスするとページが見れます。&lt;/p&gt;
95 &lt;pre class="literal-block"&gt;
96 fsij-homepage$ cd output
97 fsij-homepage/output$ python -m pelican.server
98 &lt;/pre&gt;
99 &lt;/div&gt;
100 &lt;div class="section" id="id5"&gt;
101 &lt;h2&gt;変更を行う&lt;/h2&gt;
102 &lt;p&gt;変更を行った場合は前項の「ページの生成」、「ページの表示」を参考に手元で動かしてブラウザで確認してください。&lt;/p&gt;
103 &lt;p&gt;確認できたら、(ローカルの)リポジトリに変更をコミットします。&lt;/p&gt;
104 &lt;pre class="literal-block"&gt;
105 fsij-homepage$ git add ...
106 fsij-homepage$ git commit
107 &lt;/pre&gt;
108 &lt;/div&gt;
109 &lt;div class="section" id="push"&gt;
110 &lt;h2&gt;ソースの変更を push する(書き込み権限ありの場合)&lt;/h2&gt;
111 &lt;p&gt;例:&lt;/p&gt;
112 &lt;pre class="literal-block"&gt;
113 fsij-web$ git push
114 &lt;/pre&gt;
115 &lt;/div&gt;
116 </summary></entry><entry><title>Web サービス</title><link href="http://www.fsij.org/system/web-services/services.html" rel="alternate"></link><updated>2014-05-26T00:00:00+09:00</updated><author><name>webmaster@fsij.org</name></author><id>tag:www.fsij.org,2014-05-26:system/web-services/services.html</id><summary type="html">&lt;!-- author gniibe --&gt;
117 &lt;p&gt;このサイトのWebサービスについて書き留めます。
118 Static な web ページなので特にwebサーバの実装は選ばないと思います。&lt;/p&gt;
119 &lt;div class="section" id="id1"&gt;
120 &lt;h2&gt;Webサービスの構成&lt;/h2&gt;
121 &lt;p&gt;Webサービスの構成は下記のようになっています。&lt;/p&gt;
122 &lt;ul class="simple"&gt;
123 &lt;li&gt;apache&lt;/li&gt;
124 &lt;/ul&gt;
125 &lt;/div&gt;
126 </summary></entry><entry><title>Weblog のエントリのフォーマット</title><link href="http://www.fsij.org/system/weblog/weblog-format.html" rel="alternate"></link><updated>2009-09-10T12:43:00+09:00</updated><author><name>webmaster@fsij.org</name></author><id>tag:www.fsij.org,2009-09-10:system/weblog/weblog-format.html</id><summary type="html">&lt;p&gt;記事のフォーマットは &lt;a class="reference external" href="http://docutils.sourceforge.net/rst.html"&gt;ReST&lt;/a&gt; (に制約を加えたもの)で書きます。&lt;/p&gt;
127 &lt;p&gt;制約は下記の通り。&lt;/p&gt;
128 &lt;ul class="simple"&gt;
129 &lt;li&gt;1行目はタイトルです。&lt;/li&gt;
130 &lt;li&gt;2行目はセクションを示す下線です。&lt;/li&gt;
131 &lt;li&gt;(オプショナル)3行目以降のコメント行は pyblosxom への meta 情報です。&lt;/li&gt;
132 &lt;/ul&gt;
133 &lt;p&gt;例:&lt;/p&gt;
134 &lt;pre class="literal-block"&gt;
135 Web サービス
136 *****************
137 .. author gniibe
138 このサイトのWebサービスについて書き留めます。
139
140 Webサービスの構成
141 ==========================
142 Webサービスの構成は下記のようになっています。
143
144 * apache
145 * mod_wsgi
146 * wsgi services
147 &lt;/pre&gt;
148 &lt;div class="section" id="id1"&gt;
149 &lt;h2&gt;注意すること&lt;/h2&gt;
150 &lt;p&gt;ReST の処理系はどうやらバイト長でみているみたいなので、日本語を使っている場合、セクションのための下線は長めにしましょう。&lt;/p&gt;
151 &lt;/div&gt;
152 </summary></entry><entry><title>pyblosxom の脆弱性</title><link href="http://www.fsij.org/system/web-services/pyblosxom_vulnerabilities.html" rel="alternate"></link><updated>2009-09-09T19:23:00+09:00</updated><author><name>webmaster@fsij.org</name></author><id>tag:www.fsij.org,2009-09-09:system/web-services/pyblosxom_vulnerabilities.html</id><summary type="html">&lt;!-- author gniibe --&gt;
153 &lt;p&gt;脆弱性報告が下記に一つ出ています。&lt;/p&gt;
154 &lt;p&gt;&lt;a class="reference external" href="http://www.juniper.net/security/auto/vulnerabilities/vuln33676.html"&gt;http://www.juniper.net/security/auto/vulnerabilities/vuln33676.html&lt;/a&gt;&lt;/p&gt;
155 &lt;!-- BREAK --&gt;
156 &lt;p&gt;pyblosxom の作りは、(昔風で)文字列として HTML を構成する感じで、入力の sanitize にも問題があろうことは想像に固くない。&lt;/p&gt;
157 &lt;p&gt;下記のような利用の制限を加えて pyblosxom を使うことにした。&lt;/p&gt;
158 &lt;ul class="simple"&gt;
159 &lt;li&gt;HTTP の method は GET だけで使う&lt;/li&gt;
160 &lt;li&gt;QUERY_STRING はない形だけ使う(あったらエラー)&lt;/li&gt;
161 &lt;li&gt;拡張子で flavour の指定もできない形で使う&lt;/li&gt;
162 &lt;/ul&gt;
163 &lt;p&gt;file based の blog system を作り直した方がいいかしらん。&lt;/p&gt;
164 </summary></entry></feed>