Skip to content
Template for creating an Internet-Draft / RFC in AsciiRFC using Metanorma
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
references
sections
.gitattributes
.gitignore
.travis.yml
Gemfile
Gemfile.lock
Makefile
README.adoc
deploy.sh
deploy_key.enc
deploy_key.pub
draft-asciirfc-minimal.adoc
requirements.txt
rfc2629-other.ent
rfc2629-xhtml.ent
rfc2629.dtd
rfc2629.xslt

README.adoc

AsciiRFC Template For Writing RFC / Internet Drafts

Build Status

This document is available in its rendered forms here:

This Internet-Draft is written in AsciiRFC using the Metanorma framework, via the metanorma-ietf gem.

Quick Start

For a blank slate start of your Internet-Draft written in AsciiRFC:

  1. Clone this repository

  2. Copy out all the files (including the dot-files)

  3. Done!

Usage

Fetching The Document

git clone https://github.com/metanorma/rfc-asciirfc-minimal

Installing Build Tools

You will need to install Metanorma, xml2rfc and idnits (for submission preflight).

Please see https://www.metanorma.com for installation instructions.

On macOS

brew install idnits
brew install python
easy_install pip
pip install -r requirements.txt
gem install bundler
bundle install

Building The Document

make all

Checking Against idnits

idnits is the RFC checking tool prior to submissions.

The make target finds exactly the document name from the :name: document attribute and puts the file in the right place before calling idnits to prevent it complaining about the location.

export ID_NAME=asciirfc-minimal
make draft-${ID_NAME}.nits

Checking For Invalid / Unicode Characters

export ID_NAME=asciirfc-minimal
pcregrep --color='auto' -n "[\x80-\xFF]" draft-${ID_NAME}.xml

Iterating The Document

export ID_NAME=asciirfc-minimal
make clean all; open draft-${ID_NAME}.txt
You can’t perform that action at this time.