Title: Gitdown: Git Repository to WordPress Blog Posts
Author: Maxim Maeder
Published: <strong>2023 年 3 月 4 日</strong>
Last modified: 2024 年 3 月 24 日

---

搜尋外掛

![](https://ps.w.org/gitdown/assets/banner-772x250.png?rev=2905268)

這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個
外掛進行維護或提供技術支援，並可能會與更新版本的 WordPress 產生使用上的相容性問題。

![](https://ps.w.org/gitdown/assets/icon.svg?rev=2905274)

# Gitdown: Git Repository to WordPress Blog Posts

 由 [Maxim Maeder](https://profiles.wordpress.org/maximmaeder/) 開發

[下載](https://downloads.wordpress.org/plugin/gitdown.1.6.1.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/gitdown/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/gitdown/#reviews)
 * [開發資訊](https://tw.wordpress.org/plugins/gitdown/#developers)

 [技術支援](https://wordpress.org/support/plugin/gitdown/)

## 外掛說明

Gitdown: Git Repository to WordPress Blog Posts

_By [Maxim Maeder](https://www.maximmaeder.com)_

Gitdown lets you connect a Remote Repository to your Website and upload Markdown
articles to your WordPress Blog.

⚠️ This plugin is still in development. If you find any issues, don’t hesitate to
report them.

#### 🎈 Easy to use

Setting Gitdown up to work with your Repository and Glob Pattern takes no time and
can be easily changed anytime.

#### 🔨 Customization

The shape of your Repository does not matter, you can change the glob pattern to
your liking, and it will understand your repo correctly.

#### 🎁 100% Free

Gitdown is free, and you can use it for whatever you want. Of course, I would be
very grateful if you link back to me or the plugin so more people know about it 
😀.

#### 📚 Documentation

Once you activate Gitdown, it will take you to the documentation page, where you
should get all the necessary info.

You can also consult the following documents for Help.

 * [FAQ](https://github.com/Maximinodotpy/Gitdown/blob/master/docs/faq.md)
 * [Frontmatter Keys](https://github.com/Maximinodotpy/Gitdown/blob/master/docs/keys.md)
 * [Example File](https://github.com/Maximinodotpy/Gitdown/blob/master/docs/example.md)
 * [API Endpoint](https://github.com/Maximinodotpy/Gitdown/blob/master/docs/api-endpoint.md)
 * ([Changelog](https://github.com/Maximinodotpy/Gitdown/blob/master/docs/changelog.md))

You will also find helpful information in the _Reports_ section of the article overview.

⚠️ It may be outdated in some parts as I am somewhat unkeen writing documentation.
Please file an Issue so I know that I need to change it.

#### 👥 Contributing

All contributions are very welcome, so feel free to make [issues](https://github.com/Maximinodotpy/Gitdown/issues),
[proposals](https://github.com/Maximinodotpy/Gitdown/issues/proposals) and [pull requests](https://github.com/Maximinodotpy/Gitdown/pulls).

I’m building this Plugin by myself, and I made it for myself, but I think it could
also be helpful for others. So if you have any ideas on how to improve it, please
let me know.

####  Links

 * [Maximmaeder.com](https://maximmaeder.com/)
 * [My Profile on WordPress.org](https://profiles.wordpress.org/maximmaeder/)
 * [Plugin Page](https://wordpress.org/plugins/gitdown)
 * [SVN repository](https://plugins.svn.wordpress.org/gitdown/)
 * [My other projects](https://demos.maximmaeder.com/)

#### 🤙 Other Software that Gitdown uses.

This plugin uses the following third Party Services and Programs.

 * _[Globster.xyz](https://globster.xyz/)_ Is used in the how-to section for Gitdown
   to teach glob patterns. ([Privacy Policy](https://globster.xyz/privacy/))
 * _[Tailwindcss](https://tailwindcss.com/)_ Is used to style the main admin UI.
 * _[Vue.js](https://vuejs.org/)_ Is used for the main admin UI and its interactivity
   features.
 * _[mnapoli/FrontYAML](https://github.com/mnapoli/FrontYAML)_ Is used to get frontmatter
   information in markdown files.
 * _[git-php](https://github.com/czproject/git-php)_ Is used to clone and fetch 
   git repositories.

## 螢幕擷圖

 * [[
 * Dashboard User Interface (Normal)
 * [[
 * Dashboard User Interface (Empty)
 * [[
 * How to View Number One
 * [[
 * How to View Number Two
 * [[
 * Gitdown Reading Settings

## 常見問題集

### Can I supply multiple glob patterns?

Yes, you can! Simply separate them by commas.

### Does Gitdown read nested categories from the markdown file?

Yes, it does! Something like `Animals/Cats`, will create these two classes in a 
nested fashion and add the last one as the category.

### Does Gitdown read tags?

Yes, It does! You can supply either a list of tags or a single tag.

### Does Gitdown support thumbnails?

Yes, It does! You simply have to provide a file called ‘preview.png’ in the same
folder as your article and it will be added as the thumbnail. This means that you
should have a folder for each article.

### Which keys and values can I provide in the Frontmatter of my Articles?

You find the description for each key [here](https://tw.wordpress.org/plugins/gitdown/keys.md?output_format=md).

### Can I also manage Pages with Gitdown

Yes, you can! simply add `post_type: page` to your frontmatter and this file will
be added as a page. You can then also define a parent page with `parent_page: <slug
of the parent page>`.

### Can Gitdown Automatically update/sync my articles?

Yes it can, simply go to the Settings and activate automatic updating there. Just
keep in mind that this could mean that you will create duplicate content by mistake
if you change the slug of your article.

### Can I connect Private Repositories?

Yes you can you will have to create an URL with the authentication. Consult the 
following links to set this up.

 * [Creating a URL to clone Private Github Repos](https://stackoverflow.com/questions/22755268/clone-a-private-repo-of-github-with-username-and-password)
 * [Creating a custom Personal Access Token](https://docs.github.com/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)

Generally the URL will have to look something like this: `https://<Username_or_Company
>:<PAT_or_Password>@github.com/<Username_or_Company>/<Repository_name>.git`

## 使用者評論

這個外掛目前沒有任何使用者評論。

## 參與者及開發者

以下人員參與了開源軟體〈Gitdown: Git Repository to WordPress Blog Posts〉的開發相關
工作。

參與者

 *   [ Maxim Maeder ](https://profiles.wordpress.org/maximmaeder/)

[將〈Gitdown: Git Repository to WordPress Blog Posts〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/gitdown)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/gitdown/)、查看
[SVN 存放庫](https://plugins.svn.wordpress.org/gitdown/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/gitdown/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/gitdown/)。

## 變更記錄

#### 1.0.1

 * Small Bugfixes
 * Removed Pull Repo Button

#### 1.0.4

 * Added Tag Insertion
 * wp_generate_attachment_metadata() -> thumbnails will get regenerated if Image
   Editor is available.

#### 1.0.5

 * Added automated updating and posting of posts (Experimental)

#### 1.0.6

 * Fix: Error when trying to clone a private repository

#### 1.2.0

 * Ability to add Pages
 * Breaking Changes

#### 1.2.1

 * Added more Warnings to Report Section (Git Clone Issues)

#### 1.4.6

 * Post Revisions
 * Better Static Resource Caching

#### 1.4.7

 * Documentation Update

#### 1.4.8

 * Documentation Update

#### 1.4.9

 * Documentation Update

#### 1.4.11

 * Swapped `CommonMarkConverter` with `GithubFlavoredConverter`

#### 1.4.12

 * Added [Heading Permalink Extension](https://commonmark.thephpleague.com/2.4/extensions/heading-permalinks/)

#### 1.4.13

 * Catch Type Error when getting Outdated Articles. ([Issue](https://github.com/Maximinodotpy/Gitdown/issues/31))

#### 1.5.0

 * Heading Permalinks removed `content` before id

#### 1.6.0

 * Added API Endpoint for Automating Post Updating

## 中繼資料

 *  版本 **1.6.1**
 *  最後更新 **2 年前**
 *  啟用安裝數 **少於 10 次**
 *  WordPress 版本需求 ** 6.1.0 或更新版本 **
 *  已測試相容的 WordPress 版本 **6.4.0**
 *  PHP 版本需求 ** 7.0 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/gitdown/)
 * 標籤:
 * [cms](https://tw.wordpress.org/plugins/tags/cms/)[Github](https://tw.wordpress.org/plugins/tags/github/)
   [markdown](https://tw.wordpress.org/plugins/tags/markdown/)[posts](https://tw.wordpress.org/plugins/tags/posts/)
 *  [進階檢視](https://tw.wordpress.org/plugins/gitdown/advanced/)

## 評分

這個項目尚無任何評論記錄。

[Your review](https://wordpress.org/support/plugin/gitdown/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/gitdown/reviews/)

## 參與者

 *   [ Maxim Maeder ](https://profiles.wordpress.org/maximmaeder/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/gitdown/)

## 贊助

想要支援這個外掛的發展嗎？

 [ 贊助這個外掛 ](https://maximmaeder.com)