Create a post via CLI

walter · July 27, 2020, 4:54am

Hi, I am totally new here. I am intrigued by WriteFreely and had an (admittedly brief) look at the doco.

One thing which is not clear to me: Is the web editor the only way to write/publish posts? Or can I publish via a command line tool as well?

To understand where I am coming from: I have been using Pelican, a static site generator, for a blog and there I can write the post in any editor on my local machine and then send that file off via the CLI command. Pretty handy.

Would be great if this works for WriteFreely as well.

cjeller1592 · July 27, 2020, 6:32pm

Hi @walter! Funny you mention that…WriteFreely actually has a CLI utility that you can use to publish posts! It’s great for the workflow you’re describing. You can check it out & download it here:

And you can check out the guide for use cases and commands here:

github.com

writeas/writeas-cli/blob/master/cmd/wf/GUIDE.md

# WriteFreely CLI User Guide

The WriteFreely Command-Line Interface (CLI) is a cross-platform tool for publishing text to any [WriteFreely](https://writefreely.org) instance. It is designed to be simple, scriptable, do one job (publishing) well, and work as you'd expect with other command-line tools.

WriteFreely is the software behind [Write.as](https://write.as). While the WriteFreely CLI supports publishing to Write.as, we recommend using the dedicated [Write.as CLI](https://github.com/writeas/writeas-cli/tree/master/cmd/writeas#readme) to get the full features of the platform, including anonymous publishing.

**The WriteFreely CLI is compatible with WriteFreely v0.11 or later.**

## Uses

These are a few common uses for `wf`. If you get stuck or want to know more, run `wf [command] --help`. If you still have questions, [ask us](https://write.as/contact).

### Overview

```
   wf [global options] command [command options] [arguments...]

COMMANDS:
     post     Alias for default action: create post from stdin
     new      Compose a new post from the command-line and publish

This file has been truncated. show original

Hope that helps!

walter · July 28, 2020, 1:43am

Thanks heaps @cjeller1592! That’s exactly what I was looking for.

Very cool that you can connect to instances whereever and not only on the machine you are working on.