Skip to content
Marcos Cáceres edited this page Jun 14, 2016 · 37 revisions

ReSpec is a tool that makes writing specifications easier. ReSpec handles things like styling, referential integrity, bibliographical data, and other mundane tasks.

Getting up and running

All you need is a HTML Document and to set some configuration options. Each configuration option is documented in this Wiki.

<!DOCTYPE html>
<html>
  <head>
    <meta charset='utf-8'>
    <title>Replace me with a real title</title>
    <script 
     src='//www.w3.org/Tools/respec/respec-w3c-common' 
     class='remove'></script>
    <script class='remove'>
      var respecConfig = {
        specStatus: "ED",
        editors: [{
          name: "Your Name",
          url: "http://your-site.com",
        }],
        processVersion: 2015,
        edDraftURI: "http://some.github.repo",
        shortName: "dahut"
      };
    </script>
  </head>
  <body>
    <section id='abstract'>
      <p>
        This is required.
      </p>
    </section>
    <section id='sotd'>
      <p>
        This is required.
      </p>
    </section>
    <section>
      <h2>Start your spec!</h2>
      <pre class="idl">
      interface Foo{
        attribute Bar bar;
        void doTheFoo();
      };
      </pre>
    </section>
  </body>
</html>

Getting Support

The official support channel for ReSpec is [email protected]. The mailing list archives are available. You can subscribe by sending email to [email protected] with "subscribe" as the subject line.

Guides

Configuration options

W3C Configuration options

Linter rules

Internal properties

Handled by ReSpec for you.

Special <section> IDs

HTML elements

Custom Elements

WebIDL

HTML attributes

CSS Classes

Special properties

Clone this wiki locally