Tutorials are written as individual .md files. The tutorials are organized in folders (by subject) in the
/_post folder: https://github.com/plotly/plotly.github.io/tree/master/_posts.
To create a new tutorial, create a new .md file in the appropriate folder for the tutorial (i.e. if the tutorial is for a feature of Plotly’s workspace add your .md file to the plotly2 folder).
The title of your .md file must include the date (date created):
These are the variables defined at the top of each post:
tutorial-single_layoutor additional options listed here
A tutorial on how to --insert tutorial subject-- --insert Plotly Tool (i.e. in Plotly 2.0)--.
analysisDetermines which section to place the tutorial in: http://help.plot.ly/tutorials/. This variable is used in the templates
For example, here is the front matter for the boxplot tutorial:
layout: tutorial-single_layout title: Box Plots in Plotly 2.0 subtitle: A convenient way of graphically depicting groups of numerical data through their quartiles. meta_description: A tutorial on how to make a box plot in Plotly 2.0. permalink: /make-a-box-plot/ imageurl: ../static/images/how-to-make-a-boxplot/thum-how-to-make-a-boxplot.png state: active tags: statistical order: 2.5 actioncall: How to Make a Box Plot in Plotly 2.0 actioncall-url: https://plot.ly/alpha/workspace/?fid=plotly2_demo:108 live-graph: <iframe width="900" height="800" frameborder="0" scrolling="no" src="https://plot.ly/~plotly2_demo/108.embed"></iframe> otherlang: Know how to program? See how to create this in [Python](https://plot.ly/python/box-plots/) or [R](https://plot.ly/r/box-plots/).
Image filenames and alt tags should be as descriptive as possible, up to 5 or 6 words. This is the text that will fill in for the images for folks that use screen readers. Also, google bots!