Internet-Draft: CalConnect vObject Internationalization

This Internet-Draft is written in pure AsciiDoc using the excellent asciidoctor-rfc gem.

Fetching the document

git clone https://github.com/calconnect/rfc-in-asciidoc-template

Installing Build Tools

You will need Ruby, xml2rfc and idnits (for submission preflight).

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
# or
export ID_NAME=calconnect-vobject-vformat
make draft-${ID_NAME}.txt

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=calconnect-vobject-vformat
make draft-${ID_NAME}.nits

Checking for invalid / unicode characters

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

Iterating the document

export ID_NAME=calconnect-vobject-vformat
make clean all; open draft-${ID_NAME}.txt