Acvte

What it is

A markdown blog based off of @natew's obtvse2, which was originally

inspired by svbtle, using Today theme contributed to obtvse2 by @shilov. This is basically a direct

port of obtvse2 using the revel framework for go, and it was never intended for it to be any more than that. This project was

just an exercise in getting comfortable with go and revel.

What it isn't

Acvte is definitely not a full CMS like WordPress. There aren't any plugins or themes strewn across the Internet. It's also not a static site generator like Jekyll. Acvte is fully dynamic, backed by your favorite database.

Demo

Head over to acvte's demo site to take a look. Feel free to login to the admin with the username demouser and the password demopassword. Once you've had a chance to look over things, check out the source code over at github. Fork it. Clone it. Do whatever with it, but do just that. Do something with it.

Getting Started

After getting started and installing go, using acvte is easy. Assuming your $GOPATH is setup correctly:

# Install the revel cli
$ go get github.com/robfig/revel/revel
# Grab a copy of acvte
$ go get github.com/slogsdon/acvte
# Run locally for testing with
$ revel run github.com/slogsdon/acvte
# Build a production release with
$ revel build github.com/slogsdon/acvte /path/to/save/build

Configuring

Database

Configuring acvte for your database is as easy as editing

src/github.com/slogsdon/acvte/conf/app.conf in your build directory. Currently, MySQL, Postgres, SQLite3 are supported. Here are the entries for the demo site:

db.driver = mysql
db.user = demouser
db.password = demopassword
db.dbname = blog
db.protocol =
db.address =
db.params = charset=utf8&parseTime=true&loc=Local

Just look for those, and plug in your settings. The only required items are db.driver and db.dbname as your chosen driver should use defaults for the others if they apply.

Frontend Personalization

Personalization is done through the app.conf file as well. Setting any of the info. config entries will affect the frontend only, outputting the data you specify or turning off features if you set some to false. Here's a list of currently available options and their expected data type:

info.name # string - name of the site
info.tagline # string - tagline/about
info.email # string
info.twitter # string - twitter handle
info.github # string - github handle
info.use_ga # bool
info.ga_id # string
info.use_gauges # bool
info.gauges_id # string
info.domain # string - default domain
info.use_disqus # bool
info.disqus_id # string

Allowing Publishing with Draft

Currently, publishing inside of Draft is the only feature that uses the app.secret (at least as far as acvte is concerned). Setting the option to true merely allows the route for the draftin.com webhook to accept POST requests, otherwise, it always returns false.

If you turn this feature on, please create a unique value for app.secret to increase security. Verification of the app.secret is only one of the steps taken to ensure the request is legitimate, but it is considered best practice to set your own value to use.

Once turned on and with your app.secret set to a unique value, head over to Draft's settings page, and add a webhook URL for your account that points to http://[your domain here]/webhook/draftin/[your app.secret value].

Draft sends the email associated with your account in the request. Please ensure it matches the email attached to your user account inside of acvte as this is the second step in verifying requests to this webhook.

TODO

  • Allow for new user creation
  • Create a new default design (?)
  • Look into allowing environment variables for database configuration
  • Generate migrations for database schema, or at the very least, add a schema dump to git
  • Allow for MongoDB support with mgo

Note

As of this writing, revel and acvte are still in a state of high development. They should be stable enough for a production environment, but there are no guarantees.

License

See the LICENSE file.