Python PyH模塊中文文檔

本文翻譯自UserManual

僅作交流和分享之用空另,未經(jīng)許可黄鳍,禁止轉(zhuǎn)載!


GitHub維基百科

模塊介紹

Pyh 是一個(gè)強(qiáng)大且簡(jiǎn)約的python模塊,你可以使用它在python程序中生成HTML內(nèi)容手蝎。在python代碼中手寫HTML代碼非常乏味并且使代碼可讀性變得非常糟糕活喊。而且搜囱,當(dāng)你嘗試要去看一下HTML源碼的時(shí)候以舒,可讀性同樣很差。PyH為這一切提供了非常不錯(cuò)的解決方案擎颖。它讓你像編寫GUI一樣榛斯,編寫你的網(wǎng)頁!

功能特性

  • 自動(dòng)格式化HTML標(biāo)簽
  • 高度可定制
  • 完全識(shí)別CSS和Javascript
  • 自動(dòng)閉合標(biāo)簽
  • 面向?qū)ο蟮腍TML編寫方式

如何安裝PyH

從這個(gè)下載頁面下載(譯注:原鏈接需要代理搂捧,可以在本人托管的GitHub地址下載)或者直接下載 PyH-0.1.tar.gz(譯注:同樣需要代理)解壓到你的工作目錄或是python目錄驮俗,通常是 /usr/lib/pythonX.X/site-packages或者是其他任意能夠被 $PYTHONPATH識(shí)別的路徑:

$ wget http://pyh.googlecode.com/files/PyH-0.1.tar.gz
$ tar xvzf PyH-0.1.tar.gz
$ cd PyH-0.1
$ sudo python setup.py install

如果你沒有root權(quán)限,可以把 PyH-0.1/pyh.py文件拷貝到你的項(xiàng)目目錄下允跑。如果你正在使用一個(gè)基于RPM的發(fā)行版系統(tǒng)王凑,你可以使用rpm二進(jìn)制包搪柑,并通過如下命令來安裝:

$ wget http://pyh.googlecode.com/files/PyH-0.1-1.noarch.rpm
$ sudo rpm -ivh PyH-0.1-1.noarch.rpm

快速例程

下面這段python代碼:

from pyh import *
page = PyH('My wonderful PyH page')
page.addCSS('myStylesheet1.css', 'myStylesheet2.css')
page.addJS('myJavascript1.js', 'myJavascript2.js')
page << h1('My big title', cl='center')
page << div(cl='myCSSclass1 myCSSclass2', id='myDiv1') << p('I love PyH!', id='myP1')
mydiv2 = page << div(id='myDiv2')
mydiv2 << h2('A smaller title') + p('Followed by a paragraph.')
page << div(id='myDiv3')
page.myDiv3.attributes['cl'] = 'myCSSclass3'
page.myDiv3 << p('Another paragraph')
page.printOut()

會(huì)生成這段html代碼:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>My wonderful PyH page</title>
<link href="myStylesheet1.css" type="text/css" rel="stylesheet" />
<link href="myStylesheet2.css" type="text/css" rel="stylesheet" />
<script src="myJavascript1.js" type="text/javascript"></script>
<script src="myJavascript2.js" type="text/javascript"></script>
</head>
<body>
<h1 class="center">My big title</h1>
<div id="myDiv1" class="myCSSclass1 myCSSclass2">
<p id="myP1">I love PyH!</p>
</div>
<div id="myDiv2">
<h2>A smaller title</h2>
<p>Followed by a paragraph.</p>
</div>
<div id="myDiv3" class="myCSSclass3">
<p>Another paragraph</p>
</div>
</body>
</html>

基礎(chǔ)手冊(cè)

pyh.py可以通過如下方式導(dǎo)入:

>>> from pyh import *

Tag 對(duì)象

HTML 標(biāo)簽可以通過調(diào)用同名函數(shù)來生成。HTML 標(biāo)簽
<tag> 可以通過 tag() 生成:

>>> mydiv = div()
>>> mydiv.render()
'<div></div>'

標(biāo)簽的屬性索烹,通過函數(shù)的關(guān)鍵字參數(shù)傳入工碾,關(guān)鍵字和標(biāo)簽的屬性是同名的,除了class 這個(gè)屬性被替換成了 cl. 標(biāo)簽的內(nèi)容或是子標(biāo)簽可以通過非關(guān)鍵字參數(shù)傳入:

>>> mydiv = div('My content', cl='myCSSclass1 myCSSclass2', id='myCSSid1')
>>> mydiv.render()
'<div class="myCSSclass1 myCSSclass2" id="myCSSid1">
My content
</div>'

其他的標(biāo)簽同樣可以作為內(nèi)容傳入:

>>> mydiv = div(p('My paragraph.'), cl='myCSSclass1 myCSSclass2', id='myCSSid1')
>>> mydiv.render()
'<div class="myCSSclass1 myCSSclass2" id="myCSSid1">
<p>My paragraph</p>
</div>'

當(dāng)一個(gè)標(biāo)簽對(duì)象被創(chuàng)建后百姓,HTML屬性可以通過它的屬性成員來修改渊额,它是一個(gè)字典:

>>> mydiv = div()
>>> mydiv.attributes['id'] = 'myCSSid'
>>> mydiv.render()
'<div id="myCSSid"></div>\n'

標(biāo)簽可以通過+號(hào)進(jìn)行連接:

>>> twoDivs = div() + div()
>>> twoDivs.render()
'<div></div>
<div></div>'

標(biāo)簽可以被包含進(jìn)更高一層的標(biāo)簽中,可以把它作為非關(guān)鍵字參數(shù)傳入(就像上面介紹的那樣)垒拢,也可以通過<<操作符來完成旬迹。這個(gè)操作符會(huì)返回最后被包含的標(biāo)簽:

>>> myDiv = div(id='myTopLevelDiv')
>>> myPar = myDiv << div(id='myInnerDiv') << p(id='myPar') #注意此處返回的是p標(biāo)簽
>>> myPar << span('My first span') + span('My second span')
>>> myDiv.render()
'<div id="myTopLevelDiv">
<div id="myInnerDiv">
<p id="myPar">
<span>My first span</span><span>My second span</span>
</p>
</div>
</div>'

當(dāng)一個(gè)標(biāo)簽被包含進(jìn)另一個(gè)標(biāo)簽之后,可以把它作為上級(jí)標(biāo)簽的成員來進(jìn)行訪問求类,它的名字就是其id屬性的值奔垦,如果沒有指定該值,則tag_001就是該類第一個(gè)標(biāo)簽的名字仑嗅,以此類推:

>>> myDiv = div()
>>> myDiv << span(id='myspan')
>>> myDiv.myspan << 'content1'
>>> myDiv << span()
>>> myDiv.span << 'content2'
>>> myDiv << span()
>>> myDiv.span_001 << 'content3'
>>> myDiv.render()
'<div>
<span id="myspan">content1</span>
<span>content2</span>
<span>content3</span>
</div>'

創(chuàng)建網(wǎng)頁

最高層的對(duì)象宴倍,是PyH對(duì)象张症。它創(chuàng)建一個(gè)包含CSS和javascript元素的HTML頁面仓技。創(chuàng)建一個(gè)網(wǎng)頁的第一件事是實(shí)例化一個(gè)PyH對(duì)象:

from pyh import *
page = PyH('My wonderful PyH page')

隨后你可以添加你的CSS表盒javascript文件,例如:

page.addCSS('myStylesheet1.css', 'myStylesheet2.css')
page.addJS('myJavascript1.js', 'myJavascript2.js')

注意俗他,它們可以在任意時(shí)刻通過python腳本添加(例如脖捻,根據(jù)你的內(nèi)容,僅添加被用到的腳本和樣式表)兆衅。你現(xiàn)在可以開始創(chuàng)建你的頁面了:

page << h1('My big title!', cl='myCSSclass')
page << div(id='mySubtitleDiv') << h2('My sub-title')
maindiv = page << div(id='myMainDiv')
maindiv << h3('A smaller title') + p('followed by a small paragraph')
maindiv << p('Main paragraph ', style='color:red;') << a('a link', href='http://alink')
maindiv << span('hehe', onclick='myJavaScriptFcn(); return false;')
maindiv << br()
maindiv << img(src='mypicture.jpg')
page << div(id='myFooter') << span('My footer')

之后地沮,你可以把HTML頁面輸出到文件,或是輸出到瀏覽器羡亩,如果你的腳本是在服務(wù)器上運(yùn)行的話摩疑。

page.printOut()

輸出的結(jié)果是:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>My wonderful PyH page</title>
<link href="myStylesheet1.css" type="text/css" rel="stylesheet" />
<link href="myStylesheet2.css" type="text/css" rel="stylesheet" />
<script src="myJavascript1.js" type="text/javascript"></script>
<script src="myJavascript2.js" type="text/javascript"></script>
</head>
<body>
<h1 class="myCSSclass">My big title!</h1>
<div id="mySubtitleDiv"><h2>My sub-title</h2></div>
<div id="myMainDiv">
<h3>A smaller title</h3>
<p>followed by a small paragraph</p>
<p style="color:red;">Main paragraph <a href="http://alink">a link</a>
<span onclick="myJavaScriptFcn(); return false;">hehe</span><br />
<img src="mypicture.jpg" />
</div>
<div id="myFooter"><span>My footer</span>
</div>
</body>
</html>

創(chuàng)建表格

你可以充分利用python和pyh的能力來高校的生成HTML表格,創(chuàng)建一個(gè)4乘4的表格非常輕松:

page = PyH('My wonderful PyH page')
page << h2('Most compact way to build a 4 by 4 table')
page << table() << tr(td('1') + td('2')) + tr(td('3') + td('4'))
page << h2('Another way to build a 4 by 4 table')
mytab = page << table()
tr1 = mytab << tr()
tr1 << td('1') + td('2')
tr2 = mytab << tr()
tr2 << td('3') + td('4')
page.printOut()

上面的代碼會(huì)生成如下HTML代碼(為了簡(jiǎn)潔畏铆,表頭被去掉了)

<h2>Most compact way to build a 4 by 4 table</h2>
<table>
<tr>
<td>1</td><td>2</td>
</tr><tr>
<td>3</td><td>4</td>
</tr>
</table>
<h2>Another way to build a 4 by 4 table</h2>
<table>
<tr>
<td>1</td><td>2</td>
</tr><tr>
<td>3</td><td>4</td>
</tr>
</table>

現(xiàn)在雷袋,如果你想要自動(dòng)的創(chuàng)建一個(gè)大型表格,比如從數(shù)據(jù)庫中創(chuàng)建辞居,你可以這樣做:

mytab = page << table()
for i in range(nrows):
    mytr = mytab << tr()
    for j in range(ncols):
        mytr << td('Row %i, column %j' % (i, j))

這樣可以生成一個(gè)i乘j的表格楷怒。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市瓦灶,隨后出現(xiàn)的幾起案子鸠删,更是在濱河造成了極大的恐慌,老刑警劉巖贼陶,帶你破解...
    沈念sama閱讀 216,843評(píng)論 6 502
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件刃泡,死亡現(xiàn)場(chǎng)離奇詭異巧娱,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)烘贴,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,538評(píng)論 3 392
  • 文/潘曉璐 我一進(jìn)店門家卖,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人庙楚,你說我怎么就攤上這事上荡。” “怎么了馒闷?”我有些...
    開封第一講書人閱讀 163,187評(píng)論 0 353
  • 文/不壞的土叔 我叫張陵酪捡,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我纳账,道長(zhǎng)逛薇,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,264評(píng)論 1 292
  • 正文 為了忘掉前任疏虫,我火速辦了婚禮永罚,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘卧秘。我一直安慰自己呢袱,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,289評(píng)論 6 390
  • 文/花漫 我一把揭開白布翅敌。 她就那樣靜靜地躺著羞福,像睡著了一般。 火紅的嫁衣襯著肌膚如雪蚯涮。 梳的紋絲不亂的頭發(fā)上治专,一...
    開封第一講書人閱讀 51,231評(píng)論 1 299
  • 那天,我揣著相機(jī)與錄音遭顶,去河邊找鬼张峰。 笑死,一個(gè)胖子當(dāng)著我的面吹牛棒旗,可吹牛的內(nèi)容都是我干的喘批。 我是一名探鬼主播,決...
    沈念sama閱讀 40,116評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼嗦哆,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼谤祖!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起老速,我...
    開封第一講書人閱讀 38,945評(píng)論 0 275
  • 序言:老撾萬榮一對(duì)情侶失蹤粥喜,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后橘券,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體额湘,經(jīng)...
    沈念sama閱讀 45,367評(píng)論 1 313
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡卿吐,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,581評(píng)論 2 333
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了锋华。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片嗡官。...
    茶點(diǎn)故事閱讀 39,754評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖毯焕,靈堂內(nèi)的尸體忽然破棺而出衍腥,到底是詐尸還是另有隱情,我是刑警寧澤纳猫,帶...
    沈念sama閱讀 35,458評(píng)論 5 344
  • 正文 年R本政府宣布婆咸,位于F島的核電站,受9級(jí)特大地震影響芜辕,放射性物質(zhì)發(fā)生泄漏尚骄。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,068評(píng)論 3 327
  • 文/蒙蒙 一侵续、第九天 我趴在偏房一處隱蔽的房頂上張望倔丈。 院中可真熱鬧,春花似錦状蜗、人聲如沸需五。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,692評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽警儒。三九已至,卻和暖如春眶根,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背边琉。 一陣腳步聲響...
    開封第一講書人閱讀 32,842評(píng)論 1 269
  • 我被黑心中介騙來泰國(guó)打工属百, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人变姨。 一個(gè)月前我還...
    沈念sama閱讀 47,797評(píng)論 2 369
  • 正文 我出身青樓族扰,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親定欧。 傳聞我的和親對(duì)象是個(gè)殘疾皇子渔呵,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,654評(píng)論 2 354

推薦閱讀更多精彩內(nèi)容

  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn)砍鸠,斷路器扩氢,智...
    卡卡羅2017閱讀 134,652評(píng)論 18 139
  • Android 自定義View的各種姿勢(shì)1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 172,085評(píng)論 25 707
  • GitHub 上有一個(gè) Awesome - XXX 系列的資源整理,資源非常豐富,涉及面非常廣爷辱。awesome-p...
    若與閱讀 18,644評(píng)論 4 418
  • # Python 資源大全中文版 我想很多程序員應(yīng)該記得 GitHub 上有一個(gè) Awesome - XXX 系列...
    aimaile閱讀 26,480評(píng)論 6 427
  • 如常录豺,習(xí)楷后余墨練行書朦肘。晚安。
    逸之何春雷閱讀 480評(píng)論 0 17