2.0.1 • Published 4 years ago

ghost-storage-github v2.0.1

Weekly downloads
2
License
MIT
Repository
github
Last release
4 years ago

ghost-storage-github

GitHub storage adapter for Ghost. Good for blogs hosted on platforms without a persistent filesystem (i.e. Heroku).

Installation

cd /path/to/your/ghost/installation
npm install ghost-storage-github
mkdir -p content/adapters/storage
cp -r node_modules/ghost-storage-github content/adapters/storage/ghost-storage-github

Usage

Add the following to your configuration file and modify it accordingly.

"storage": {
    "active": "ghost-storage-github",
    "ghost-storage-github": {
        "token": "<your token here>",
        "owner": "<your username here>",
        "repo": "ghost-assets",
        "branch": "master",
        "destination": "my/subdirectory",
        "baseUrl": "https://cdn.example.com",
        "useRelativeUrls": false
    }
}

Here's a comprehensive list of configurations:

NameRequired?DescriptionEnvironment variable (prefixed with GHOST_GITHUB_)
baseUrlnoBase URL of newly saved images. Uses raw.githubusercontent.com by defaultBASE_URL
branchnoBranch to push assets to. Defaults to masterBRANCH
destinationnoDirectory to push assets to. Defaults to /DESTINATION
owneryesUsername of the user/organization the repo is underOWNER
repoyesName of the repoREPO
tokenyesYour personal access tokenTOKEN
useRelativeUrlsnoWhether or not to return relative URLs (i.e. under /content/images) instead of absolute URLs. Might be of use to people who generate and serve a static version of their Ghost blog.USE_RELATIVE_URLS

Questions

How do I get a personal access token?

  1. Create a new personal token here.
  2. Select 'repo' (which will select everything under repo), as ghost-storage-github will need access to your repository.
  3. Copy the token that shows up upon successful creation, and paste that into the token field of ghost-storage-github's configuration.

I'm getting a "Bad credentials" error. What should I do?

Your token or password might be incorrect. You should double-check your configuration.

I'm getting a "Not found" error. What should I do?

Make sure the repository you specified exists. Also, check to make sure the branch (if specified) exists in the repo.

License

MIT