一个 Gatsby 初学者,用于从无头 Ghost CMS 创建博客。
将您的 Ghost 博客变成一个快速的静态网站。此 Gatsby 主题是 Ghost Handlebars 引擎的前端替代品,具有增强的 Ghost Casper 外观和感觉。所有内容均源自无头 Ghost CMS。
厌倦了
gatsby-config.js
?查看 Blogody,了解具有更多优势的集成解决方案!
更喜欢 Next.js 而不是 Gatsby?前往 next-cms-ghost!
查看教程以获取有关使用此项目的实用指南。
玩一下演示以获得第一印象。
为了方便起见,已包含以下插件:
姓名 | 版本 | 描述 |
---|---|---|
gatsby-theme-ghost-dark-mode | 深色模式切换? | |
gatsby-rehype-ghost-links | 将 CMS 链接从绝对重写为相对 | |
gatsby-rehype-prismjs | 使用 PrismJS 进行语法高亮显示 | |
gatsby-theme-ghost-members ? | 会员订阅 |
如果您不需要它们,可以在gatsby-config.js
和package.json
中将它们取出,这可能会在构建过程中节省您一些时间。
可以通过安装 Gatsby 主题或插件来集成其他功能。以下插件已经过测试可与gatsby-starter-try-ghost
一起使用:
姓名 | 版本 | 描述 |
---|---|---|
gatsby-rehype-inline-images ? | 延迟加载带有模糊效果的内联图像 | |
gatsby-theme-ghost-contact | 联系页面 | |
gatsby-theme-ghost-commento | Commento 评论系统 | |
gatsby-theme-ghost-toc ? | 目录 | |
gatsby-plugin-ackee-tracker | 使用 Acee 进行站点跟踪 | |
gatsby-plugin-google-analytics | 使用 Google Analytics 进行网站跟踪 |
通过运行安装此启动程序
gatsby new try-ghost https://github.com/styxlab/gatsby-starter-try-ghost
更改目录
cd try-ghost
跑步
yarn develop
并访问您的网站http://localhost:8000
。
//siteConfig.js
module . exports = {
// Do not include a trailing slash!
siteUrl : `https://your-blog.com` ,
// Maximum number of post shown per page
// Infinite Scroll: Initial chunk of posts, subsequent posts are fetched one by one
postsPerPage : 3 ,
// This allows an alternative site title for meta data for pages.
siteTitleMeta : `Gatsby Starter Ghost CMS` ,
// This allows an site description for meta data for pages.
siteDescriptionMeta : `Turn your Ghost blog into a flaring fast static site with Gatsby` ,
// Used for App and Offline manifest e.g. Mobile Home Screen
shortTitle : `Ghost` ,
siteIcon : `favicon.png` ,
backgroundColor : `#e9e9e9` ,
themeColor : `#15171A` ,
// Include Gatsby images for lazy loading and image optimizations (default: true)
gatsbyImages : true ,
// Overwrite navigation menu (default: []), label is case sensitive
// overwriteGhostNavigation: [{ label: `Home`, url: `/` }],
} ;
在上面显示的配置中,要更改的最重要的字段是siteUrl
、 siteTitleMeta
和siteDescriptionMeta
。至少更新那些以满足您的需求。
所有内容均源自 Ghost CMS。默认情况下,内容是从演示位置https://cms.gotsby.org
获取的。您肯定想获取自己的内容。有两种方法可以使您的内容密钥可用。根据您的构建场景选择方法。
如果您使用云提供商(例如 Gatsby、Netlify、Vercel)构建项目,最好的选择是为密钥提供环境变量:
钥匙 | 值(示例) |
---|---|
GHOST_API_URL | http://本地主机:2368 |
GHOST_CONTENT_API_KEY | 9fccdb0e4ea5b572e2e5b92942 |
您可以定义它们的位置取决于提供商,但您通常可以在站点设置下找到该选项。这避免了在公共存储库中发布密钥,并且是最安全的。
如果您在本地或在无法访问构建目录的专用网络上构建,则可以使用以下 JSON 结构在基本目录中安全地添加新的.ghost.json
文件:
{
" development " : {
" apiUrl " : " http://localhost:2368 " ,
" contentApiKey " : " 9fccdb0e4ea5b572e2e5b92942 "
},
" production " : {
" apiUrl " : " http://localhost:2368 " ,
" contentApiKey " : " 9fccdb0e4ea5b572e2e5b92942 "
}
}
该文件是.gitignore
的一部分,以避免意外将其发布到公共存储库。更改apiUrl
和contentApiKey
以匹配您自己的 Ghost CMS 内容 API 密钥。
为了获得最佳 SEO 效果,强烈建议通过在 Ghost 管理设置中选择“将此站点设为私有”标志来禁用默认的 Ghost Handlebars 主题前端。这会在 Ghost 安装之前启用密码保护并设置<meta name="robots" content="noindex" />
以便您的 Gatsby 前端成为搜索引擎的权威来源。
建议使用sudo npm install npm-upgrade -g
。切换到基本目录并使用以下命令更新所有包:
npm-upgrade
系统将提示您更新package.json
文件中的所有包。接下来,下载新包:
yarn
yarn clean
更新过程现已完成,您可以使用yarn build
(或yarn develop
)开始新的构建。
请在 gatsby-theme-try-ghost/issues 报告所有错误和问题,因为所有开发都在那里进行。
该项目与 Gatsby 或 Ghost 无关。
版权所有 (c) 2020 styxlab - 根据 MIT 许可发布。