# 获取最新文章
curl -X GET https://demo.ghost.io/ghost/api/content/posts/?key=YOUR_PUBLIC_KEY

# 响应
{
  "posts": [
    {
      "id": "5f7d8c9e...",
      "uuid": "...",
      "title": "Getting Started with Ghost",
      "html": "<p>...</p>",
      "slug": "getting-started",
      "published_at": "2026-03-30T00:00:00.000Z",
      "primary_author": { "name": "John", "slug": "john" },
      "tags": [{ "name": "Tutorial", "slug": "tutorial" }]
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 42
    }
  }
}

{{!< default}}
{{#post}}
<article class="post">
  <header class="post-header">
    <h1 class="post-title">{{title}}</h1>
    <time class="post-date">{{date published_at format="YYYY-MM-DD"}}</time>
  </header>
  
  <div class="post-content">
    {{content}}
  </div>
  
  <footer class="post-footer">
    {{#if @member}}
      <p>欢迎，{{@member.name}}！</p>
    {{else}}
      <a href="/#/portal/subscribe">订阅获取更多内容</a>
    {{/if}}
  </footer>
</article>
{{/post}}

# 1. 全局安装 Ghost CLI
npm install ghost-cli -g

# 2. 创建本地开发实例
ghost install local

# 3. 启动开发服务器
ghost start

# 4. 访问管理后台
# http://localhost:2368/ghost

# 1. 克隆代码仓库
git clone https://github.com/TryGhost/Ghost.git
cd Ghost

# 2. 安装依赖
npm install

# 3. 配置环境变量
cp .env.example .env
# 编辑 .env 设置数据库连接等

# 4. 运行数据库迁移
npm run db:migrate

# 5. 启动开发服务器
npm run dev

# docker-compose.yaml
version: '3.8'
services:
  ghost:
    image: ghost:6
    container_name: ghost-blog
    restart: unless-stopped
    ports:
      - "2368:2368"
    environment:
      url: https://your-domain.com
      database__client: mysql
      database__connection__host: mysql
      database__connection__user: ghost
      database__connection__password: ${DB_PASSWORD}
      database__connection__database: ghost
      mail__transport: SMTP
      mail__options__service: SendGrid
      mail__options__auth__user: apikey
      mail__options__auth__pass: ${SENDGRID_API_KEY}
    volumes:
      - ghost-content:/var/lib/ghost/content
    depends_on:
      - mysql

  mysql:
    image: mysql:8
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
      MYSQL_DATABASE: ghost
      MYSQL_USER: ghost
      MYSQL_PASSWORD: ${DB_PASSWORD}
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  ghost-content:
  mysql-data:

# 1. 安装 Node.js 18.x
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# 2. 安装 Nginx
sudo apt-get install -y nginx

# 3. 安装 MySQL
sudo apt-get install -y mysql-server

# 4. 创建 MySQL 数据库
mysql -u root -p
CREATE DATABASE ghost;
CREATE USER 'ghost'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON ghost.* TO 'ghost'@'localhost';
FLUSH PRIVILEGES;
EXIT;

# 5. 安装 Ghost CLI
npm install ghost-cli -g

# 6. 安装 Ghost
sudo mkdir -p /var/www/ghost
sudo chown $USER:$USER /var/www/ghost
ghost install --dbhost localhost --dbuser ghost --dbpass your_password

# 1. 创建主题目录
mkdir -p content/themes/my-theme
cd content/themes/my-theme

# 2. 初始化主题
npm init -y
npm install ghost-cli

# 3. 链接到当前 Ghost 实例进行实时预览
ghost theme watch

# 4. 激活主题
ghost theme activate my-theme

// 使用 Ghost SDK
const GhostContentAPI = require('@tryghost/content-api');

const api = new GhostContentAPI({
  url: 'https://demo.ghost.io',
  key: 'YOUR_PUBLIC_API_KEY',
  version: 'v6'
});

// 获取最新 5 篇文章
const posts = await api.posts.browse({
  limit: 5,
  include: ['author', 'tags']
});

posts.forEach(post => {
  console.log(`Title: ${post.title}`);
  console.log(`Author: ${post.primary_author.name}`);
});

const GhostAdminAPI = require('@tryghost/admin-api');

const api = new GhostAdminAPI({
  url: 'https://my-ghost-site.com',
  key: 'YOUR_ADMIN_API_KEY'
});

// 创建新文章
const newPost = await api.posts.add({
  title: 'My New Article',
  html: '<p>This is the article content.</p>',
  status: 'draft',
  tags: ['tutorial', 'ghost']
});

console.log(`Created post with ID: ${newPost.id}`);

// /custom-integrations/slack-notify/index.js
module.exports = {
  name: 'Slack Notifications',
  hooks: {
    'post.published': async (post, member, context) => {
      const webhookUrl = process.env.SLACK_WEBHOOK_URL;
      
      if (!webhookUrl) {
        console.warn('SLACK_WEBHOOK_URL not configured');
        return;
      }
      
      await fetch(webhookUrl, {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
          text: `📝 New post published: "${post.title}"`,
          blocks: [
            {
              type: 'section',
              text: {
                type: 'mrkdwn',
                text: `*New article published*\n<${post.url}|${post.title}>`
              }
            }
          ]
        })
      });
    }
  }
};

# 创建新的迁移文件
npx knex migrate:make add_custom_field_to_posts

# 编辑迁移文件
# ghost/core/server/data/migrations/versions/6.0/2026-03-30-add-custom-field.js
exports.up = async (knex) => {
  await knex.schema.alterTable('posts', (table) => {
    table.string('custom_subtitle', 255).nullable();
  });
};

exports.down = async (knex) => {
  await knex.schema.alterTable('posts', (table) => {
    table.dropColumn('custom_subtitle');
  });
};

# 运行迁移
npx knex migrate:latest

# .env 安全配置示例
NODE_ENV=production
url=https://your-ghost-site.com

# 数据库安全
database__client=mysql
database__connection__password=STRONG_RANDOM_PASSWORD

# 会话安全
SESSION_SECRET=STRONG_RANDOM_SECRET
Cookie__secure=true
Cookie__httpOnly=true

# API 安全
API_KEY=STRONG_ADMIN_API_KEY