Contains the source content for https://developer.ibm.com/datapower/blog
To write a new blog:
- If necessary,
git clone https://github.com/ibm-datapower/datapower-tutorials.git - Make a new sub-directory inside
datapower-tutorials, following existing conventions. (contact Tony or Francisco if you don't have access) - Write the post in markdown. A markdown editor makes this easier, perhaps MacDown or Atom. When you write, don't use H1, start with H2 such as
## Heading 2. If you use# Heading 1later steps won't work correctly. - Place any images inside a directory called
mediainside your post's directory - When you're done,
git commitandgit push. and ask for review. - Create a new post in the http://developer.ibm.com/datapower.
- if you have any images to upload, add them before the next step by clicking on Add Media. Drag all files in your
mediadirectory into the browser. - Adding media will insert links into your document. Take note of the three numbers following '/sites/' in the URL. For instance, in https://developer.ibm.com/datapower/wp-content/uploads/sites/**88/2016/11**/ics-test-container-overview.png, it is
88/2016/11. - Use gfm-wordpess to convert the markdown into HTML (if you don't have it, install with
npm -g install gfm-wordpress). There is some header material that has to be removed, we'll do that with sed. Be sure to replace88/2016/11with the directory from the previous step. The command isgfm-wordpress --media="88/2016/11" ./decrypt-tls-using-master-secret-logging.md | sed -e '1,1s;^.*</ol>;;g' - Copy the HTML produced by gfm-wordpress into the post and preview it. Make any corrections if necessary in the markdown and repeat the edit, transform, copy, preview process.
- Once you are happy with the post and the formatting, submit it for publishing