Visual Editor

This chapter demonstrates using afia website edit to start a visual editor for your site.

Begin by creating a new Afia workspace:

mkdir my-workspace
cd my-workspace
afia init

Next, start an editing server for the website that was just created:

afia website edit --website basic

The afia website edit prints a link to the website editor. Click the link to begin editing your site.

Programmatic Editing Sessions

Both humans and computer programs can edit the same site collaboratively.

First, start the editing server:

afia website edit -w basic --ses-port 9500

The afia website edit command prints an address, identifier and API key for connecting to the session.

To send a single programmatic edit, point one of the Afia CLI's editing commands to the editing session. Here is an example using afia page create:

afia page create --slug=about --route=/about --ses-addr=localhost:9500 --session=ses_session_id_here --api-key=dev-key

To send and receive many edits over time, begin by joining the editing session:

afia join --ses-addr=localhost:9500 --session=ses_session_id_here --api-key=dev-key

afia join starts a REPL where you can edit a site via stdin. Your edits will appear in the visual editor in real time.

Afia 0.0.8
Type "help" for more information.
> ...

To create a new page section, enter the following into the REPL.

> afia pagesec create --page=home

To undo your most recent edit:

> undo

To reverse the previous undo:

> redo