ARGS="--unpublished --future" make developinstead.
The posts are located in the
_posts directory and use
markdown. To create a new one, just create a new markdown file called
YYYY-MM-DD can be the current date. Each post has a front matter and some content. The front matter contains meta data about the post, most of which should be pretty self explanatory.
--- layout: article title: A Practical Parser for Time Expressions date: 2018-07-28 11:25:00 # if the publication date is in the future the article will be published on that future date categories: [time-parsing, ctparse, NLP, pydata] comments: false share: true image: teaser: 2018_07_07/teaser.jpg feature: 2018_07_07/feature.jpg description: ctparse is a pure python library (MIT-License) for parsing complex time expressions efficiently. usemathjax: false # if you need math symbols turn this one author: sebastian_mika ---
For the images of the post, create a new directory under
images and name it with the date prefix of the post markdown file. You can put all the images of the article in that directory, the
teaser images should ideally be called
teaser.jpg. Please do not use copyrighted images with first acquiring a license - pexels.com has a large collection of free to use images.
All the posts are using markdown. If you're not familiar with markdown GitHub has a useful guide https://guides.github.com/features/mastering-markdown/
All math notation needs to be enclosed in two dollar signs for mathjax to render them.
The blog currently uses a Jekyll theme called skinny bones. You can refer to below article for a CSS style guide.
Useful reading (you can read this in one weekend)
sliceare meaningful only for the backend team
Exception: If you want to specifically emphasize the action over the subject, then passive might be fine. Example: Your account was shut down by our security team.
If the sentence is too long, cut it into two.
Use sections, or even think about a series of posts for big topics. Format for easy reading (sub-headlines, bullet points, keep paragraphs short).
Introduction get the reader’s attention
Main body: That’s where you discuss your topic Remember to use sections (see above)
Conclusion: Sum up your post/findings You can also give an outlook or use call to actions