Asciidoctor extensions by Neo4j.

# Otto AsciiDoc-powered static site generator with Jekyll-style conventions: layouts, includes, data files, posts, drafts, permalinks, and custom collections. ## Install ```sh gem install ottogen ``` Requires Ruby 3.0 or newer. ## Quickstart ```sh mkdir mysite && cd mysite otto init otto build otto serve open http://127.0.0.1:8778/ ``` For a longer walkthrough including AsciiDoc syntax, see [GUIDE.md](GUIDE.md). ## Commands | Command | Description | |---|---| | `otto init [DIR]` | Scaffold a new site (current dir if omitted) | | `otto build` | Render the site to `_build/` | | `otto build --drafts` | Include posts from `_drafts/` | | `otto watch` | Rebuild on file change | | `otto serve` | Serve `_build/` on port 8778 | | `otto generate PAGE` | Create a new page in `pages/` | | `otto post "Title"` | Create a new dated post in `_posts/` | | `otto clean` | Delete `_build/` | | `otto doctor` | Sanity-check project layout | ## Project layout ``` my-site/ ├── .otto # marker ├── config.yml # site config ├── assets/ # copied verbatim into _build/ ├── pages/ # AsciiDoc pages, output mirrors path ├── _layouts/ # ERB layouts (.html.erb) ├── _includes/ # ERB partials ├── _data/ # YAML/JSON files exposed as site.data.* ├── _posts/ # YYYY-MM-DD-slug.adoc └── _drafts/ # undated drafts (excluded by default) ``` ## Configuration (`config.yml`) ```yaml title: My Otto Site description: Things I write url: https://example.com baseurl: "" permalink: /:year/:month/:day/:slug/ collections: recipes: output: true ``` `permalink` accepts these tokens: `:year`, `:month`, `:day`, `:slug`, `:title`. Templates ending in `/` produce pretty URLs (`<path>/index.html`). ## Pages and posts Both support YAML front matter: ```adoc --- layout: default title: Hello tags: [ruby, cli] --- = Hello Welcome to {site_title}. This page is at {page_url}. ``` Pages live under `pages/`; posts under `_posts/` with `YYYY-MM-DD-slug.adoc` names. Layouts wrap rendered AsciiDoc; partials in `_includes/` are pulled in via `<%= partial 'header.html' %>`. ## License MIT

使用 AsciiDoc 编写书籍内容，通过 persie 将其转换成 PDF，ePub 和 Mobi 格式电子书。

Pirka highlights source code syntax in EPUB books

A static site generator that supports code, photos and files.

This rubygem does not have a description or summary.

Connect to Rapidomize cloud with Ruby

This is a polite fork of riemann-tools, using my riemann-ruby-experiments gem instead of riemann-ruby-client. As a result, events can be batched together to be sent in one message to a Riemann server. Additionally, more control over the TCP socket options is given, and UDP isn&amp;#8217;t supported (yet?), because this gem primarily uses net_ruby_client.

Just another client, to experiment with.

Support rnp's OpenPGP functionality via ruby-ffi. Requires librnp.so.

Generate JSON schemas for IDE integration with RuboCop

Autocorrect offenses defined in .rubocop_todo.yml.

WebMock for shell commands

Create, build and publish your techbook with a simple cli.

Theme for the Vert.x howtos