Butterfly 安裝文檔(三) 主題配置 |
您所在的位置:网站首页 › butterfly中文歌词 › Butterfly 安裝文檔(三) 主題配置 |
🦋 Butterfly 已經更新到 4.10 📚 文檔目錄 🚀 快速開始 - 📑 主題頁面 - 📌 主題配置-1 - ⚔️ 主題配置-2 - ❓ 主題問答 - ⚡️ 進階教程 你可以通過右下角的 簡 按鈕切換為簡體顯示 語言修改站點配置文件 _config.yml 默認語言是 en 主題支持三種語言 default(en)zh-CN (簡體中文)zh-TW (繁體中文)網站資料修改網站各種資料,例如標題、副標題和郵箱等個人資料,請修改博客根目錄的_config.yml 主題配置文件中 1234nav: logo: #image display_title: true fixed: false # fixed navigation bar參數解釋logo網站的 logo,支持圖片,直接填入圖片鏈接display_title是否顯示網站標題,填寫 true 或者 falsefixed是否固定狀態欄,填寫 true 或者 false菜單/目錄修改 主題配置文件 123456789Home: / || fas fa-homeArchives: /archives/ || fas fa-archiveTags: /tags/ || fas fa-tagsCategories: /categories/ || fas fa-folder-openList||fas fa-list: Music: /music/ || fas fa-music Movie: /movies/ || fas fa-videoLink: /link/ || fas fa-linkAbout: /about/ || fas fa-heart必須是 /xxx/,後面||分開,然後寫圖標名。 如果不希望顯示圖標,圖標名可不寫。 默認子目錄是展開的,如果你想要隱藏,在子目錄裏添加 hide 。 123List||fas fa-list||hide: Music: /music/ || fas fa-music Movie: /movies/ || fas fa-video注意: 導航的文字可自行更改 例如: 1234567891011menu: 首頁: / || fas fa-home 時間軸: /archives/ || fas fa-archive 標籤: /tags/ || fas fa-tags 分類: /categories/ || fas fa-folder-open 清單||fa fa-heartbeat: 音樂: /music/ || fas fa-music 照片: /Gallery/ || fas fa-images 電影: /movies/ || fas fa-video 友鏈: /link/ || fas fa-link 關於: /about/ || fas fa-heart代碼塊中的所有功能只適用於 Hexo 自帶的代碼渲染 如果使用第三方的渲染器,不一定會有效 代碼高亮主題Butterfly 支持6種代碼高亮樣式: darkerpale nightlightoceanmacmac light修改 主題配置文件 1highlight_theme: lightdarker pale night light ocean mac mac light 主題從 3.0 開始,支持使用自定義的代碼顔色。 如何自定義主題,請查看下面這篇文章。 自定義代碼配色 代碼複製主題支持代碼複製功能 修改 主題配置文件 1highlight_copy: true在默認情況下,代碼框自動展開,可設置是否所有代碼框都關閉狀態,點擊>可展開代碼 true 全部代碼框不展開,需點擊>打開false 代碼框展開,有>點擊按鈕none 不顯示>按鈕修改 主題配置文件 1highlight_shrink: true #代碼框不展開,需點擊 '>' 打開你也可以在post/page頁對應的markdown文件front-matter添加highlight_shrink來獨立配置。 當主題配置文件中的 highlight_shrink 設為true時,可在front-matter添加highlight_shrink: false來單獨配置文章展開代碼框。 當主題配置文件中的 highlight_shrink 設為false時,可在front-matter添加highlight_shrink: true來單獨配置文章收縮代碼框。 highlight_shrink: true highlight_shrink: false highlight_shrink: none 在默認情況下,Hexo 在編譯的時候不會實現代碼自動換行。如果你不希望在代碼塊的區域裏有橫向滾動條的話,那麼你可以考慮開啟這個功能。 修改 主題配置文件 1code_word_wrap: true如果你是使用 highlight 渲染,需要找到你站點的 Hexo 配置文件_config.yml,將line_number改成false: 12345highlight: enable: true line_number: false # cover > 配置文件的 default_top_img配置中的值: 配置解釋index_img主頁的 top_imgdefault_top_img默認的 top_img,當頁面的 top_img 沒有配置時,會顯示 default_top_imgarchive_img歸檔頁面的 top_imgtag_imgtag 子頁面 的 默認 top_imgtag_per_imgtag 子頁面的 top_img,可配置每個 tag 的 top_imgcategory_imgcategory 子頁面 的 默認 top_imgcategory_per_imgcategory 子頁面的 top_img,可配置每個 category 的 top_img其它頁面 (tags/categories/自建頁面)和 文章頁 的 top_img ,請到對應的 md 頁面設置front-matter中的top_img 以上所有的 top_img 可配置以下值 3.2.0 以下版本的配置只支持 留空,true 和 false - 顯示默認的顔色img鏈接 - 顯示所配置的圖片配置的值效果留空顯示默認的 top_img(如有),否則顯示默認的顔色(文章頁top_img留空的話,會顯示 cover 的值)img鏈接圖片的鏈接,顯示所配置的圖片顔色(HEX值 - #0000FFRGB值 - rgb(0,0,255)顔色單詞 - orange漸變色 - linear-gradient( 135deg, #E2B0FF 10%, #9F44D3 100%))對應的顔色transparent透明false不顯示 top_imgtag_per_img 和 category_per_img 是 3.2.0 新增的內容,可對 tag 和 category 進行單獨的配置 並不推薦為每個 tag 和每個 category 都配置不同的頂部圖,因為配置太多會拖慢生成速度 1234567tag_per_img: aplayer: https://xxxxxx.png android: ddddddd.png category_per_img: 隨想: hdhdh.png 推薦: ddjdjdjd.pngtop_img: false top_img: orange top_img: 'linear-gradient(20deg, #0062be, #925696, #cc426e, #fb0347)' 文章的 markdown 文檔上,在 Front-matter 添加 cover ,並填上要顯示的圖片地址。 如果不配置 cover,可以設置顯示默認的 cover。 如果不想在首頁顯示 cover, 可以設置為 false。 文章封面的獲取順序 Front-matter 的 cover > 配置文件的 default_cover > false 修改 主題配置文件 12345678910cover: # 是否顯示文章封面 index_enable: true aside_enable: true archives_enable: true # 封面顯示的位置 # 三個值可配置 left , right , both position: both # 當沒有設置cover時,默認的封面顯示 default_cover: 參數解釋index_enable主頁是否顯示文章封面圖aside_enable側欄是否顯示文章封面圖archives_enable歸檔頁面是否顯示文章封面圖position主頁卡片文章封面的顯示位置- left:全部顯示在左邊- right:全部顯示在右邊- both:封面位置以左右左右輪流顯示default_cover默認的 cover, 可配置圖片鏈接/顔色/漸變色等當配置多張圖片時,會隨機選擇一張作為cover.此時寫法應為 1234default_cover: - https://jsd.012700.xyz/gh/jerryc127/CDN@latest/cover/default_bg.png - https://jsd.012700.xyz/gh/jerryc127/CDN@latest/cover/default_bg2.png - https://jsd.012700.xyz/gh/jerryc127/CDN@latest/cover/default_bg3.pngleft right both 這個選項是用來顯示文章的相關信息的。 修改 主題配置文件 12345678910111213post_meta: page: date_type: both # created or updated or both 主頁文章日期是創建日或者更新日或都顯示 date_format: relative # date/relative 顯示日期還是相對日期 categories: true # true or false 主頁是否顯示分類 tags: true # true or false 主頁是否顯示標籤 label: true # true or false 顯示描述性文字 post: date_type: both # created or updated or both 文章頁日期是創建日或者更新日或都顯示 date_format: relative # date/relative 顯示日期還是相對日期 categories: true # true or false 文章頁是否顯示分類 tags: true # true or false 文章頁是否顯示標籤 label: true # true or false 顯示描述性文字主頁 文章頁 date_format 是 3.2.0 新增的內容,配置時間顯示明確時間還是相對時間 相對時間 明確時間 因為主題UI的關係,主頁文章節選只支持自動節選和文章頁description。 在butterfly裏,有四種可供選擇 description: 只顯示descriptionboth: 優先選擇description,如果沒有配置description,則顯示自動節選的內容auto_excerpt:只顯示自動節選false: 不顯示文章內容修改 主題配置文件 123index_post_content: method: 3 length: 500 # if you set method to 2 or 3, the length need to configdescription在front-matter裏添加 開啟頁面錨點後,當你在進行滾動時,頁面鏈接會根據標題ID進行替換(注意: 每替換一次,會留下一個歷史記錄。所以如果一篇文章有很多錨點的話,網頁的歷史記錄會很多。) 修改 主題配置文件 123456# anchoranchor: # when you scroll, the URL will update according to header id. auto_update: false # Click the headline to scroll and update the anchor click_to_scroll: false圖片描述可開啟圖片Figcaption描述文字顯示 優先顯示圖片的 title 屬性,然後是 alt 屬性 修改 主題配置文件 1photofigcaption: true可配置網站是否可以複製、複製的內容是否添加版權信息 1234567# copy settings# copyright: Add the copyright information after copied content (複製的內容後面加上版權信息)copy: enable: true copyright: enable: true limit_count: 50配置解釋enable是否開啟網站複製權限copyright複製的內容後面加上版權信息enable是否開啟複製版權信息添加limit_count字數限制,當複製文字大於這個字數限制時,將在複製的內容後面加上版權信息添加版權信息後 1234567Lorem ipsum dolor sit amet, test link consectetur adipiscing elit. Strong text pellentesque ligula commodo viverra vehicula. Italic text at ullamcorper enim. Morbi a euismod nibh. Underline text non elit nisl. Deleted text tristique, sem id condimentum tempus, metus lectus venenatis mauris, sit amet semper lorem felis a eros. Fusce egestas nibh at sagittis auctor. Sed ultricies ac arcu quis molestie. Donec dapibus nunc in nibh egestas, vitae volutpat sem iaculis. Curabitur sem tellus, elementum nec quam id, fermentum laoreet mi. Ut mollis ullamcorper turpis, vitae facilisis velit ultricies sit amet. Etiam laoreet dui odio, id tempus justo tincidunt id. Phasellus scelerisque nunc sed nunc ultricies accumsan.作者: Jerry連結: http://localhost:4000/posts/bd3c650b/#Paragraph來源: Butterfly著作權歸作者所有。商業轉載請聯絡作者獲得授權,非商業轉載請註明出處。文章頁相關配置文章版權為你的博客文章展示文章版權和許可協議。 修改 主題配置文件 123456post_copyright: enable: true decode: false author_href: license: CC BY-NC-SA 4.0 license_url: https://creativecommons.org/licenses/by-nc-sa/4.0/由於Hexo 4.1開始,默認對網址進行解碼,以至於如果是中文網址,會被解碼,可設置decode: true來顯示中文網址。 如果有文章(例如:轉載文章)不需要顯示版權,可以在文章Front-matter單獨設置 1copyright: false從3.0.0開始,支持對單獨文章設置版權信息,可以在文章Front-matter單獨設置 1234copyright_author: xxxxcopyright_author_href: https://xxxxxx.comcopyright_url: https://xxxxxx.comcopyright_info: 此文章版權歸xxxxx所有,如有轉載,請註明來自原作者版權顯示截圖 在你每篇文章的結尾,可以添加打賞按鈕。相關二維碼可以自行配置。 對於沒有提供二維碼的,可配置一張軟件的icon圖片,然後在link上添加相應的打賞鏈接。用户點擊圖片就會跳轉到鏈接去。 link可以不寫,會默認為圖片的鏈接。 修改 主題配置文件 12345678910reward: enable: true text: QR_code: - img: /img/wechat.jpg link: text: 微信 - img: /img/alipay.jpg link: text: 支付寶在文章頁,會有一個目錄,用於顯示TOC。 修改 主題配置文件 1234567toc: post: true page: true number: true expand: false style_simple: false # for post scroll_percent: true屬性解釋post文章頁是否顯示 TOCpage普通頁面是否顯示 TOCnumber是否顯示章節數expand是否展開 TOCstyle_simple簡潔模式(側邊欄只顯示 TOC, 只對文章頁有效 )scroll_percent是否顯示滾動進度百分比Toc PC Toc Mobile style_simple: true 在你的文章md文件的頭部,加入toc_number和toc,並配置true或者false即可。 主題會優先判斷文章Markdown的Front-matter是否有配置,如有,則以Front-matter的配置為準。否則,以主題配置文件中的配置為準 相關文章當文章封面設置為 false 時,或者沒有獲取到封面配置,相關文章背景將會顯示主題色。 相關文章推薦的原理是根據文章tags的比重來推薦 修改 主題配置文件 1234related_post: enable: true limit: 6 # 顯示推薦文章數目 date_type: created # or created or updated 文章日期顯示創建日或者更新日可設置是否顯示文章過期提醒,以更新時間為基準。 12345678# Displays outdated notice for a post (文章過期提醒)noticeOutdate: enable: true style: flat # style: simple/flat limit_day: 365 # When will it be shown position: top # position: top/bottom message_prev: It has been message_next: days since the last update, the content of the article may be outdated.limit_day: 距離更新時間多少天才顯示文章過期提醒 message_prev : 天數之前的文字 message_next:天數之後的文字 style: flat style: simple 在文章標題旁邊顯示一個編輯按鈕,點擊會跳轉到對應的鏈接去。 1234567# Post edit# Easily browse and edit blog source code online.post_edit: enable: false # url: https://github.com/user-name/repo-name/edit/branch-name/subdirectory-name/ # For example: https://github.com/jerryc127/butterfly.js.org/edit/main/source/ url:當文章封面設置為 false 時,或者沒有獲取到封面配置,分頁背景將會顯示主題色。 可設置分頁的邏輯,也可以關閉分頁顯示 123456# post_pagination (分頁)# value: 1 || 2 || false# 1: The 'next post' will link to old post# 2: The 'next post' will link to new post# false: disable paginationpost_pagination: false參數解釋post_pagination: false關閉分頁按鈕post_pagination: 1下一篇顯示的是舊文章post_pagination: 2下一篇顯示的是新文章since是一個來展示你站點起始時間的選項。它位於頁面的最底部。 修改 主題配置文件 1234footer: owner: enable: true since: 2018custom_text是一個給你用來在頁腳自定義文本的選項。通常你可以在這裏寫聲明文本等。支持 HTML。 修改 主題配置文件 1custom_text: Hi, welcome to my blog!對於部分人需要寫 ICP 的,也可以寫在 custom_text裏 1custom_text: 備案號:xxxxxx側邊欄設置 (aside)側邊排版可自行決定哪個項目需要顯示,可決定位置,也可以設置不顯示側邊欄。 修改 主題配置文件 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354aside: enable: true hide: false button: true mobile: true # display on mobile position: right # left or right display: archive: true tag: true category: true card_author: enable: true description: button: enable: true icon: fab fa-github text: Follow Me link: https://github.com/xxxxxx card_announcement: enable: true content: This is my Blog card_recent_post: enable: true limit: 5 # if set 0 will show all sort: date # date or updated sort_order: # Don't modify the setting unless you know how it works card_categories: enable: true limit: 8 # if set 0 will show all expand: none # none/true/false sort_order: # Don't modify the setting unless you know how it works card_tags: enable: true limit: 40 # if set 0 will show all color: false orderby: random # Order of tags, random/name/length order: 1 # Sort of order. 1, asc for ascending; -1, desc for descending sort_order: # Don't modify the setting unless you know how it works card_archives: enable: true type: monthly # yearly or monthly format: MMMM YYYY # eg: YYYY年MM月 order: -1 # Sort of order. 1, asc for ascending; -1, desc for descending limit: 8 # if set 0 will show all sort_order: # Don't modify the setting unless you know how it works card_webinfo: enable: true post_count: true last_push_date: true sort_order: # Don't modify the setting unless you know how it works card_post_series: enable: true orderBy: 'date' # Order by title or date order: -1 # Sort of order. 1, asc for ascending; -1, desc for descendingposition: left position: right card_tags color: false card_tags color: true aside button 訪問 busuanzi 的官方網站查看更多的介紹。 修改 主題配置文件 1234busuanzi: site_uv: true site_pv: true page_pv: true如果需要修改 busuanzi 的 CDN 鏈接,可通過 主題配置文件 的 CDN 中的 option 進行修改 123CDN: option: busuanzi: xxxxxxxxx網頁已運行時間 修改 主題配置文件 123456runtimeshow: enable: true publish_date: 6/7/2018 00:00:00 ##網頁開通時間 #格式: 月/日/年 時間 #也可以寫成 年/月/日 時間3.1.0 起支持 最新評論只會在刷新時才會去讀取,並不會實時變化 由於 API 有 訪問次數限制,為了避免調用太多,主題默認存取期限為 10 分鐘。也就是説,調用後資料會存在 localStorage 裏,10分鐘內刷新網站只會去 localStorage 讀取資料。 10 分鐘期限一過,刷新頁面時才會去調取 API 讀取新的數據。( 3.6.0 新增了 storage 配置,可自行配置緩存時間) 在側邊欄顯示最新評論板塊 修改 主題配置文件 1234567# Aside widget - Newest Commentsnewest_comments: enable: true sort_order: # Don't modify the setting unless you know how it works limit: 6 storage: 10 # unit: mins, save data to localStorage avatar: true部分配置解釋: 配置解釋limit顯示的數量storage設置緩存時間,單位 分鐘avatar是否顯示頭像Demo 簡體繁體互換 右下角會有簡繁轉換按鈕。 修改 主題配置文件 123456789101112translate: enable: true # 默認按鈕顯示文字(網站是簡體,應設置為'default: 繁') default: 簡 #網站默認語言,1: 繁體中文, 2: 簡體中文 defaultEncoding: 1 #延遲時間,若不在前, 要設定延遲翻譯時間, 如100表示100ms,默認為0 translateDelay: 0 #當文字是簡體時,按鈕顯示的文字 msgToTraditionalChinese: "繁" #當文字是繁體時,按鈕顯示的文字 msgToSimplifiedChinese: "簡"簡體 繁體 閲讀模式下會去掉除文章外的內容,避免幹擾閲讀。 只會出現在文章頁面,右下角會有閲讀模式按鈕。 修改 主題配置文件 1readmode: true右下角會有夜間模式按鈕 修改 主題配置文件 123456789# dark modedarkmode: enable: true # dark mode和 light mode切換按鈕 button: true autoChangeMode: false # Set the light mode time. The value is between 0 and 24. If not set, the default value is 6 and 18 start: # 8 end: # 22參數解釋button是否在右下角顯示日夜模式切換按鈕autoChangeMode自動切換的模式autoChangeMode: 1 跟隨系統而變化,不支持的瀏覽器/系統將按照時間 start 到 end 之間切換為 light modeautoChangeMode: 2 只按照時間 start 到 end 之間切換為 light mode ,其餘時間為 dark modeautoChangeMode: false 取消自動切換startlight mode 的開始時間endlight mode 的結束時間主題配置文件中 12# show scroll percent in scroll-to-top buttonrightside_scroll_percent: true標籤外掛是Hexo獨有的功能,並不是標準的Markdown格式。 以下的寫法,只適用於Butterfly主題,用在其它主題上不會有效果,甚至可能會報錯。使用前請留意 標籤外掛雖然能為主題帶來一些額外的功能和UI方面的強化,但是,標籤外掛也有明顯的限制,使用時請留意。 Note (Bootstrap Callout)移植於next主題,並進行修改。 修改 主題配置文件 123456789101112note: # Note tag style values: # - simple bs-callout old alert style. Default. # - modern bs-callout new (v2-v3) alert style. # - flat flat callout style with background, like on Mozilla or StackOverflow. # - disabled disable all CSS styles import of note tag. style: simple icons: false border_radius: 3 # Offset lighter of background in % for modern and flat styles (modern: -12 | 12; flat: -18 | 6). # Offset also applied to label tag variables. This option can work with disabled note tag. light_bg_offset: 0icons和light_bg_offset只對方法一生效 Note 標籤外掛有兩種用法 123{% note [class] [no-icon] [style] %}Any content (support inline tags too.io).{% endnote %}名稱用法class【可選】標識,不同的標識有不同的配色( default / primary / success / info / warning / danger )no-icon【可選】不顯示 iconstyle【可選】可以覆蓋配置中的 style(simple/modern/flat/disabled)simple 123456789101112131415161718192021222324252627{% note simple %}默認 提示塊標籤{% endnote %}{% note default simple %}default 提示塊標籤{% endnote %}{% note primary simple %}primary 提示塊標籤{% endnote %}{% note success simple %}success 提示塊標籤{% endnote %}{% note info simple %}info 提示塊標籤{% endnote %}{% note warning simple %}warning 提示塊標籤{% endnote %}{% note danger simple %}danger 提示塊標籤{% endnote %}默認 提示塊標籤 default 提示塊標籤 primary 提示塊標籤 success 提示塊標籤 info 提示塊標籤 warning 提示塊標籤 danger 提示塊標籤 modern 123456789101112131415161718192021222324252627{% note modern %}默認 提示塊標籤{% endnote %}{% note default modern %}default 提示塊標籤{% endnote %}{% note primary modern %}primary 提示塊標籤{% endnote %}{% note success modern %}success 提示塊標籤{% endnote %}{% note info modern %}info 提示塊標籤{% endnote %}{% note warning modern %}warning 提示塊標籤{% endnote %}{% note danger modern %}danger 提示塊標籤{% endnote %}默認 提示塊標籤 default 提示塊標籤 primary 提示塊標籤 success 提示塊標籤 info 提示塊標籤 warning 提示塊標籤 danger 提示塊標籤 flat 123456789101112131415161718192021222324252627{% note flat %}默認 提示塊標籤{% endnote %}{% note default flat %}default 提示塊標籤{% endnote %}{% note primary flat %}primary 提示塊標籤{% endnote %}{% note success flat %}success 提示塊標籤{% endnote %}{% note info flat %}info 提示塊標籤{% endnote %}{% note warning flat %}warning 提示塊標籤{% endnote %}{% note danger flat %}danger 提示塊標籤{% endnote %}默認 提示塊標籤 default 提示塊標籤 primary 提示塊標籤 success 提示塊標籤 info 提示塊標籤 warning 提示塊標籤 danger 提示塊標籤 disabled 123456789101112131415161718192021222324252627{% note disabled %}默認 提示塊標籤{% endnote %}{% note default disabled %}default 提示塊標籤{% endnote %}{% note primary disabled %}primary 提示塊標籤{% endnote %}{% note success disabled %}success 提示塊標籤{% endnote %}{% note info disabled %}info 提示塊標籤{% endnote %}{% note warning disabled %}warning 提示塊標籤{% endnote %}{% note danger disabled %}danger 提示塊標籤{% endnote %}默認 提示塊標籤 default 提示塊標籤 primary 提示塊標籤 success 提示塊標籤 info 提示塊標籤 warning 提示塊標籤 danger 提示塊標籤 no-icon 123456789101112131415161718192021222324252627{% note no-icon %}默認 提示塊標籤{% endnote %}{% note default no-icon %}default 提示塊標籤{% endnote %}{% note primary no-icon %}primary 提示塊標籤{% endnote %}{% note success no-icon %}success 提示塊標籤{% endnote %}{% note info no-icon %}info 提示塊標籤{% endnote %}{% note warning no-icon %}warning 提示塊標籤{% endnote %}{% note danger no-icon %}danger 提示塊標籤{% endnote %}默認 提示塊標籤 default 提示塊標籤 primary 提示塊標籤 success 提示塊標籤 info 提示塊標籤 warning 提示塊標籤 danger 提示塊標籤 3.2.0 以上版本支 123{% note [color] [icon] [style] %}Any content (support inline tags too.io).{% endnote %}名稱用法color【可選】顔色(default / blue / pink / red / purple / orange / green)icon【可選】可配置自定義 icon (只支持 fontawesome 圖標, 也可以配置 no-icon )style【可選】可以覆蓋配置中的 style(simple/modern/flat/disabled)simple 123456789101112131415161718192021{% note 'fab fa-cc-visa' simple %}你是刷 Visa 還是 UnionPay{% endnote %}{% note blue 'fas fa-bullhorn' simple %}2021年快到了....{% endnote %}{% note pink 'fas fa-car-crash' simple %}小心開車 安全至上{% endnote %}{% note red 'fas fa-fan' simple%}這是三片呢?還是四片?{% endnote %}{% note orange 'fas fa-battery-half' simple %}你是刷 Visa 還是 UnionPay{% endnote %}{% note purple 'far fa-hand-scissors' simple %}剪刀石頭布{% endnote %}{% note green 'fab fa-internet-explorer' simple %}前端最討厭的瀏覽器{% endnote %}你是刷 Visa 還是 UnionPay 2021年快到了.... 小心開車 安全至上 這是三片呢?還是四片? 你是刷 Visa 還是 UnionPay 剪刀石頭布 前端最討厭的瀏覽器 modern 123456789101112131415161718192021{% note 'fab fa-cc-visa' modern %}你是刷 Visa 還是 UnionPay{% endnote %}{% note blue 'fas fa-bullhorn' modern %}2021年快到了....{% endnote %}{% note pink 'fas fa-car-crash' modern %}小心開車 安全至上{% endnote %}{% note red 'fas fa-fan' modern%}這是三片呢?還是四片?{% endnote %}{% note orange 'fas fa-battery-half' modern %}你是刷 Visa 還是 UnionPay{% endnote %}{% note purple 'far fa-hand-scissors' modern %}剪刀石頭布{% endnote %}{% note green 'fab fa-internet-explorer' modern %}前端最討厭的瀏覽器{% endnote %}你是刷 Visa 還是 UnionPay 2021年快到了.... 小心開車 安全至上 這是三片呢?還是四片? 你是刷 Visa 還是 UnionPay 剪刀石頭布 前端最討厭的瀏覽器 flat 123456789101112131415161718192021{% note 'fab fa-cc-visa' flat %}你是刷 Visa 還是 UnionPay{% endnote %}{% note blue 'fas fa-bullhorn' flat %}2021年快到了....{% endnote %}{% note pink 'fas fa-car-crash' flat %}小心開車 安全至上{% endnote %}{% note red 'fas fa-fan' flat%}這是三片呢?還是四片?{% endnote %}{% note orange 'fas fa-battery-half' flat %}你是刷 Visa 還是 UnionPay{% endnote %}{% note purple 'far fa-hand-scissors' flat %}剪刀石頭布{% endnote %}{% note green 'fab fa-internet-explorer' flat %}前端最討厭的瀏覽器{% endnote %}你是刷 Visa 還是 UnionPay 2021年快到了.... 小心開車 安全至上 這是三片呢?還是四片? 你是刷 Visa 還是 UnionPay 剪刀石頭布 前端最討厭的瀏覽器 disabled 123456789101112131415161718192021{% note 'fab fa-cc-visa' disabled %}你是刷 Visa 還是 UnionPay{% endnote %}{% note blue 'fas fa-bullhorn' disabled %}2021年快到了....{% endnote %}{% note pink 'fas fa-car-crash' disabled %}小心開車 安全至上{% endnote %}{% note red 'fas fa-fan' disabled %}這是三片呢?還是四片?{% endnote %}{% note orange 'fas fa-battery-half' disabled %}你是刷 Visa 還是 UnionPay{% endnote %}{% note purple 'far fa-hand-scissors' disabled %}剪刀石頭布{% endnote %}{% note green 'fab fa-internet-explorer' disabled %}前端最討厭的瀏覽器{% endnote %}你是刷 Visa 還是 UnionPay 2021年快到了.... 小心開車 安全至上 這是三片呢?還是四片? 你是刷 Visa 還是 UnionPay 剪刀石頭布 前端最討厭的瀏覽器 no-icon 123456789101112131415161718192021{% note no-icon %}你是刷 Visa 還是 UnionPay{% endnote %}{% note blue no-icon %}2021年快到了....{% endnote %}{% note pink no-icon %}小心開車 安全至上{% endnote %}{% note red no-icon %}這是三片呢?還是四片?{% endnote %}{% note orange no-icon %}你是刷 Visa 還是 UnionPay{% endnote %}{% note purple no-icon %}剪刀石頭布{% endnote %}{% note green no-icon %}前端最討厭的瀏覽器{% endnote %}你是刷 Visa 還是 UnionPay 2021年快到了.... 小心開車 安全至上 這是三片呢?還是四片? 你是刷 Visa 還是 UnionPay 剪刀石頭布 前端最討厭的瀏覽器 Gallery相冊圖庫2.2.0以上提供 一個圖庫集合。 寫法 12345{% galleryGroup name description link img-url %}{% galleryGroup name description link img-url %}{% galleryGroup name description link img-url %}name:圖庫名字description:圖庫描述link:連接到對應相冊的地址img-url:圖庫封面的地址例如: 12345{% galleryGroup '壁紙' '收藏的一些壁紙' '/Gallery/wallpaper' https://i.loli.net/2019/11/10/T7Mu8Aod3egmC4Q.png %}{% galleryGroup '漫威' '關於漫威的圖片' '/Gallery/marvel' https://i.loli.net/2019/12/25/8t97aVlp4hgyBGu.jpg %}{% galleryGroup 'OH MY GIRL' '關於OH MY GIRL的圖片' '/Gallery/ohmygirl' https://i.loli.net/2019/12/25/hOqbQ3BIwa6KWpo.jpg %}![]() 收藏的一些壁紙 ![]() 關於漫威的圖片 ![]() 關於OH MY GIRL的圖片 Gallery相冊2.0.0 以上提供 區別於舊版的Gallery相冊,新的 Gallery 相冊會自動根據圖片長度進行排版,書寫也更加方便,與 markdown 格式一樣。可根據需要插入到相應的 md。 寫法: 123{% gallery [lazyload],[rowHeight],[limit] %}markdown 圖片格式{% endgallery %}參數解釋lazyload【可選】點擊按鈕加載更多圖片,填寫 true/false。默認為 false。rowHeight【可選】圖片顯示的高度,如果需要一行顯示更多的圖片,可設置更小的數字。默認為 220。limit【可選】每次加載多少張照片。默認為 10。示例 1234567891011{% gallery %}markdown 圖片格式{% endgallery %}{% gallery true,220,10 %}markdown 圖片格式{% endgallery %}{% gallery true,,10 %}markdown 圖片格式{% endgallery %}例如 12345678910{% gallery %}![](https://i.loli.net/2019/12/25/Fze9jchtnyJXMHN.jpg)![](https://i.loli.net/2019/12/25/ryLVePaqkYm4TEK.jpg)![](https://i.loli.net/2019/12/25/gEy5Zc1Ai6VuO4N.jpg)![](https://i.loli.net/2019/12/25/d6QHbytlSYO4FBG.jpg)![](https://i.loli.net/2019/12/25/6nepIJ1xTgufatZ.jpg)![](https://i.loli.net/2019/12/25/E7Jvr4eIPwUNmzq.jpg)![](https://i.loli.net/2019/12/25/mh19anwBSWIkGlH.jpg)![](https://i.loli.net/2019/12/25/2tu9JC8ewpBFagv.jpg){% endgallery %}[{"url":"https://i.loli.net/2019/12/25/Fze9jchtnyJXMHN.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/ryLVePaqkYm4TEK.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/gEy5Zc1Ai6VuO4N.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/d6QHbytlSYO4FBG.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/6nepIJ1xTgufatZ.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/E7Jvr4eIPwUNmzq.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/mh19anwBSWIkGlH.jpg","alt":""},{"url":"https://i.loli.net/2019/12/25/2tu9JC8ewpBFagv.jpg","alt":""}]寫法: 12{% gallery url,[link],[lazyload],[rowHeight],[limit] %}{% endgallery %}參數解釋url【必須】 識別詞link【必須】遠程的 json 鏈接lazyload【可選】點擊按鈕加載更多圖片,填寫 true/false。默認為 false。rowHeight【可選】圖片顯示的高度,如果需要一行顯示更多的圖片,可設置更小的數字。默認為 220。limit【可選】每次加載多少張照片。默認為 10。遠程鏈接 Json 的例子 有三個參數,url是必須存在的,alt 和 title 可有,也可沒有。 12345678910111213141516171819[ { "url": "https://cdn.jsdelivr.net/gh/jerryc127/CDN/img/IMG_0556.jpg", "alt": "IMG_0556.jpg", "title": "這是title" }, { "url": "https://cdn.jsdelivr.net/gh/jerryc127/CDN/img/IMG_0472.jpg", "alt": "IMG_0472.jpg" }, { "url": "https://cdn.jsdelivr.net/gh/jerryc127/CDN/img/IMG_0453.jpg", "alt": "" }, { "url": "https://cdn.jsdelivr.net/gh/jerryc127/CDN/img/IMG_0931.jpg", "alt": "" }]示例 12345678{% gallery url,https://xxxx.com/sss.json %}{% endgallery %}{% gallery url,https://xxxx.com/sss.json,true,220,10 %}{% endgallery %}{% gallery url,https://xxxx.com/sss.json,true,,10 %}{% endgallery %}tag-hide2.2.0以上提供 請注意,tag-hide內的標簽外掛content內都不建議有h1 - h6 等標題。因為Toc會把隱藏內容標題也顯示出來,而且當滾動屏幕時,如果隱藏內容沒有顯示出來,會導致Toc的滾動出現異常。 如果你想把一些文字、內容隱藏起來,並提供按鈕讓用户點擊顯示。可以使用這個標籤外掛。 inline 在文本里面添加按鈕隱藏內容,只限文字 ( content不能包含英文逗號,可用‚) 1{% hideInline content,display,bg,color %}content: 文本內容 display: 按鈕顯示的文字(可選) bg: 按鈕的背景顏色(可選) color: 按鈕文字的顏色(可選) Demo 123哪個英文字母最酷? {% hideInline 因為西裝褲(C裝酷),查看答案,#FF7242,#fff %}門裏站着一個人? {% hideInline 閃 %}哪個英文字母最酷? 因為西裝褲(C裝酷) 門裏站着一個人? 閃 block獨立的block隱藏內容,可以隱藏很多內容,包括圖片,代碼塊等等 ( display 不能包含英文逗號,可用‚) 123{% hideBlock display,bg,color %}content{% endhideBlock %}content: 文本內容display: 按鈕顯示的文字(可選)bg: 按鈕的背景顏色(可選)color: 按鈕文字的顏色(可選)Demo 1234查看答案{% hideBlock 查看答案 %}傻子,怎麼可能有答案{% endhideBlock %}查看答案 傻子,怎麼可能有答案 2.3.0以上支持 如果你需要展示的內容太多,可以把它隱藏在收縮框裏,需要時再把它展開。 ( display 不能包含英文逗號,可用‚) 123{% hideToggle display,bg,color %}content{% endhideToggle %}Demo 12345678910{% hideToggle Butterfly安裝方法 %}在你的博客根目錄裏git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/Butterfly如果想要安裝比較新的dev分支,可以git clone -b dev https://github.com/jerryc127/hexo-theme-butterfly.git themes/Butterfly{% endhideToggle %}Butterfly安裝方法在你的博客根目錄裏 git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/Butterfly 如果想要安裝比較新的dev分支,可以 git clone -b dev https://github.com/jerryc127/hexo-theme-butterfly.git themes/Butterfly mermaid使用mermaid標籤可以繪製Flowchart(流程圖)、Sequence diagram(時序圖 )、Class Diagram(類別圖)、State Diagram(狀態圖)、Gantt(甘特圖)和Pie Chart(圓形圖),具體可以查看mermaid文檔 修改 主題配置文件 12345678# mermaid# see https://github.com/mermaid-js/mermaidmermaid: enable: true # built-in themes: default/forest/dark/neutral theme: light: default dark: dark寫法: 123{% mermaid %}內容{% endmermaid %}例如: 12345678{% mermaid %}pie title Key elements in Product X "Calcium" : 42.96 "Potassium" : 50.05 "Magnesium" : 10.01 "Iron" : 5{% endmermaid %}移植於next主題 使用方法 123456789101112131415161718192021{% tabs Unique name, [index] %}Any content (support inline tags too).{% endtabs %}Unique name : Unique name of tabs block tag without comma. Will be used in #id's as prefix for each tab with their index numbers. If there are whitespaces in name, for generate #id all whitespaces will replaced by dashes. Only for current url of post/page must be unique![index] : Index number of active tab. If not specified, first tab (1) will be selected. If index is -1, no tab will be selected. It's will be something like spoiler. Optional parameter.[Tab caption] : Caption of current tab. If not caption specified, unique name with tab index suffix will be used as caption of tab. If not caption specified, but specified icon, caption will empty. Optional parameter.[@icon] : FontAwesome icon name (full-name, look like 'fas fa-font') Can be specified with or without space; e.g. 'Tab caption @icon' similar to 'Tab caption@icon'. Optional parameter.Demo 1 - 預設選擇第一個【默認】 12345678910111213{% tabs test1 %}**This is Tab 1.****This is Tab 2.****This is Tab 3.**{% endtabs %}This is Tab 1. This is Tab 2. This is Tab 3. Demo 2 - 預設選擇tabs 12345678910111213{% tabs test2, 3 %}**This is Tab 1.****This is Tab 2.****This is Tab 3.**{% endtabs %}This is Tab 1. This is Tab 2. This is Tab 3. Demo 3 - 沒有預設值 12345678910111213{% tabs test3, -1 %}**This is Tab 1.****This is Tab 2.****This is Tab 3.**{% endtabs %}This is Tab 1. This is Tab 2. This is Tab 3. Demo 4 - 自定義Tab名 + 只有icon + icon和Tab名 12345678910111213{% tabs test4 %}**tab名字為第一個Tab****只有圖標 沒有Tab名字****名字+icon**{% endtabs %}tab名字為第一個Tab 只有圖標 沒有Tab名字 名字+icon Button3.0以上適用 使用方法: 12345678910111213141516{% btn [url],[text],[icon],[color] [style] [layout] [position] [size] %}[url] : 鏈接[text] : 按鈕文字[icon] : [可選] 圖標[color] : [可選] 按鈕背景顔色(默認style時) 按鈕字體和邊框顔色(outline時) default/blue/pink/red/purple/orange/green[style] : [可選] 按鈕樣式 默認實心 outline/留空[layout] : [可選] 按鈕佈局 默認為line block/留空[position] : [可選] 按鈕位置 前提是設置了layout為block 默認為左邊 center/right/留空[size] : [可選] 按鈕大小 larger/留空Demo 12345This is my website, click the button {% btn 'https://butterfly.js.org/',Butterfly %}This is my website, click the button {% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right %}This is my website, click the button {% btn 'https://butterfly.js.org/',Butterfly,,outline %}This is my website, click the button {% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,outline %}This is my website, click the button {% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,larger %}This is my website, click the button ButterflyThis is my website, click the button ButterflyThis is my website, click the button ButterflyThis is my website, click the button ButterflyThis is my website, click the button Butterfly 123{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,block %}{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,block center larger %}{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,block right outline larger %} Butterfly Butterfly Butterflymore than one button in center 1234567{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,larger %}{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,blue larger %}{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,pink larger %}{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,red larger %}{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,purple larger %}{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,orange larger %}{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,green larger %} Butterfly Butterfly Butterfly Butterfly Butterfly Butterfly Butterfly123456789{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,outline larger %}{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,outline blue larger %}{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,outline pink larger %}{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,outline red larger %}{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,outline purple larger %}{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,outline orange larger %}{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,outline green larger %} Butterfly Butterfly Butterfly Butterfly Butterfly Butterfly ButterflyinlineImg主題中的圖片都是默認以塊級元素顯示,如果你想以內聯元素顯示,可以使用這個標簽外掛。 1234{% inlineImg [src] [height] %}[src] : 圖片鏈接[height] : 圖片高度限制【可選】Demo 12345你看我長得漂亮不![](https://i.loli.net/2021/03/19/2P6ivUGsdaEXSFI.png)我覺得很漂亮 {% inlineImg https://i.loli.net/2021/03/19/5M4jUB3ynq7ePgw.png 150px %}由於 hexo 的渲染限制, 在段落開頭使用 label 標籤外掛會出現一些問題。例如:連續開頭使用 label 標籤外掛的段落無法換行 建議 不要 在段落開頭使用 label 標籤外掛 高亮所需的文字 1{% label text color %}參數解釋text文字color【可選】背景顏色,默認為 defaultdefault/blue/pink/red/purple/orange/greenDemo 12臣亮言:{% label 先帝 %}創業未半,而{% label 中道崩殂 blue %}。今天下三分,{% label 益州疲敝 pink %},此誠{% label 危急存亡之秋 red %}也!然侍衞之臣,不懈於內;{% label 忠志之士 purple %},忘身於外者,蓋追先帝之殊遇,欲報之於陛下也。誠宜開張聖聽,以光先帝遺德,恢弘志士之氣;不宜妄自菲薄,引喻失義,以塞忠諫之路也。宮中、府中,俱為一體;陟罰臧否,不宜異同。若有{% label 作奸 orange %}、{% label 犯科 green %},及為忠善者,宜付有司,論其刑賞,以昭陛下平明之治;不宜偏私,使內外異法也。臣亮言:先帝 創業未半,而中道崩殂 。今天下三分,益州疲敝 ,此誠危急存亡之秋 也!然侍衞之臣,不懈於內;忠志之士 ,忘身於外者,蓋追先帝之殊遇,欲報之於陛下也。誠宜開張聖聽,以光先帝遺德,恢弘志士之氣;不宜妄自菲薄,引喻失義,以塞忠諫之路也。 宮中、府中,俱為一體;陟罰臧否,不宜異同。若有作奸 、犯科 ,及為忠善者,宜付有司,論其刑賞,以昭陛下平明之治;不宜偏私,使內外異法也。 timeline4.0.0 以上支持 12345678{% timeline title,color %}xxxxxxxxxx{% endtimeline %}參數解釋title標題/時間線colortimeline 顏色default(留空) / blue / pink / red / purple / orange / greenDemo 12345{% timeline 2022 %}這是測試頁面{% endtimeline %}2022 01-02 這是測試頁面 12345{% timeline 2022,blue %}這是測試頁面{% endtimeline %}2022 01-02 這是測試頁面 12345{% timeline 2022,pink %}這是測試頁面{% endtimeline %}2022 01-02 這是測試頁面 12345{% timeline 2022,red %}這是測試頁面{% endtimeline %}2022 01-02 這是測試頁面 12345{% timeline 2022,purple %}這是測試頁面{% endtimeline %}2022 01-02 這是測試頁面 12345{% timeline 2022,orange %}這是測試頁面{% endtimeline %}2022 01-02 這是測試頁面 12345{% timeline 2022,green %}這是測試頁面{% endtimeline %}2022 01-02 這是測試頁面 flink4.1.0 支持 可在任何界面插入類似友情鏈接列表效果 內容格式與友情鏈接界面一樣,支持 yml 格式 123{% flink %}xxxxxx{% endflink %}Demo 1234567891011121314151617181920212223242526272829{% flink %}- class_name: 友情鏈接 class_desc: 那些人,那些事 link_list: - name: JerryC link: https://jerryc.me/ avatar: https://jerryc.me/img/avatar.png descr: 今日事,今日畢 - name: Hexo link: https://hexo.io/zh-tw/ avatar: https://d33wubrfki0l68.cloudfront.net/6657ba50e702d84afb32fe846bed54fba1a77add/827ae/logo.svg descr: 快速、簡單且強大的網誌框架- class_name: 網站 class_desc: 值得推薦的網站 link_list: - name: Youtube link: https://www.youtube.com/ avatar: https://i.loli.net/2020/05/14/9ZkGg8v3azHJfM1.png descr: 視頻網站 - name: Weibo link: https://www.weibo.com/ avatar: https://i.loli.net/2020/05/14/TLJBum386vcnI1P.png descr: 中國最大社交分享平台 - name: Twitter link: https://twitter.com/ avatar: https://i.loli.net/2020/05/14/5VyHPQqR6LWF39a.png descr: 社交分享平台{% endflink %}在頁面上渲染樂譜 修改 主題配置文件 123456# abcjs (樂譜渲染)# See https://github.com/paulrosen/abcjs# ---------------abcjs: enable: true per_page: true寫法: 123{% score %}樂譜代碼{% endscore %}Demo 12345678910111213141516{% score %}X:1T:alternate headsM:CL:1/8U:n=!style=normal!K:C treble style=rhythm"Am" BBBB B2 B>B | "Dm" B2 B/B/B "C" B4 |"Am" B2 nGnB B2 nGnA | "Dm" nDB/B/ nDB/B/ "C" nCB/B/ nCB/B/ |B8| B0 B0 B0 B0 |]%%text This translates to:[M:C][K:style=normal][A,EAce][A,EAce][A,EAce][A,EAce] [A,EAce]2 [A,EAce]>[A,EAce] |[DAdf]2 [DAdf]/[DAdf]/[DAdf] [CEGce]4 |[A,EAce]2 GA [A,EAce] GA |D[DAdf]/[DAdf]/ D[DAdf]/[DAdf]/ C [CEGce]/[CEGce]/ C[CEGce]/[CEGce]/ |[CEGce]8 | [CEGce]2 [CEGce]2 [CEGce]2 [CEGce]2 |]GAB2 !style=harmonic![gb]4|GAB2 [K: style=harmonic]gbgb|[K: style=x]C/A,/ C/C/E C/zz2|w:Rock-y did-nt like that{% endscore %}X:1 T:alternate heads M:C L:1/8 U:n=!style=normal! K:C treble style=rhythm "Am" BBBB B2 B>B | "Dm" B2 B/B/B "C" B4 |"Am" B2 nGnB B2 nGnA | "Dm" nDB/B/ nDB/B/ "C" nCB/B/ nCB/B/ |B8| B0 B0 B0 B0 |] %%text This translates to: [M:C][K:style=normal] [A,EAce][A,EAce][A,EAce][A,EAce] [A,EAce]2 [A,EAce]>[A,EAce] |[DAdf]2 [DAdf]/[DAdf]/[DAdf] [CEGce]4 |[A,EAce]2 GA [A,EAce] GA |D[DAdf]/[DAdf]/ D[DAdf]/[DAdf]/ C [CEGce]/[CEGce]/ C[CEGce]/[CEGce]/ |[CEGce]8 | [CEGce]2 [CEGce]2 [CEGce]2 [CEGce]2 |] GAB2 !style=harmonic![gb]4|GAB2 [K: style=harmonic]gbgb| [K: style=x] C/A,/ C/C/E C/zz2| w:Rock-y did-nt like thatseries 系列文章在頁面上顯示系列文章 修改 主題配置文件 12345series: enable: true orderBy: 'title' # Order by title or date order: 1 # Sort of order. 1, asc for ascending; -1, desc for descending number: true寫法: 12{% series %}{% series [series name] %}在文章的 front-matter 上添加參數 series,並給與一個標識 使用此標簽外掛,會把相同標識的文章以列表的形式展示 如果不寫 series 標識,則默認為你使用此標簽外掛所在的文章的 series 標識 Demo 1{% series markdown %} |
今日新闻 |
推荐新闻 |
CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |