基本上 Basic 是一個 Jekyll 主題,旨在取代預設的 Minima,並添加了一些增強功能:
如果您執行 Jekyll v3.5+ 並自架,您可以快速將主題安裝為 Ruby gem。如果您使用 GitHub Pages 進行託管,您可以安裝為遠端主題或直接將所有主題檔案(請參閱下面的結構)複製到您的專案中。
將此行加入 Jekyll 網站的Gemfile
:
gem "jekyll-theme-basically-basic"
將此行新增至 Jekyll 網站的_config.yml
檔案:
theme : jekyll-theme-basically-basic
然後運行 Bundler 安裝主題 gem 和依賴項:
bundle install
GitHub Pages 增加了對任何 GitHub 託管主題的全面支援。
將gem "jekyll"
替換為:
gem "github-pages" , group : :jekyll_plugins
執行bundle update
並驗證所有 gem 是否正確安裝。
將remote_theme: "mmistakes/[email protected]"
加入您的_config.yml
檔案中。刪除任何其他theme:
或remote_theme:
條目。
注意:您的 Jekyll 網站應該可以立即在 http://USERNAME.github.io 上查看。如果不是,您可以透過自訂網站來強制重建(有關更多詳細信息,請參閱下文)。
如果您在相同 GitHub 使用者名稱下託管多個基於 Jekyll 的站點,則必須使用專案頁面而不是使用者頁面。本質上,您將儲存庫重新命名為USERNAME.github.io以外的名稱,並在master
上建立一個gh-pages
分支。有關如何設定的更多詳細信息,請查看 GitHub 的文檔。
如果您分叉或下載了jekyll-theme-basically-basic
儲存庫,您可以安全地刪除下列檔案和資料夾:
.editorconfig
.gitattributes
.github
.scss-lint.yml
CHANGELOG.md
jekyll-theme-basically-basic.gemspec
LICENSE
Rakefile
README.md
screenshot.png
/docs
/example
如果您使用的是 Ruby Gem 或 Basic Basic 的遠端主題版本,則升級相當輕鬆。
要檢查您目前使用的版本,請查看您建立的網站的源代碼,您應該會看到類似以下內容:
<!--
Basically Basic Jekyll Theme 1.4.5
Copyright 2017-2018 Michael Rose - mademistakes.com | @mmistakes
Free for personal and commercial use under the MIT license
https://github.com/mmistakes/jekyll-basically-theme/blob/master/LICENSE
-->
在每個.html
檔案的頂部, /assets/css/main.css
和/assets/js/main.js
。
如果您使用 Bundler (有Gemfile
),則只需執行bundle update
即可;如果沒有,則執行gem update jekyll-theme-basically-basic
。
驗證您在_config.yml
中分配了最新版本
remote_theme: "mmistakes/[email protected]"
注意:如果省略@xxx
則將使用主題的目前master
分支。建議將remote_theme
“鎖定”在特定版本,以避免對您的網站引入重大變更。
下一步需要重建您的 GitHub Pages 站點,以便它可以下載最新的主題更新。這可以透過將提交推送到 GitHub 儲存庫來實現。
如果您目前沒有任何內容要推送,則空提交也可以完成工作:
git commit --allow-empty -m "Force rebuild of site"
如果您想充分利用 Jekyll + GitHub Pages 工作流程,那麼您需要使用 Git。要下拉主題更新,您必須先確保有上游遙控器。如果您分叉了主題的儲存庫,那麼您很可能就可以開始了。
要仔細檢查,請執行git remote -v
並驗證您是否可以從origin https://github.com/mmistakes/jekyll-theme-basically-basic.git
取得。
要新增它,您可以執行以下操作:
git remote add upstream https://github.com/mmistakes/jekyll-theme-basically-basic.git
現在您可以使用以下命令提取對主題的master
分支所做的任何提交:
git pull upstream master
根據分叉後您進行的自訂數量,可能會出現合併衝突。處理任何衝突的文件 Git 標誌,暫存您希望保留的更改,然後提交它們。
處理更新的另一種方法是下載主題——手動用新的佈局、包含內容和資源替換佈局、包含內容和資源。為了確保您不會錯過任何更改,最好查看主題的提交歷史記錄以了解此後發生的更改。
以下是您需要注意的重要資料夾/文件的快速清單:
姓名 | |
---|---|
_layouts | 全部更換。如果您自訂了任何佈局,請套用編輯。 |
_includes | 全部更換。如果您自訂了任何包含內容,則套用編輯。 |
assets | 全部更換。如果您自訂了樣式表或腳本,則套用編輯。 |
_sass | 全部更換。如果您自訂了 Sass 部分,則套用編輯。 |
_data/theme.yml | 安全保存。驗證是否沒有重大的結構變化或添加。 |
_config.yml | 安全保存。驗證是否沒有重大的結構變化或添加。 |
注意:如果您沒有看到最新版本,請務必刷新瀏覽器和 CDN 快取。根據您的託管環境,舊版的/assets/css/main.css
、 /assets/js/main.js
或*.html
可能會被快取。
佈局、包含、Sass 部分和資料檔案都放置在其預設位置。樣式表和腳本位於assets
中,以及專案根目錄中的一些開發相關文件。
請注意:如果您透過 Ruby Gem 方法安裝 Basic Basic,則/_layouts
、 /_includes
、 /_sass
和/assets
中找到的主題檔案將會遺失。這是正常的,因為它們與jekyll-theme-basically-basic
gem 捆綁在一起。
jekyll-theme-basically-basic
├── _data # data files
| └── theme.yml # theme settings and custom text
├── _includes # theme includes and SVG icons
├── _layouts # theme layouts (see below for details)
├── _sass # Sass partials
├── assets
| ├── javascripts
| | └── main.js
| └── stylesheets
| └── main.scss
├── _config.yml # sample configuration
└── index.md # sample home page (all posts/not paginated)
建立Gemfile
並安裝主題後,您需要新增和編輯以下檔案:
_config.yml
/_data/theme.yml
index.md
注意:有關如何在主頁啟用分頁功能的說明,請參閱下面的分頁文件。
jekyll new
開始使用jekyll new
命令將使您能夠以最快的速度啟動並運行。
請按照上面的說明編輯_config.yml
並建立_data/theme.yml
,然後就可以開始了。
網站範圍的元素( lang
、 title
、 description
、 logo
、 author
等)的配置發生在專案的_config.yml
中。請參閱此儲存庫中的範例配置以取得更多參考。
描述 | |
---|---|
lang | 用於指示文字的語言(例如 en-US、en-GB、fr) |
title | 您網站的標題(例如,Dungan's Awesome Site) |
description | 簡短的網站描述(例如,關於grasshopper mash的部落格) |
url | 您網站的完整 URL(例如,https://groverloaf.org) |
author | 全球作者資訊(見下文) |
logo | 站點範圍標誌的路徑 ~100x100px(例如,/assets/your-company-logo.png) |
twitter_username | 網站範圍內的 Twitter 用戶名,用作側邊欄中的鏈接 |
github_username | 網站範圍的 GitHub 用戶名,用作側邊欄中的鏈接 |
如需更多設定選項,請務必查閱下列文件: jekyll-seo-tag 、 jekyll-feed 、 jekyll-paginate和jekyll-sitemap 。
此主題有六種不同的皮膚(顏色變化)。若要變更外觀,請將以下內容之一新增至您的/_data/theme.yml
檔案:
skin: default | skin: night | skin: plum |
---|---|---|
skin: sea | skin: soft | skin: steel |
---|---|---|
此主題可讓您在整個主題中輕鬆使用 Google 字體。只需將以下內容新增至您的/_data/theme.yml
中,並相應地替換字體name
和weights
。
google_fonts :
- name : " Fira Sans "
weights : " 400,400i,600,600i "
- name : " Fira Sans Condensed "
要更改整個主題中的文本,請將以下內容新增至/_data/theme.yml
檔案並根據需要進行自訂。
t :
skip_links : " Skip links "
skip_primary_nav : " Skip to primary navigation "
skip_content : " Skip to content "
skip_footer : " Skip to footer "
menu : " Menu "
search : " Search "
site_search : " Site Search "
results_found : " Result(s) found "
search_placeholder_text : " Enter your search term... "
home : " Home "
newer : " Newer "
older : " Older "
email : " Email "
subscribe : " Subscribe "
read_more : " Read More "
posts : " Posts "
page : " Page "
of : " of "
min_read : " min read "
present : " Present "
cv_awards : " Awards "
cv_summary_contact : " Contact "
cv_summary_contact_email : " Email "
cv_summary_contact_phone : " Phone "
cv_summary_contact_website : " Website "
cv_location : " Location "
cv_education : " Education "
cv_education_courses : " Courses "
cv_interests : " Interests "
cv_languages : " Languages "
cv_publications : " Publications "
cv_references : " References "
cv_skills : " Skills "
cv_volunteer : " Volunteer "
cv_work : " Work "
預設情況下,所有帶有title
的內部頁面都會新增到「畫布外」選單中。要更精細地控制和排序這些選單連結:
透過將navigation_pages
數組新增至/_data/theme.yml
檔案來建立自訂清單以覆寫預設設定。
按照您想要的順序新增原始頁面路徑:
navigation_pages :
- about.md
- cv.md
每個選單連結的標題和 URL 將分別根據其title
和permalink
進行填充。
將貼文的主要列表分解為較小的列表,並透過啟用分頁將它們顯示在多個頁面上。
將jekyll-paginate
外掛程式包含在您的Gemfile
中。
group :jekyll_plugins do
gem "jekyll-paginate"
end
將jekyll-paginate
加入_config.yml
檔案中的gems
陣列以及以下分頁設定:
paginate : 5 # amount of posts to show per page
paginate_path : /page:num/
在專案的根目錄中建立index.html
(或重新命名index.md
)並新增以下前面的內容:
layout : home
paginate : true
若要啟用網站範圍的搜索,請將search: true
新增至您的_config.yml
。
預設搜尋使用Lunr建立所有文件的搜尋索引。此方法與 GitHub Pages 上託管的網站 100% 相容。
注意:只有貼文或頁面內文內容的前 50 個字才會加入到 Lunr 搜尋索引中。在_config.yml
中將search_full_content
設為true
將覆蓋此設定並可能影響頁面載入效能。
為了更快、更相關的搜尋(請參閱演示):
將jekyll-algolia
gem 加入Gemfile
的:jekyll_plugins
部分。
group :jekyll_plugins do
gem "jekyll-feed"
gem "jekyll-seo-tag"
gem "jekyll-sitemap"
gem "jekyll-paginate"
gem "jekyll-algolia"
end
完成此操作後,透過執行bundle install
下載所有依賴項。
在_config.yml
檔案中將搜尋提供者從lunr
切換到algolia
:
search_provider : algolia
將以下 Algolia 憑證加入您的_config.yml
檔案中。如果您沒有 Algolia 帳戶,您可以開設免費的社區計畫。登入後,您可以從儀表板取得您的憑證。
algolia :
application_id : # YOUR_APPLICATION_ID
index_name : # YOUR_INDEX_NAME
search_only_api_key : # YOUR_SEARCH_ONLY_API_KEY
powered_by : # true (default), false
設定憑證後,您可以使用以下命令運行索引:
ALGOLIA_API_KEY=your_admin_api_key bundle exec jekyll algolia
對於 Windows 用戶,您必須使用set
來指派ALGOLIA_API_KEY
環境變數。
set ALGOLIA_API_KEY=your_admin_api_key
bundle exec jekyll algolia
請注意, ALGOLIA_API_KEY
應設定為您的管理 API 金鑰。
若要將 Algolia 搜尋與 GitHub Pages 託管網站一起使用,請遵循此部署指南。或本指南用於在 Netlify 上進行部署。
注意: Jekyll Algolia 外掛程式可以透過多種方式進行設定。請務必查看有關如何排除文件和其他有價值的設定的完整文件。
作者資訊用作「按行」貼文的元數據,並透過_config.yml
中的以下前面內容傳播 Twitter 摘要卡的creator
欄位:
author :
name : John Doe
twitter : johndoetwitter
picture : /assets/images/johndoe.png
網站範圍的作者資訊可以以相同的方式在文件的前文中被覆蓋:
author :
name : Jane Doe
twitter : janedoetwitter
picture : /assets/images/janedoe.png
或透過在文件的前面指定site.data.authors
中存在的對應鍵。例如,文件的前面有以下內容:
author : megaman
_data/authors.yml
中有以下內容:
megaman :
name : Mega Man
twitter : megamantwitter
picture : /assets/images/megaman.png
drlight :
name : Dr. Light
twitter : drlighttwitter
picture : /assets/images/drlight.png
目前, author.picture
僅在layout: about
中使用。建議尺寸為300 x 300
像素。
若要啟用閱讀時間計數,請將read_time: true
新增至貼文或頁面的 YAML Front Matter。
或者,如果您有 Disqus 帳戶,則可以在每篇貼文下方顯示評論部分。
若要啟用 Disqus 評論,請將您的 Disqus 短名稱新增至專案的_config.yml
檔案:
disqus :
shortname : my_disqus_shortname
預設啟用註釋,並且僅在使用以下環境值建置時才會出現在生產中: JEKYLL_ENV=production
如果您不想顯示特定貼文的評論,可以透過在該貼文的前言中新增comments: false
來停用它們。
若要啟用 Google Analytics,請將您的追蹤 ID 新增至_config.yml
如下所示:
google_analytics : UA-NNNNNNNN-N
與評論類似,Google Analytics 追蹤腳本僅在使用以下環境值時才會出現在生產中: JEKYLL_ENV=production
。
預設情況下,頁腳中的版權行顯示當前年份(在建置時),後面跟著網站的標題。例如© 2018 Basically Basic.
如果您想更改此設置,請使用適當的文字將copyright
添加到您的_config.yml
檔案中:
copyright : " My custom copyright. "
主題提供了以下佈局,您可以透過在每個頁面上設定layout
Front Matter 來使用這些佈局,如下所示:
---
layout : name
---
layout: default
此佈局處理將頁面內容放置在標頭和頁腳元素之間的所有基本頁面腳手架。所有其他佈局都繼承此佈局,並在{{ content }}
區塊內提供額外的樣式和功能。
layout: post
此佈局包含以下前面的內容:
# optional alternate title to replace page.title at the top of the page
alt_title : " Basically Basic "
# optional sub-title below the page title
sub_title : " The name says it all "
# optional intro text below titles, Markdown allowed
introduction : |
Basically Basic is a Jekyll theme meant to be a substitute for the default --- [Minima](https://github.com/jekyll/minima). Conventions and features found in Minima are fully supported by **Basically Basic**.
# optional call to action links
actions :
- label : " Learn More "
icon : github # references name of svg icon, see full list below
url : " http://url-goes-here.com "
- label : " Download "
icon : download # references name of svg icon, see full list below
url : " http://url-goes-here.com "
image : # URL to a hero image associated with the post (e.g., /assets/page-pic.jpg)
# post specific author data if different from what is set in _config.yml
author :
name : John Doe
twitter : johndoetwitter
comments : false # disable comments on this post
注意:英雄圖像可以用透明的“強調”顏色覆蓋,以將它們與主題的調色板統一。若要啟用,請使用以下 Sass 變數覆寫自訂 CSS:
$intro-image-color-overlay : true;
layout: page
從視覺上看,此佈局的外觀和行為與layout: post
相同,但有兩個細微差別。
layout: home
此佈局包含與layout: page
,並添加了以下內容:
paginate : true # enables pagination loop, see section above for additional setup
entries_layout : # list (default), grid
預設情況下,貼文顯示在清單檢視中。若要變更為網格視圖,請將entries_layout: grid
新增至頁面的前面。
layout: posts
此版面配置顯示按發布年份分組的所有貼文。它容納與layout: page
。
預設情況下,貼文顯示在清單檢視中。若要變更為網格視圖,請將entries_layout: grid
新增至頁面的前面。
layout: categories
此版面配置顯示所有分組類別的貼文。它容納與layout: page
。
預設情況下,貼文顯示在清單檢視中。若要變更為網格視圖,請將entries_layout: grid
新增至頁面的前面。
layout: tags
此版面配置顯示按標籤分組的所有貼文。它容納與layout: page
。
預設情況下,貼文顯示在清單檢視中。若要變更為網格視圖,請將entries_layout: grid
新增至頁面的前面。
layout: collection
此版面配置顯示按特定集合分組的所有文件。它容納與layout: page
,並添加了以下內容:
collection : # collection name
entries_layout : # list (default), grid
show_excerpts : # true (default), false
sort_by : # date (default) title
sort_order : # forward (default), reverse
要建立一個顯示recipes
集合中所有文件的頁面,您需要在專案的根目錄中建立recipes.md
並新增以下前言:
title : Recipes
layout : collection
permalink : /recipes/
collection : recipes
預設情況下,文件以清單視圖顯示。若要變更為網格視圖,請將entries_layout: grid
新增至頁面的前面。如果您想要按標題對集合進行排序,請新增sort_by: title
。如果要反向排序,請新增sort_order: reverse
。
layout: category
此版面配置顯示按特定類別分組的所有貼文。它容納與layout: page
,並添加了以下內容:
taxonomy : # category name
entries_layout : # list (default), grid
預設情況下,貼文顯示在清單檢視中。若要變更為網格視圖,請將entries_layout: grid
新增至頁面的前面。
要建立一個顯示分配給類別foo
所有貼文的頁面,您需要在專案的根目錄中建立foo.md
並新增以下前言:
title : Foo
layout : category
permalink : /categories/foo/
taxonomy : foo
layout: tag
此版面配置顯示按特定標籤分組的所有貼文。它容納與layout: page
,並添加了以下內容:
taxonomy : # tag name
entries_layout : # list (default), grid
預設情況下,貼文顯示在清單檢視中。若要變更為網格視圖,請將entries_layout: grid
新增至頁面的前面。
要建立一個顯示分配給標籤foo bar
所有貼文的頁面,您需要在專案的根目錄中建立foo-bar.md
並新增以下前言:
title : Foo Bar
layout : tag
permalink : /tags/foo-bar/
taxonomy : foo bar
layout: about
此佈局容納與layout: page
,並添加以下內容以顯示作者圖片:
author :
name : John Doe
picture : /assets/images/johndoe.png
建議的picture
尺寸約為300 x 300
像素。如果author
物件沒有在關於頁面的前面明確設置,則主題將預設為_config.yml
中設定的值。
如果空白,則不會出現影像。
layout: cv
此佈局容納與layout: page
。它利用基於 JSON 的簡歷資料檔案標準,輕鬆輕鬆地呈現簡歷或簡歷。
只需使用 JSON Resume 的瀏覽器內簡歷建立器即可匯出 JSON 檔案並以_data/cv.json
形式儲存到您的專案中。
建議的影像尺寸(以像素為單位)如下:
影像 | 描述 | 尺寸 |
---|---|---|
page.image.path | 大型全角文檔影像。 | 高的圖像會將內容向下推到頁面上。 1600 x 600 是一個很好的中間尺寸。 |
page.image | 單獨使用時page.image.path 的簡寫(不含thumbnail 、 caption 或其他變數)。 | 與page.image.path 相同 |
page.image.thumbnail | 網格視圖中使用的小文件影像。 | 400 x 200 |
author.picture | 作者頁面圖像。 | 300 x 300 |
可以透過以下兩種方式覆寫該主題的預設結構、樣式和腳本。
可以透過將同名檔案放入項目的_includes
或_layouts
目錄來覆寫主題預設值。例如:
_includes/head.html
檔案的自訂樣式路徑或元數據,請在專案中建立_includes
目錄,將_includes/head.html
從 Basic Basic 的 gem 資料夾複製到<your_project>/_includes
並開始編輯該文件。專業提示:要在電腦上找到主題文件,請執行bundle info jekyll-theme-basically-basic
。這將返回基於 gem 的主題文件的位置。
若要覆寫預設的 Sass(位於主題的_sass
目錄中),請執行下列其中一項:
直接從Basic Basic gem 複製
bundle info jekyll-theme-basically-basic
以取得它的路徑)。/assets/stylesheets/main.scss
的內容從那裡複製到<your_project>
。<your_project>/assets/stylesheets/main.scss
中自訂您想要的內容。從此儲存庫複製。
<your_project>
。<your_project/assets/stylesheets/main.scss
中自訂您想要的內容。注意:要進行更廣泛的更改並自訂 gem 中捆綁的 Sass 部分。由於 Jekyll 目前讀取這些檔案的方式,您需要將_sass
目錄的完整內容複製到<your_project>
。
若要對主題樣式進行基本調整,可以透過新增至<your_project>/assets/stylesheets/main.scss
來覆寫 Sass 變數。例如,若要變更整個主題中使用的強調色,請新增以下內容:
$accent-color : red ;
若要覆寫主題中捆綁的預設 JavaScript,請執行下列其中一項:
直接從Basic Basic gem 複製
bundle info jekyll-theme-basically-basic
以取得它的路徑)。/assets/javascripts/main.js
的內容從那裡複製到<your_project>
。<your_project>/assets/javascripts/main.js
中自訂您想要的內容。從此儲存庫複製。
<your_project>
。<your_project>/assets/javascripts/main.js
中自訂您想要的內容。該主題使用社交網路徽標和其他保存為 SVG 的圖像,以提高效能和靈活性。所述 SVG 位於_includes
目錄中,並以icon-
為前綴。每個圖示的大小和設計都適合16 x 16
視圖框,並使用 SVGO 進行了最佳化。
圖示 | 檔案名稱 |
---|---|
圖示-箭頭-left.svg | |
圖標-箭頭-right.svg | |
圖示-bitbucket.svg | |
圖示日曆.svg | |
圖標-codepen.svg | |
圖示下載.svg | |
圖示-dribbble.svg | |
圖示-電子郵件.svg | |
圖示-facebook.svg | |
圖示-flickr.svg | |
圖標-github.svg | |
圖示-gitlab.svg | |
圖示-googleplus.svg | |
圖示-instagram.svg | |
圖標-lastfm.svg | |
圖示-linkedin.svg | |
圖示-pdf.svg | |
圖示-pinterest.svg | |
圖標-rss.svg | |
圖標-soundcloud.svg | |
圖示-stackoverflow.svg | |
圖示-秒錶.svg | |
圖示-tumblr.svg | |
圖標-twitter.svg | |
圖標-xing.svg | |
圖示-youtube.svg |
填充顏色在_sass/basically-basic/_icons.scss
部分中定義,並使用.icon-name
設置,其中類別名稱與相應的圖示匹配。
例如,Twitter 圖示的填滿顏色為#1da1f2
,如下所示:
< span class =" icon icon--twitter " > {% include icon-twitter.svg %} </ span >
除了 SVG 資源之外,還有圖示助理可協助產生社交網路連結。
包含參數 | 描述 | 必需的 |
---|---|---|
username | 給定社交網路上的用戶名 | 必需的 |
label | 用於超連結的文本 | 可選,預設為username |
例如,以下icon-github.html
包括:
{% include icon-github . html username = jekyll label = 'GitHub' %}
將輸出以下 HTML:
< a href =" https://github.com/jekyll " >
< span class =" icon icon--github " > < svg viewBox =" 0 0 16 16 " xmlns =" http://www.w3.org/2000/svg " fill-rule =" evenodd " clip-rule =" evenodd " stroke-linejoin =" round " stroke-miterlimit =" 1.414 " > < path d =" M8 0C3.58 0 0 3.582 0 8c0 3.535 2.292 6.533 5.47 7.59.4.075.547-.172.547-.385 0-.19-.007-.693-.01-1.36-2.226.483-2.695-1.073-2.695-1.073-.364-.924-.89-1.17-.89-1.17-.725-.496.056-.486.056-.486.803.056 1.225.824 1.225.824.714 1.223 1.873.87 2.33.665.072-.517.278-.87.507-1.07-1.777-.2-3.644-.888-3.644-3.953 0-.873.31-1.587.823-2.147-.09-.202-.36-1.015.07-2.117 0 0 .67-.215 2.2.82.64-.178 1.32-.266 2-.27.68.004 1.36.092 2 .27 1.52-1.035 2.19-.82 2.19-.82.43 1.102.16 1.915.08 2.117.51.56.82 1.274.82 2.147 0 3.073-1.87 3.75-3.65 3.947.28.24.54.73.54 1.48 0 1.07-.01 1.93-.01 2.19 0 .21.14.46.55.38C13.71 14.53 16 11.53 16 8c0-4.418-3.582-8-8-8 " > </ path > </ svg > </ span >
< span class =" label " > GitHub </ span >
</ a >
要設定您的環境來開發此主題:
cd
進入/example
並執行bundle install
。若要在變更主題時在本機測試主題:
cd
到儲存庫的根資料夾(例如jekyll-theme-basically-basic
)。bundle exec rake preview
並開啟瀏覽器造訪http://localhost:4000/example/
。這將使用主題的檔案和example/
目錄的內容啟動 Jekyll 伺服器。進行修改後,請刷新瀏覽器以查看任何變更。
在文件中發現拼字錯誤?有興趣添加功能或修復錯誤嗎?然後一定要提交問題或嘗試提交拉取請求。如果這是您的第一個拉取請求,閱讀 GitHub Flow 可能會有所幫助。
提交拉取請求時:
master
中建立一個分支,並給它一個有意義的名稱(例如my-awesome-new-feature
)並描述功能或修復。如果您想解決任何「容易實現的目標」(例如修復拼字錯誤、錯誤語法等),可以在/docs
和/example
資料夾中找到範例頁面。
麥可·羅斯
麻省理工學院許可證 (MIT)
版權所有 (c) 2017-2021 Michael Rose 和貢獻者
特此免費授予任何獲得本軟體和相關文件文件(「軟體」)副本的人不受限制地使用本軟體,包括但不限於使用、複製、修改、合併的權利、發布、分發、再授權和/或銷售軟體的副本,並允許向其提供軟體的人員這樣做,但須滿足以下條件:
上述版權聲明和本授權聲明應包含在本軟體的所有副本或主要部分中。
本軟體以「現況」提供,不提供任何明示或暗示的保證,包括但不限於適銷性、特定用途的適用性和不侵權的保證。 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE軟體.
基本基本包含了名詞項目中的圖示。圖示依據 Creative Commons Attribution 3.0 United States (CC BY 3.0 US) 進行分發。
基本上 Basic 包含來自 Unsplash 的照片。
基本上 Basic 包含 Susy,版權所有 (c) 2017,Miriam Eric Suzanne。 Susy 是根據 BSD 3 條款「新」或「修訂」許可證的條款分發的。
基本上Basic包含了Breakpoint。 Breakpoint 是根據 MIT/GPL 授權的條款分發的。