HOWTO | use actions and workflows
1 Download a workflow
To create a new Markdown document, tap the top-left icon to open the sidebar, then the button at the bottom-left. Next, tap the arrow at the top-right of the screen, tap Browser and visit editorial-workflows.com. Type ‘Dropbox photo’ in the site’s search bar, tap the title of the item under Results and then Install Workflow. Confirm on the page that you want to proceed, and again in the dialog that pops up. To check it was a success, return to your document, tap the spanner icon and check the workflow is listed.
2 Use it to insert an image
Tap the ‘i’ next to the workflow in the list. Tap in the name field to give it a better name, then tap ‘Add to Bookmarks Bar’ so it’s quicker to access. Go to the Dropbox app, find the photo you want, tap its Share button, then Copy Link. Return to Editorial and tap the workflow in the Bookmarks Bar. It should add Markdown code for the image. If you get an error telling you the link lacks an image extension, open another text app, paste the link, remove ‘?dl=0’ from its end, copy it again and try again in Editorial.
3 Understand workflows
Workflows in Editorial are usually made up of sequential actions (though a workflow can also be single action comprised of a Python script). Actions can do many things, such as converting Markdown to HTML, or searching for text. They have parameters that you set when creating a workflow, the types of which depend on the action. Each action takes the output from the preceding action as its input. Once you’ve set the parameters for an action, you can save its configuration as a preset to use again.
4 Variables and blocks
Variables can be used to substitute values into actions’ text parameters. Built-in variables include selected text, file name, and date and time formats. So, to create a letter template with ‘Date:’ followed by today’s date, you’d create an action to insert variables that format the date how you want it to look. When you want actions to run only when a condition is met, add the Conditional Block action and put them inside it. To repeat actions for every line of text that’s input, use the Repeat Block action.
5 Edit existing workflows
The best way to understand how actions form workflows is to examine one included with the app. Tap the spanner icon, then the ‘i’ next to a workflow, then Edit Workflow to see its actions listed sequentially. Tap an action to see its options. To save your choices as a preset, and to rename the step, tap the down arrow at the right of the action’s title bar. You can also drag an action to a different place in the sequence using the grip icon at its far right, though you don’t want to do that in a pre-built workflow.
6 Create your own
The first step in creating a workflow from scratch is to plan what you want it to do: steps to get there, conditions to meet, variables needed, and so on. Next, check out the Action Library by tapping the spanner, then ‘+’ to create a workflow, then ‘+’ again. Read an action’s documentation by tapping its adjacent ‘?’ and work out the order of actions based on their input and what they produce. Store things you need later in variables. Detailed documentation about Editorial is at http://bit.ly/mfEditorialDocs.