Photograph - Typecho相冊(cè)主題使用文檔

寫在前面：隨著模版用戶逐漸增多，問題也更多的暴露出來了。這里需要再次著重說明的是，Typecho 一直是個(gè)輕量級(jí)的博客框架，Photograph 也一直是個(gè)圖片/相冊(cè)類的博客主題，如果您期望使用「Ta 們」實(shí)現(xiàn) WP 那樣豐富的、或者 CMS 那種專業(yè)向的功能，這里可能會(huì)令您失望，因此您可以關(guān)閉此頁然后去尋找更適合您的程序、框架或模版了；

如果您選擇繼續(xù)，香菇感謝您的支持，雖然因?yàn)楣ぷ麝P(guān)系很難有精力長期維持模版的開發(fā)更新，但依然會(huì)認(rèn)真對(duì)待「香菇的第一款收費(fèi)模版」，在保持長期更新的同時(shí)依然會(huì)努力堅(jiān)持讓這款模版配置更豐富但不臃腫、更好用且依然簡約的初心。再次感謝大家的支持。

• 文檔地址：詳情

關(guān)于售后

• 主題授權(quán)以用戶QQ號(hào)碼為準(zhǔn)
  • 如果號(hào)碼發(fā)生變更請(qǐng)?zhí)崆奥?lián)系香菇更新授權(quán)記錄
  • 如果號(hào)碼遺失請(qǐng)聯(lián)系香菇提供歷史號(hào)碼及支付記錄信息變更授權(quán)
  • 如果「未經(jīng)任何提前溝通刪除香菇好友」或因任何情況「發(fā)生號(hào)碼變更」后無法提供任何「證明身份」的信息，您將失去主題授權(quán)及售后支持
• 售后支持以售后群為主
  • 成功支付后香菇將邀請(qǐng)您加入售后群以方便交流（吹水）和獲取主題更新
  • 為了方便管理入群后請(qǐng)盡量不要退群，如果對(duì)群消息提醒感到厭煩可屏蔽群信息
  • 未經(jīng)任何提前溝通的退群行為將被默認(rèn)為放棄售后，但您不會(huì)失去主題的授權(quán)，且仍然受到「使用條款」的限制
• 為兼顧多數(shù)用戶，免費(fèi)售后范圍：
  • 包含當(dāng)前已有功能的使用答疑和 BUG 修復(fù)
  • 包含「在符合條件的安裝環(huán)境下安裝主題」
  • 不包含任何形式的「功能性」定制開發(fā)，但可通過「建議」形式提交需求，作者(香菇)會(huì)考慮在后續(xù)版本中更新
  • 主題僅提供附件、外鏈(圖床/網(wǎng)盤/存儲(chǔ)等)圖片的使用支持，但不提供相關(guān)三方服務(wù)
• 付費(fèi)服務(wù)包含：
  • 提供 Typecho 運(yùn)行環(huán)境的服務(wù)器、空間、域名(不含備案)租用及系統(tǒng)、環(huán)境部署等。費(fèi)用 = 成本費(fèi) + 服務(wù)費(fèi)(50RMB/次)

本文提供 Photograph for Typecho?付費(fèi)版主題使用(配置)說明，主要內(nèi)容在主題自定義設(shè)置項(xiàng)的解釋中都有體現(xiàn)，這里僅做總結(jié)整理，如需補(bǔ)充請(qǐng)聯(lián)系香菇處理。

安裝主題

• 在合適的運(yùn)行環(huán)境中安裝 Typecho 博客程序；
• 將主題包解壓到 Typecho 目錄下的/usr/themes中，保持主題目錄名為photograph；
• 到 Typecho 后臺(tái)管理控制臺(tái) > 外觀 > 可以使用的外觀中啟用主題。

Typecho 部分

---

設(shè)置 > 基本

• 若您需要上傳圖片附件，則需要勾選允許上傳的文件類型設(shè)置下的圖片文件 (gif jpg jpeg png tiff bmp)項(xiàng)目。

設(shè)置 > 閱讀

• 建議將每頁文章數(shù)目設(shè)置為12篇(或12的整數(shù)倍)，可以保證相冊(cè)列表在6列(6*2)、4列(4*3)、3列(3*4)、2列(2*6)狀態(tài)下都對(duì)齊顯示。

撰寫(管理)文章/頁面 > 高級(jí)選項(xiàng)

• 這里可以設(shè)置文章/頁面的公開度，文章可選公開、密碼保護(hù)、隱藏、私密、待審核五種狀態(tài)，其中設(shè)置為密碼保護(hù)時(shí)，前臺(tái)將顯示加密封面；頁面可選公開和隱藏狀態(tài)。

---

其他

• 該主題不需要任何其他 Typecho 插件輔助使用，如需實(shí)現(xiàn)其他插件輔助功能請(qǐng)自行解決；
• 該主題使用 Tyoecho 1.1 (17.10.30) 版本默認(rèn)編輯器和 Markdown 解析器，不支持特殊需求的「解析」；
• 如果使用過免費(fèi)主題，付費(fèi)版可直接覆蓋使用，覆蓋后請(qǐng)?jiān)诤笈_(tái)切換一下主題使默認(rèn)配置生效。

Photograph 部分

---

控制臺(tái) > 外觀 > 設(shè)置外觀

設(shè)置備份/還原

• 因?yàn)?Typecho 切換主題后會(huì)清空設(shè)置，且 Photograph 自定義設(shè)置項(xiàng)目較豐富，所以提供備份/還原主題設(shè)置和管理設(shè)置備份功能。

---

網(wǎng)站 LOGO

• 填寫LOGO圖片地址，即可替換前臺(tái)導(dǎo)航欄上的文字標(biāo)題。

---

大天朝身份認(rèn)證

• 填寫ICP備案號(hào)，留空則不顯示。

---

網(wǎng)站「導(dǎo)航欄」風(fēng)格設(shè)置

• 可選僅標(biāo)題居中的極簡 Ins 風(fēng)格或帶有頁面、分類、后臺(tái)管理等菜單且可配置菜單顯示方式的BootStrap 頂部固定導(dǎo)航欄。

---

是否折疊「分類」菜單

• 可選是否折疊顯示導(dǎo)航欄上的分類列表菜單。(該項(xiàng)設(shè)置僅對(duì) BootStrap 導(dǎo)航欄有效)
• 如果選擇不折疊，二級(jí)分類會(huì)生效。

---

導(dǎo)航欄「設(shè)置」入口

• 可選是否隱藏前臺(tái)導(dǎo)航欄設(shè)置入口，大屏模式下如果隱藏該項(xiàng)則搜索欄右對(duì)齊顯示。(該項(xiàng)設(shè)置僅對(duì) BootStrap 導(dǎo)航欄有效)

---

設(shè)置「RSS」入口

• 選擇是否隱藏設(shè)置菜單中RSS入口。(該項(xiàng)設(shè)置僅對(duì) BootStrap 導(dǎo)航欄有效)

---

顯示列數(shù)

• 超小屏幕顯示列數(shù) 手機(jī) (＜768px) / 小屏幕顯示列數(shù) 平板 (≥768px) / 中等屏幕顯示列數(shù) 桌面顯示器 (≥992px) / 大屏幕顯示列數(shù) 大桌面顯示器 (≥1200px)

---

封面高度設(shè)置

• 基于默認(rèn)「正方形」?fàn)顟B(tài)下的高度倍數(shù)設(shè)置，默認(rèn)1倍高度；
• 倍數(shù)＜1(如0.8)則顯示為橫向矩形，倍數(shù)＞1(如1.5)則顯示為豎向矩形。

---

封面標(biāo)題默認(rèn)狀態(tài)

• 可選是否默認(rèn)顯示封面標(biāo)題、內(nèi)容圖片數(shù)量等信息。

---

封面標(biāo)題邊框設(shè)置

• 替換了舊版本的「封面標(biāo)題邊框」，可分別設(shè)置封面標(biāo)題框四個(gè)方向是否顯示。

---

封面標(biāo)題圓角設(shè)置

• 可分別設(shè)置封面標(biāo)題框四個(gè)角是否顯示為圓角。

---

封面標(biāo)題裝飾

• 可選封面標(biāo)題框上的裝飾掛件，如果標(biāo)題邊框設(shè)為不顯示則該項(xiàng)配置無效。

---

是否登錄后可見密碼保護(hù)的相冊(cè)

• 設(shè)置登陸后才顯示加密的相冊(cè)。這種隱藏方式有缺陷，會(huì)導(dǎo)致列表頁加密相冊(cè)直接隱藏，且沒有替補(bǔ)相冊(cè)，不建議啟用。

---

是否顯示密碼保護(hù)相冊(cè)的原始封面

• 設(shè)置是否顯示密碼保護(hù)相冊(cè)的原始封面，標(biāo)題文字及內(nèi)容仍需密碼驗(yàn)證。

---

密碼保護(hù)的相冊(cè)封面

• 填寫密碼保護(hù)相冊(cè)的自定義封面圖地址，留空則顯示默認(rèn)圖片。

---

懶加載圖片設(shè)置

• 填寫懶加載 loading 圖片地址，留空則顯示默認(rèn)圖片。

---

相冊(cè)封面圖片參數(shù)設(shè)置/相冊(cè)詳情圖片參數(shù)設(shè)置

• 填寫相冊(cè)封面/詳情圖的預(yù)處理參數(shù)，適用于各種云存儲(chǔ)、對(duì)象存儲(chǔ)等，如無此需求請(qǐng)留空。
• 以七牛為例：

原圖URL為：
https://dn-odum9helk.qbox.me/resource/gogopher.jpg

如果需要錨點(diǎn)在正中 (Center)，生成 300x300 裁剪圖，添加參數(shù)后的完整鏈接為：
https://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageMogr2/gravity/Center/crop/300x300

則后臺(tái)設(shè)置的文本框中只需要填寫參數(shù)即可：
?imageMogr2/gravity/Center/crop/300x300

示例圖片鏈接來源：https://developer.qiniu.com/dora/api/1270/the-advanced-treatment-of-images-imagemogr2

---

圖片「燈箱」選擇

• 選擇用于展示圖片詳情的插件，可選fancybox3或lightGallery插件，請(qǐng)注意為了適配某些功能，兩個(gè)插件皆為香菇修改版，請(qǐng)不要隨意替換。

---

fancybox3 功能開關(guān)/lightGallery 功能開關(guān)

• 配置圖片詳情界面前臺(tái)展示樣式和功能入口等。

---

網(wǎng)站公告風(fēng)格設(shè)置

• 可設(shè)置網(wǎng)站公告顯示的位置。

---

網(wǎng)站公告顏色設(shè)置

• 可配置網(wǎng)站公告顯示的顏色。

---

網(wǎng)站公告

• 填寫網(wǎng)站公告內(nèi)容，支持HTML。

---

Footer Powered …

• 可選是否顯示頁腳「POWERED BY TYPECHO / THEME BY SIITAKE」信息。

---

全站信息統(tǒng)計(jì)

• 可選是否啟用全站信息統(tǒng)計(jì)，啟用將統(tǒng)計(jì)全站分類、文章、頁面、評(píng)論以及附件和文章內(nèi)容中的圖片數(shù)量，可能會(huì)略微增加主機(jī)負(fù)擔(dān)。

---

統(tǒng)計(jì)代碼

• 可填寫三方統(tǒng)計(jì)平臺(tái)生成的統(tǒng)計(jì)代碼，該內(nèi)容在頁面隱藏生效，留空則不生效。

---

相冊(cè)標(biāo)簽

• 設(shè)置是否顯示相冊(cè)詳情頁（底部）標(biāo)簽。

---

右下側(cè)功能按鈕樣式

• 設(shè)置頁面右下側(cè)功能按鈕的默認(rèn)形狀和不透明度。

---

組圖默認(rèn)描述

• 可填寫組圖的默認(rèn)描述，優(yōu)先級(jí)低于「自定義字段」的值，留空則顯示「未填寫」。

---

自定義樣式表(CSS)

• 可自定義或覆蓋主題的某些樣式。

---

全局圖片源選項(xiàng)（慎用）

• 全局設(shè)置相冊(cè)詳情圖的來源，選擇后兩項(xiàng)則「自定義字段」處的「圖片源」選項(xiàng)不生效。

如無特殊需求請(qǐng)保持此選項(xiàng)為默認(rèn)值。

---

相冊(cè)封面風(fēng)格（測(cè)試）

• 測(cè)試功能，暫無描述

---

自定導(dǎo)航欄菜單

• 如果需要自定義添加導(dǎo)航欄菜單，請(qǐng)按照名稱|地址|是否新窗口打開(true/false)的格式，一行一個(gè)填在此設(shè)置項(xiàng)的文本框內(nèi)。
• 示例：

文檔|https://photo.siitake.cn/docs|true
香菇|https://siitake.cn/|false

---

移動(dòng)（小屏）頁面是否顯示頂部分類導(dǎo)航

• 設(shè)置是否顯示獨(dú)立的分類導(dǎo)航。僅在小屏顯示。

---

設(shè)置「隨機(jī)文章/相冊(cè)」入口位置

• 可選不顯示、導(dǎo)航欄、右下角。點(diǎn)擊可隨機(jī)跳轉(zhuǎn)到一個(gè)相冊(cè)/一篇文章。

---

站點(diǎn)「圖標(biāo)」設(shè)置

• 填寫站點(diǎn)favicon的路徑，用來自定義站點(diǎn)圖標(biāo)。

---

設(shè)置「標(biāo)簽」樣式

• 可選單色和彩色兩種詳情頁標(biāo)簽樣式。

---

設(shè)置「首次訪問」提示頁

• 設(shè)置啟用或停用「首次訪問」提示頁

---

填寫「首次訪問」提示頁自定義代碼

• 支持標(biāo)準(zhǔn) HTML(5) 格式的代碼，用于創(chuàng)建頁面結(jié)構(gòu)。
• 示例代碼①：

<h1 class="fv-title">FBI WARNING</h1>
<p class="fv-content">FBI Warning Federal law provides severe civil and criminal penalties for the unauthorized reproduction,distribution,or exhibition of copyrighted motion prictures(Title 17, United States Code, Sections 501 and 508). The federal bureau of Investigation investigate allegations of criminal copyright infringement.<br>
(Title 17, United States Code, Section 506)</p>
<p class="fv-content"><button class="fv-ok" onclick="cookieSet('firstVisiting', 156518603, 1);location.reload();">OK</button><button class="fv-no" onclick="cookieDelete('firstVisiting');location.>EXIT</button></p>

• 示例代碼②：

<div class="fv-logo"></div>
<div class="fv-nav fv-antiselect">
    <ul>
        <li><a target="_blank" >博客</a></li>
        <li><a target="_blank" href="javascript:cookieSet('firstVisiting', 156518603, 1);location.reload();">圖庫</a></li>
        <li><a target="_blank" >網(wǎng)盤</a></li>
    </ul>
</div>
<div class="fv-footer">
    <p class="fv-icp fv-antiselect">
        <p>陜ICP備17001968號(hào)</p>
    </p>
</div>

注：按鈕調(diào)用的cookieSet('firstVisiting', 156518603, 1);和cookieDelete('firstVisiting');方法用于操作cookie，結(jié)合后臺(tái)代碼控制是否顯示。

---

填寫「首次訪問」提示頁自定義樣式

• 支持標(biāo)準(zhǔn) CSS(3) 格式，用于控制頁面樣式。
• 示例樣式①：

#firstVisitingPage { background-color: black; color: white; }
.fv-title { display: block; width: 270px; margin: 120px auto 40px auto; text-align: center; background-color: red; padding: 5px; }
.fv-content { display: block; width: 70vw; margin: 10px auto; font-size: 32px; text-align: center; }
.fv-ok { margin: 5px; background-color: green; min-width: 100px; }
.fv-no { margin: 5px; background-color: red; min-width: 100px; }
@media screen and (max-width: 767px) { .fv-content { font-size: 18px; } }
@media screen and (max-width: 320px) { .fv-title { width: 220px; margin: 60px auto 15px auto; font-size: 26px; } }

• 示例樣式②：

#firstVisitingPage { height: 100vh; background: -webkit-linear-gradient(pink, plum); background: -o-linear-gradient(pink, plum); background: -moz-linear-gradient(pink, plum); background: linear-gradient(pink, plum); font-size: 1em; }
.fv-logo { width: 320px; height: 320px; margin: calc(50vh - 250px) auto 30px auto; background-color: palevioletred; background-image: url('https://siitake.cn/tools/weiboAvatar/?uid=6185985582'); background-position: center; background-size: cover; border: 10px solid white; border-radius: 320px; }
.fv-nav { text-align: center; }
.fv-nav ul { list-style: none; padding-left: 0; }
.fv-nav li { display: inline-block; }
.fv-nav a { display: block; color: palevioletred; padding: 5px 10px; margin: 5px; background-color: white; border-radius: 3px; text-decoration: none; font-size: 1.5em; transition: all .5s; }
.fv-nav a:hover { color: white; background-color: palevioletred; }
.fv-footer{ width: 100vw; height: 30px; position: fixed; bottom: 30px; text-align: center; }
.fv-icp { font-size: .75em; line-height: 2px; color: white; }
.fv-antiselect { user-select: none; -ms-user-select: none; -moz-user-select: none; -webkit-user-select: none; }

---

快捷鍵設(shè)置

• 設(shè)置網(wǎng)站鍵盤快捷鍵功能，請(qǐng)按照「按鍵|功能描述|執(zhí)行代碼」的格式，一行一個(gè)填在此設(shè)置項(xiàng)的文本框內(nèi)。
• 可直接填寫按鍵或組合鍵的名稱，不必填寫鍵值，例如：T、5、[、ESC、ENTER、CTRL+R等。
• 執(zhí)行代碼支持標(biāo)準(zhǔn)javascript代碼，但不支持聲明函數(shù)。
• 示例：

H|返回首頁|location.href = "/";
T|跳到頂端|$("html ,body").animate({scrollTop: 0}, 300);
B|跳到底部|$("html ,body").animate({scrollTop: document.body.scrollHeight}, 300);
Ctrl+R|隨機(jī)文章|location.href = randomPost;

---

自定義字段

「相冊(cè)/圖文」模式選擇

• 前臺(tái)文章詳情的顯示方式，可選相冊(cè)（默認(rèn)）和圖文（與單頁排版一致）兩種模板。

---

圖片[title]

• 選擇前臺(tái)圖片標(biāo)簽的title屬性值，圖片源為內(nèi)容的title默認(rèn)為文章標(biāo)題序列，標(biāo)題序列指的是在標(biāo)題文字后添加形如[1]的序號(hào)

---

圖片源

• 選擇前臺(tái)展示的圖片源。
• 選擇附件則只讀取 Typecho 原生或插件附件中的圖片。
• 選擇內(nèi)容則只讀取文章正文文本框中填寫的外鏈圖片。
• 選擇附件+內(nèi)容則內(nèi)容(外鏈)圖片在前。
• 內(nèi)容(外鏈)圖片支持Markdown和HTML標(biāo)準(zhǔn)格式，不支持純 URL。
• 示例：

<img src="https://ws1.sinaimg.cn/mw1024/006v3k7fly1g2zhxz8bvfj34o03401ky.jpg">

![圖片](https://ws1.sinaimg.cn/mw1024/006v3k7fly1g2zhxz8bvfj34o03401ky.jpg)

---

作者/來源

• 填寫照片拍攝照片者的姓名、圖片來源等信息。

---

來源地址

• 填寫圖片出處URL，留空則不鏈接地址。

---

出鏡人物

• 填寫照片/圖片出鏡者信息。

---

處理軟件

• 選擇照片/圖片后期處理用到的軟件。

---

打包下載

• 在這里填寫圖片打包下載URL，留空則不顯示。

---

打包下載鏈接名

• 自定義圖片打包下載鏈接文字，留空則顯示打包下載。

---

圖集描述

• 填寫照片描述等其他信息，支持HTML。

---

封面圖片

• 填寫封面圖片的地址，留空將自動(dòng)獲取第一張圖片。

---

是否隱藏部分圖片

• 可設(shè)置相冊(cè)詳情隱藏部分圖片并登陸后可見

---

隱藏圖片位置

• 填寫整數(shù)，從此位置的圖片開始隱藏。

---

設(shè)置「不一樣の列」

• 頁面共12列，設(shè)置第N張圖片超小屏、小屏、中屏、大屏所占列數(shù)，示例：2:12,8,6,6。示例

---

閱讀次數(shù)

• 記錄相冊(cè)被點(diǎn)擊的次數(shù)，可手動(dòng)設(shè)置起始閱讀量，后續(xù)點(diǎn)擊會(huì)在此基礎(chǔ)上自增。

以上就是這款Typecho相冊(cè)主題使用介紹的全部內(nèi)容了。