Back your Freshdesk Help Center in git. Modify articles locally, and deploy directly to Freshdesk.
Goals of this project:
- Back Help Center locally (via git), not Freshdesk
- Give revision control of articles
- Reviewing article edits/changes made simpler
- Platform flexibility to be able to switch away from Freshdesk
Note: Images will be backed by Amazon S3 so you will need an AWS account for the images to no longer be owned by Freshdesk.
- Python 2.7
- Add environment variables:
- Local article path:
FRESHDESK_LOCAL_PATH
- Cloudfront URL:
FRESHDESK_CLOUDFRONT_URL
- Freshdesk subdomain:
FRESHDESK_DOMAIN
- Freshdesk agent API key:
FRESHDESK_API_KEY
- Freshdesk AWS bucket name:
FRESHDESK_BUCKET_NAME
- AWS Access Key:
AWS_ACCESS_KEY
- AWS Secret Key:
AWS_SECRET_KEY
- Local article path:
Before locally editing articles and images, always run freshdesk-track
.
This allows for local viewing of content. All local content is available in the
"out" folder. To quit freshdesk-track
, type CTRL+C.
- Run
freshdesk-create
with the Freshdesk category and folder IDs as the parameters. - Add the title to the file
title.html
. - Open the file
index.html
and write the article.- For images, enter:
img src="<image_name>"
with the appropriate file type at the end (png, jpg, jpeg, gif). - For links to other articles, enter:
a href="<article_id>"
with the ID of the article you want to link to inserted.
- For images, enter:
- Ensure
freshdesk-track
is running. If it wasn't, run it now. - Once the article is complete, open the version of the article in the "out" folder for local viewing. This will provide a basic HTML view in your preferred browser.
- When you are ready to publish your changes, you have two options:
- To deploy a single article, run
freshdesk-deploy
with the article ID as the parameter. - To deploy all the articles, run
freshdesk-deploy
with no parameters.
- To deploy a single article, run
- Commit all changes that you make in the "posts" folder to GitHub to ensure revision control and allow others to review your changes.
To edit past articles, simply edit the HTML files with freshdesk-track
running. Local edits can be viewed in the "out" folder and use freshdesk-deploy
as
outlined above to publish the edits. The final version should also be commited to GitHub.
BSD 3-Clause, see accompanying LICENSE file.