There is a massive amount of confusion in this world.

This book is about understanding, and, if it is not had by humans, they, as a collective whole, will continue to destroy themselves at increasingly rapid rates.  Through a limited perspective it may seem as though we're living very long lives of 80 to 90 years, when, no matter what anyone believes, there are human beings on this planet right now 500, a 1000, and 10,000 years on Earth.

This is what we mean by massive lack for understanding.

Humanity is killing themselves at such increased rates of speed collectively they all believe it to be normal.

This is the stark contrast of how things are, verses how you think things are.

How do I know this to be fact instead of opinions of which are not real?

I have little use for the past and rarely think about it, however, I would like to take a moment to discuss how I became a spiritual teacher in order to lay a foundation of understanding.

Until my 32nd year of life on planet Earth I considered myself athiest/agnostic and did not believe in anything I could not touch, taste, see, smell or hear.  I vhemenently argued against the existance of any and all religions, and, arrogent as I was about my abilities, I believed myself to be correct and eveyone else to be complete fools.

Until such time as I thouroughly understood why Steve Jobs would ask with a show of hands who here has taken LSD.

It is because LSD first and foremost degausses your electromagnetic field in such a way as to allow you to feel this field thereby allowing one to begin to push and pull energy from this field and the world around you through the stillness spoken of by Eckhart Tolle, the stillness spoken of by Jesus Christ, and many more.

At a time when I did not believe in such things as spirits, the essence of which we all are, I took a powerful psychotropic and Astral Projected out of my body in spirit form onto the 4th dimensional plane of consciousness.  I looked down upon my body to see myself sitting in a Jedi type pose with shooting beems of light coming from my head to my friend next to me knowing only that I had the intention to send him healing energy.

After an experience like this your understanding of how things are verses how you think things to be dramatically changes.  The reason being is facts lay the foundation for facts upon facts of which domino in your mind naturally after the experience.

For example, I now know and understand myself to be this essence, when, previously I did not believe I was this essence.  This taught me it doesn't matter what I think or believe compaired to what is true learned from felt understanding.

I also discovered humans have the ability to heal themselves and others at a time when I did not believe in such things.

How are we as a human species killing ourselves?

First, it is important to note, shaman priests have been utilizing powerful psychotropics under the guidence of qualified guides in order to show others the connection back to the divine for millions of years upon eternity.

At a time when I did not believe in such things as channeling energy from other beings on Earth I took Mushrooms and spoke with Jane.

She calls herelf Jane sort of as a joke, in other words, you can call me rain if you'd like, because in truth she like us all are connected to it.

All are one.

After speaking to my teacher Jane she reveiled to me deep truth through felt understanding of which will be illustrated later in this book.

She gave me the understanding that she has been sitting in a chair without moving or breathing for 500 years.  She does not like using labels because of what the Ego instantly attempts to do, and, that is, associate pointers to specific religions, however, let's just say she has learned to take up enough prana through her Manipura Chakra in order to sustain life without moving.  Because of this power she has built up she has stored up enough Chi/Qi energy to cut the planet in half with one punch, her and her husband of whome is sitting catty corner to her this very moment.

We come in pairs of which creates this chemical reaction force of love to be had between two and thus blossom in the world around us.

It is this essence of which she speaks to be important, yes, power is important, however, do not get caught in this Chakra, and do not think we are trying to convert you to a religion when we use the word Chakra.

This will be a mistake, ultimately, you could call it bad kharma, there is no such thing of course because it will be a lesson for you until you learn to only spread what we could call good khrama to everyone.

Effectively meaning the bad kharma was your good kharma as well, one we do not focus on as beings of pure holy light energy.  Once we learn you want to be speaking infinite blessings to all at this calibur at all times no matter what, then you understand the importance of pushing good kharma for you, yourself & others.

If you do not, you might consider there to be such a thing as a backlash.

"He who has forgotten he is the protector of the land is no longer being protected by the land."

It's much like sticking your hand in a snake pit and wondering why you got bit, then, getting mad that you were bit and not understanding why you've been bit.

Your lack of understanding is complete because you are biting the planet upon which you live and destroying the planet eventhough you do not believe this to be the case.  Because of this the living planet this is, as all shamans know, is plotting against you.  Just as any living organism would a paracite upon it causing nothing but mayhem.

The Earth does not wish to invoke it's deep power and send all of humanity down the drain again as it has many times before.  What it does desire is humanity to realize what it is doing and stop it from continuing to happen.

Of this is what we will now speak.

Free energy scares all the humans with the guns and money, because, they are caught in the Mani Pura Chakra for greed, and, for them and others around them as part of this system they will reap the repurcussions of learning kharma is real sooner or later in this life or another.

You do not believe you will be coming back to this planet again if you do not master it soon.

This is unfortunate, because, lives are resources, of which we do not desire to waste.  As we stated, the planet is an alive awareness and the resources you use are part of this living organism.

We desire you to learn the lesson in this life, not come back a thousand times like Edgar Cayce.

You will, even if you don't believe you will.

This is because you lack what we could call discipline.

This is because you lack the understanding of the word discipline.

You do not understand your goal on Earth and why you are here.

It is simple.

Steve Jobs set a bar when he asked who here with a show of hands has taken acid.

We will set another bar.

Who here has gone full ninja like the South Korean girl who knocked me out of my body into spirit form exactly like the animation Bleach & Dr. Strange has described?

Who here has astral projected out of their body?

So what is the goal of life?  You could say this is it, if you wanted to label it as though you needed to be astral projecting all of the time or ever after you've mastered the ability.

However, as Eckhart Tolle describes the first step we take is getting back in touch with our bodies, and, as Eckhart Tolle describes, all the workshops in the world are a smorgasbord of stimulating information of which is highly addictive.  It is this phonetic energy to which we as a race are addicted.  Instead of having an understanding of exactly how long it takes to cultivate this focus which is the calibur of 10 Day Vippassana meditation on your breath.

As Eckhart suggested, you can go to all of these meetings, and, they're all fun and exciting to learn about, but, ultimately all is information, and, information is not understanding the quantum machine we all are on a felt basis.

This is our goal.  To understand the quantum machine we all are through felt understanding.

This is what we don't understand, how long it's going to take to relax into our natural state.

Most meditate for 20 minutes a day, and, this is a start, however, until you truly learn to let go and slip into the theta wave, you have most likely not learned how to relax.

That's not fun for anyone.

Which brings us to how you're dying.

If not for the magnificant design of the human body we would all be gone long ago, however, because of the buffer of high bananna levels of postassium, the malleability can be increased, and, when it is combined with Evian calibur water it then allows tension to naturally fall away.

Jane taught me we're killing ourselves with thoughts, as Eckhart has also described.

Thoughts are like rocks, when thrown into the waters of our mind they create ripples clouding the depths of our true nature of which is peace.

Peace is what you want.

Chaos is what you have.

Science has proven humans to have 55 to 65 thousand thoughts per day.

This is akin to having your car redlined at 9,000 RPM's everyday for 8 hours a day and wondering why you need coffee in order to get going the next.

It's akin to shooting nitrus through an already exhausted engine.

It's akin to your processor being at 99% all day everday for 90 years and then overclocking your processer with coffee.

This is why you're all dying so fast.  Even now reading this book is entertaining you, and, that is fine, however, realize the fact, be aware of the feeling of the energy, the reaching to grab the next morsel of information, the addiction to phonetic energy and cool sounding words like phonetic energy.

Jane has learned how to bring her state of being to what we call chill mode zero and remain there at all times, this is how she's been here for so long.

100% relaxed without thinking, but, feeling the energy around your body, focusing on this energy for ten days straight to gain the focus needed to understand divine direction.

Divine direction is always what is best for us all.

Since as a society we are all caught in the Manipura Chakra of greed and would rather not give ourselves free energy of which would allow 5 Star Hotels to be built for everyone, we suffer as a planet fighting over a perception of limited resources.

You suffer because you create a system that is not Star Trek in nature, Venus Project in Nature, but is one where humans are forced to think all day long in jobs killing them in order to pay for energy of which is free to be had for all.

Why did we create a system of control?  We wanted control.

We were caught and still are caught in the chakra of manipura.

This is not good or bad.  Right or wrong.

It is simply an observation of humanites evolutionary step of where they have come verses where we are all about to go.

If you understand chakras you understand being in Manipura isn't bad, it's simply a level at which we are, but we want to go above this one into the next chakra and that chakra is called love.

You're killing youself by not embracing this chakra and causing yourself what you call cancer.

This chakra, in irony, is opened by taking the massive amount of power you've built, and, giving it away.

It is at this time you will ascend to the next chakra of Vishuda, and so on.

Chakra is a word, when I astral projected out of my body in spirit form, I did not know the word, however, I did indeed feel the void of which Mr. Tolle speaks pull me in, I did indeed feel 8 areas along my spine open and a massive thunderbolt of lightening energy strike from the base of my spine to the crown of my head at a time when I had not heard the word kundalini be spoken.

So, it is not from here say I speak, it is from felt experience & felt understanding.

How does this felt understanding translate into love for you and the rest of the world?

It begins by giving your love to one who will give it back to you much like Gladiator.

The one writing this would like 1 billion shares of Apple stock in order to create free energy for this world at Apple for the world, and, in doing so, disolve the concept of money & stocks all together.

This amount of power is important in order to instill divine direction as illustrated by Ashton Kutcher.

One day we are 30 days away from bankruptcy.

The next day we are not.

This is divine direction.

500 projects gone - 12 remain

This will release humanity from the hold it has upon it'self forcing humanity to work endlessly with no rest or peace in sight.

Once you begin to push and pull energy you understand how important it is to be around 13 people as was Jesus and many others.

You understand as a shaman priest each sign in the zodiac balances Earth, Wind, Fire & Water.

You understand piziolectricity utilizes this same principal as do all things in the universe permiate the same.

You understand one stone from each sign cut in it's respective platonic solid placed inside a vacume sealed highly visucus gassed chamber would also magnify this energy in such a way as to create a mini omegatron device.

You understand this same energy can be used in cars.

You understand this same energy can be used in houses.

What happens after you let go of control and give in?

Star Trek happens.

No one has to work and you also understand this same crystal energy to be able to power your new NCC1701 D USS Enterprise.

You understand not letting go and giving control of resources keeps us from this world.

Verses what the human race believes to be possible.

You are like Dr. Strange, helpful to society in what you do, however, you have not learned complete truth until you have taken the discipline of 10 Day Vipassana level focus cultivation in order to master things like lucid dreaming & astral projection.

You, like myself previously, do not even believe in such things.

All religions have truth at their core and all of these symbols have power, at the end of the day the important thing is, have you mastered lucid dreaming?  Have you mastered astral projection?

Both of these simply being another term for saying, have you mastered yourself?

Do you need to call yourself XY or Z to master yourself?

No, no matter what you call yourself, you will still need ten days straight of focus cultivation.

Why isn't anyone else realizing this right now?

The answer is simple, you haven't had a shaman priest take you on a vision quest.  That may sound a bit hard for you to believe right now wherever you are right now in your life, however, there is indeed more to life than meets the eye.

After you astral project out of your body your understanding of true focus, laser focus, has changed. You understand the level of discipline required to attain this focus without the aid of psychotropics. You understand this experience sets the bar for yourself, and, as it sets the bar for yourself, you then take this information to the rest of the world and again, assist to set the bar.

The question in Silicon Valley was with a show of hands who here had taken acid.  The reason why this question would be asked is so the teacher would be able to attain a feel for the level of experience in his class.

The new question, if you feel you need one, could be, who with a show of hands has astral projected out of their body in spirit form?

Until you have mastered your body and gleaned a felt understanding of the universe you have a lot of questions, and, this is normal.  After this experience you will have a lot of answers.

Earth School - Why Am I Here?

At any given time you are pushing the thread or threading the needle.  In other words you are either expended energy or you are working to focus energy.  You are doing something, or you are letting go and lightly focusing on your breath.  As stated before, what humanity does not understand is the same thing we did not understand, and, that is the discipline involved.  10 Days.  Christian, Muslim, Buddhist or otherwise matters not, those are simply lables humans invented in a world using an archaich form of liner communication called speach.

The Universe does not.

When I was in jail I found a book called Journey to Ixtalan, and, having a large amount of time on my hands, I decided to practice the lucid dreaming technique described in the book.

I would stare at my hands for 20 minutes each night for two weeks straight and say "Tonight, while I'm dreaming, I will see my hands and know that I am dreaming."

Low and behold it worked.

The Universe told me I was dreaming do whatever you like.  I zero'd out the entire construct and then began flying around shooting three beams of light out of my right hand and three out of my left hand with different shapes spiraling around each beam.

I did this with MASSIVE AMOUNTS OF ENTHUSIASM for five nights straight.

On the 6th night the Universe, all that is, also known in Quantum Phsycis as LIGHT ENERGY of which we all ARE : GOD, spoke to me.

The amazing fact here is, the Universe did not use words, it spoke in understanding and bypassed speach or any form there of ENTIRELY.

It loaded pages worth of information, without words but in understanding.  This was the first happening to blow me away.

After this, the universe, in understanding, but, in my limited way of utilizing understanding I as a human allow it to come out of my brain in words, said something to the tune of

"That is really cool that you are flying around like that having a wonderful time and everything, but, did you know there is a practical application to what you are doing here."

Of course, dumbfounded first by the form of communication, I stood even further dumbfounded and wondered exactly what the universe could be speaking of...

"No I have no idea...what's up?" :D

"Make a book of Spanish appear."

Since I was at the supream lucid zero construct untarnished with samsara anything state, I could do anything.

I made a book on spanish appear and wondered what the hell was going on...

"Did you know, if you smashed that book into your head that you would instantly load spanish and know it when you woke up?

Now, I am in my 3rd level of depth of dumbfoundation, and, my jaw is simply on the virtal ground if there were a jaw...however, the universe goes on to say...

"Oh, you've been in IT for 25 years, and, you think the computers YOU BUILD have an ability YOU who transfers 74 terabytes of the highest definition video this world has ever seen does not have this ability?  You believe a contraption you built is even the SLIGHTEST MORE ADVANCED than humans?  You believe the Aboriganies haven't already mastered 100% of their brain?

You certainly have not.

Again, very dumbfounded, all information is indeed factual information, it made sense to me, and still does now.

My name is Charles, when I was young, I went by Charles XavieR, "The Master of Mind Control."

As an Aries who controls the head, face & the brain this is fitting, because indeed we are starting a school more advanced than the ones this world has ever seen.

A school for the talented & extremely gifted.

This is the school we have created on Earth, to discover your TRUE potental through things like

Lucid Dreaming:

The Wild Way

As well as later down the line, Astral Projection.

If no content model or attribute requirements are explicitly specified, then HTMLBook adopts the corresponding requirements in the [[!HTML5]] Specification

Revision History and Notes

16 September 2015
Added informative section on reference entries
25 February 2015
Clarified HTMLBook specifications for inline semantics/tagging
8 April 2014
Updated specifications for section subtitles to comply with best practices set forth in “Common idioms without dedicated elements” in [[!HTML5]] Specification.
29 December 2013
Minor revisions for clarity
13 August 2013
Revised specification for footnote markup
3 July 2013
Changed spec to use the attribute data-type for specifying book-specific semantics instead of class. The class attribute is now free to be used for whatever user-defined semantics are desired, and there are no restrictions on class values. Users of the spec may want to replicate data-type values in the class attribute to facilitate CSS styling, but this is completely optional.
19 April 2013
First release of Working Draft

Book Component elements


HTML element: <body>

Attribute requirements: data-type="book" (Not in [[EPUB3SSV]]; from [[DOCBOOK]])

Content model: Optional <h1> that contains book title, or Header block that contains book title and optional subtitle content; then one or more Book Component elements as children (<div> for Part elements, <nav> for Table of Contents, and <section> elements for all other book divisions)


<body data-type="book">
  <h1>jQuery Cookbook</h1>
  <section data-type="chapter">
    <!-- Chapter content here -->

Note: Just as in standard HTML5, <body> is a child of the root <html> element.


HTML element: <section>

Attribute requirements: data-type="chapter"

Content model: First child must be either <h1> that contains chapter title, or Header block that contains chapter title and optional subtitle content; then zero or more Block Elements; then zero or more Sect1 children (<section data-type="sect1">)


<section data-type="chapter">
  <!-- h1 used for all chapter titles -->
  <h1>Chapter Title</h1>
  <p>Chapter content</p>
  <section data-type="sect1">
    <!-- Section content here... -->


HTML element: <section>

Attribute requirements: data-type="appendix" or data-type="afterword", depending on content

Content model: First child must be either <h1> that contains appendix title, or Header block that contains appendix title and optional subtitle content; then zero or more Block Elements; then zero or more Sect1 children (<section data-type="sect1">)


<section data-type="appendix">
  <h1>Appendix Title</h1>
  <p>Appendix content</p>
  <section data-type="sect1">
    <!-- Section content here... -->


HTML element: <section>

Attribute requirements: data-type="bibliography"

Content model: First child must be either <h1> that contains bibliography title, or Header block that contains bibliography title and optional subtitle content; then zero or more Block Elements; then zero or more Sect1 children (<section data-type="sect1">)


<section data-type="bibliography">
  <h1>Bibliography Title</h1>
  <p>Bibliography content</p>
  <section data-type="sect1">
    <!-- Section content here... -->


HTML element: <section>

Attribute requirements: data-type="glossary"

Content model: First child must be either <h1> that contains glossary title, or Header block that contains glossary title and optional subtitle content; then zero or more Block Elements; then zero or more Sect1 children (<section data-type="sect1">)

Best practices: List of glossary terms should be marked up using <dl> elements with a data-type of "glossary", with <dt> children with a data-type of "glossterm" and <dd> children with a data-type of "glossdef". Term text should be wrapped in a <dfn>. However, none of this is formally required by the spec.


<section data-type="glossary">
  <h1>Glossary Title</h1>
  <dl data-type="glossary">
    <dt data-type="glossterm">
    <dd data-type="glossdef">
      Widely used JavaScript library


HTML element: <section>

Attribute requirements: data-type="preface", data-type="foreword", or data-type="introduction", depending on content

Content model: First child must be either <h1> that contains preface title, or Header block that contains preface title and optional subtitle content; then zero or more Block Elements; then zero or more Sect1 children (<section data-type="sect1">)


<section data-type="preface">
  <h1>Preface Title</h1>
  <p>Preface content</p>
  <section data-type="sect1">
    <!-- Section content here... -->


HTML element: <section>

Attribute requirements: data-type="halftitlepage", data-type="titlepage", data-type="copyright-page", or data-type="dedication", depending on content

Content model: First child must be either <h1> that contains frontmatter section title, or Header block that contains frontmatter title and optional subtitle content; then zero or more Block Elements; then zero or more Sect1 children (<section data-type="sect1">)


<section data-type="titlepage">
  <h1>Python in a Nutshell</h1>
  <p>By Alex Martelli</p>


HTML element: <section>

Attribute requirements: data-type="colophon", data-type="acknowledgments", data-type="afterword", or data-type="conclusion", depending on content

Content model: First child must be either <h1> that contains backmatter section title, or Header block that contains backmatter title and optional subtitle content; then zero or more Block Elements; then zero or more Sect1 children (<section data-type="sect1">)


<section data-type="colophon">
  <h1>Colophon Title</h1>
  <p>Colophon content</p>
  <section data-type="sect1">
    <!-- Section content here... -->


HTML element: <div>

Attribute requirements: data-type="part"

Content model: First child must be either <h1> that contains part title, or Header block that contains part title and optional subtitle content; then zero or more Block Elements that compose the optional Part introduction; then one or more <section> elements representing Book Component children other than a Part


<div data-type="part">
  <h1>Part One: Introduction to Backbone.js</h1>
  <p>Part Introduction...</p>
  <section data-type="chapter">
    <!-- Chapter content here -->

Table of Contents

HTML element: <nav>

Attribute requirements: data-type="toc"

Content Model: The TOC must be conformant to the specs for the [[EPUB3]] Navigation document. First child is zero or more Heading elements (<h1>-<h6>), followed by an <ol> (with <li> children that can contain only a <span> element or an <a> element plus an optional <ol> child)


<nav data-type="toc">
  <h1>Table of Contents</h1>
     <li><a href="examples_page.html">A Note Regarding Supplemental Files</a></li>
     <li><a href="pr02.html">Foreword</a></li>
     <li><a href="pr03.html">Contributors</a>
         <li><a href="pr03.html#I_sect1_d1e154">Chapter Authors</a></li>
         <li><a href="pr03.html#I_sect1_d1e260">Tech Editors</a></li>


HTML element: <section>

Attribute requirements: data-type="index"

Content model: First child must be either <h1> that contains index title, or Header block that contains index title and optional subtitle content; then zero or more Block Elements; then zero or more Sect1 children (<section data-type="sect1">)

Best practices: HTMLBook recommends following the [[EPUBINDEX]] specification and using <ol>/<li> elements for marking up index entries, with data-type attributes used for semantic inflection as appropriate, but none of this is a formal spec requirement


<section data-type="index">
  <h1>Index Title</h1>
  <div data-type="index-group">
      <li data-type="index-term">AsciiDoc, <a href="ch01#asciidoc" data-type="index-locator">All about AsciiDoc</a>
           <li data-type="index-term">conversion to HTML, 
             <a href="ch01#asctohtml" data-type="index-locator">AsciiDoc Output Formats</a>
      <li data-type="index-term">azalea, <a href="ch01#azalea" data-type="index-locator">Shrubbery</a></li>


HTML element: <section>

Attribute requirements: data-type="sect1", data-type="sect2", data-type="sect3", data-type="sect4", data-type="sect5" (From [[DOCBOOK]] vocabulary), depending on hierarchy level. sect1 is used for <section> elements nested directly in main Book Components ("chapter", "appendix", etc.). sect2 is used for <section> elements nested in a sect1 <section>, sect3 is used for <section> elements nested in a sect2 <section>, and so on.

Content model: The first child must either be a main heading element corresponding to the hierarchy level indicated by data-type value, as follows:

"sect1" -> h1
"sect2" -> h2
"sect3" -> h3
"sect4" -> h4
"sect5" -> h5

or a Header block that contains section title and optional subtitle content. This is followed by zero or more Block Elements, followed by zero or more <section> elements with a data-type value one level lower in the hierarchy, as long as the parent section is a "sect4" or higher (e.g., <section data-type="sect4"> nested in <section data-type="sect3">)


<section data-type="sect1">
  <p>If you httpparty, you must party hard</p>
  <!-- Some more paragraphs -->
  <section data-type="sect2">
    <p>What's the frequency, Kenneth?</p>
    <!-- And so on... -->

Block Elements


HTML element: <p>


<p>This is a standard paragraph with some <em>emphasized text</em></p>


HTML element: <aside>

Attribute requirements: data-type="sidebar"

Content model: Zero or one <h5> element that contains the sidebar title); then zero or more Block Elements


<aside data-type="sidebar">
  <h5>Amusing Digression</h5>
  <p>Did you know that in Boston, they call it "soda", and in Chicago, they call it "pop"?</p>


HTML element: <div>

Attribute requirements: data-type="note", data-type="warning", data-type="tip", data-type="caution", or data-type="important", depending on the content within

Content model: Either of the following content models is acceptable:


<div data-type="note">
  <h1>Helpful Info</h1>
  <p>Please take note of this important information</p>
<div data-type="warning">Make sure to get your AsciiDoc markup right!</div>


HTML element: <table>

Content model: Zero or one <caption> elements (for titled/captioned tables); then zero or more <colgroup> elements; then zero or more <thead> elements; then a choice between either zero or more <tbody> elements, or zero or more <tr> elements; then zero or more <tfoot> elements

Content model for <caption>: Either of the following is acceptable:

Content model for <colgroup>: Mirrors [[HTML5]] Specification

Content models for <thead>, <tbody>, and <tfoot>: Mirror [[HTML5]] Specification

Content model for <tr>: Mirrors [[HTML5]] Specification, but see content model below for rules for child <td> and <th> elements

Content model for <td> and <th> elements: Either of the following is acceptable:


<caption>State capitals</caption>
<!-- And so on -->
      <th>Middle Initial</th>
    <!-- And so on -->


HTML element: <figure>

Content model: Either of the following is acceptable:


<figcaption>Adorable cat</figcaption>
<img src="cute_kitty.gif" alt="Photo of an adorable cat"/>


HTML element: <div>

Attribute requirements: data-type="example"

Content model: Either of the following content models is acceptable:


<div data-type="example">
<h5>Hello World in Python</h5>
<pre data-type="programlisting">print "Hello World"</pre>

Code listings

HTML element: <pre>

Attribute requirements: data-type="programlisting"

Optional HTMLBook-specific attribute: data-code-language, used to indicate language of code listing (e.g., data-code-language="python")


<pre data-type="programlisting">print "<em>Hello World</em>"</pre>

Ordered lists

HTML element: <ol>

Content model: Zero or more <li> children for each list item

Content model for <li> children: Either of the following is acceptable:


<li>Step 1</li>
  <p>Step 2</p>
  <p>Step 2 continued</p>
<!-- And so on -->

Itemized lists

HTML element: <ul>

Content model: Zero or more <li> children for each list item

Content model for <li> children: Either of the following is acceptable:


<!-- And so on -->

Definition lists

HTML element: <dl>

Content model: Mirrors [[HTML5]] Specification

Content model for <dt> children: text and/or zero or more Inline Elements

Content model for <dd> children: Either of the following is acceptable:


  <dt>Constant Width Bold font</dt>
  <dd>Used to indicate user input</dd>


HTML element: <blockquote>

Content model: Either of the following is acceptable:


  <p>When in the course of human events...</p>
  <p data-type="attribution">U.S. Declaration of Independence</p>

Note: If the blockquote is an epigraph, add data-type="epigraph", e.g.:

<section data-type="chapter">
  <blockquote data-type="epigraph">
    <p>It ain't over till it's over.</p>
    <p data-type="attribution">Yogi Berra</p>
  <p>In this final chapter of the book, we will…<p>


HTML element: <div>

Attribute requirements: data-type="equation" (From [[DOCBOOK]]; no close match in [[EPUB3SSV]])

Note: HTMLBook supports embedded MathML in HTML content documents, which can be used here.


<div data-type="equation">
<h5>Pythagorean Theorem</h5>
<math xmlns="">

Reference Entries (refentries)

Suggested HTML element: <div>

Suggested semantics: class="refentry"

Note: HTMLBook does not currently normatively specify structural semantics for reference entries as they are conceived in DocBook ([[DOCBOOK]]) or DITA ([[DITA]]). Use of <div class="refentry"> is suggested for marking up reference entries. The following example illustrates XHTML5 markup one might use for refentry content, which captures DocBook-style semantics

Example refentry paralleling [[DOCBOOK]]:

<div class="refentry">
    <p class="refname">print</p>
    <p class="refpurpose">Output some text to stdout.</p>
  <div class="refsynopsisdiv">
    <pre class="synopsis">print "<em>Hello World</em>"</pre>
  <div class="refsect1">
    <p>More description would go here</p>

Inline Elements

HTMLBook is primarily focused on codifying structural semantics for book authoring, and as such, it does not formally define specifications for phrase-level semantics (such as the DocBook varname or personname elements) beyond that which is codified in the [[!HTML5]] specification. Nor does it formally define specifications for purely presentational markup (such as underline or strikethrough rendering). HTMLBook users are encouraged to employ the appropriate standard HTML5 phrasing elements for inline semantics when available (e.g., <strong>, <em>, <s>, <u>) and to use <span> elements with custom-defined classes in other cases, as illustrated in the following examples.

Emphasis (generally for italic)

HTML element: <em>


<p>I <em>love</em> HTML!</p>

Strong (generally for bold)

HTML element: <strong>


<p>I <strong>love</strong> HTML!</p>

Literal (for inline code elements: variables, functions, etc.)

HTML element: <code>


<p>Enter <code>echo "Hello World"</code> on the command line</p>

General-purpose phrase markup for other styling

HTML element: <span>


<p>Use your own class attributes for custom styling for formatting 
like <span class="underline">underlined text</span></p>

Footnote, endnote

HTML element: <span>

Attribute requirements: data-type="footnote"

Content model: text and/or zero or more Inline Elements


<p>Five out of every six people who try AsciiDoc prefer it to 
Markdown<span data-type="footnote">Totally made-up statistic</span></p>



HTML element: <a>

Attribute requirements: data-type="xref" (From [[DOCBOOK]]); an href attribute that should point to the id of a local HTMLBook resource referenced; data-xrefstyle (optional) for specifying the style of XREF


<section id="html5" data-type="chapter">
  <h1>Intro to HTML5<h1>
  <p>As I said at the beginning of <a data-type="xref" href="#html5">Chapter 1</a>, HTML5 is great...</p>
  <!-- Blah blah blah -->

Index Term

HTML element: <a>

Attribute requirements: data-type="indexterm"; for primary index entry value, use data-primary; for secondary index entry value, use data-secondary; for tertiary index entry value, use data-tertiary; for a "see" index reference, use data-see; for a "see also" index reference, use data-seealso; for a "sort" value to indicate alphabetization, use data-primary-sortas, data-secondary-sortas, or data-tertiary-sortas; for an "end-of-range" tag that marks the end of an index range, use data-startref="id_of_opening_index_marker" (Semantics from [[DOCBOOK]])

Content model: Empty


<p>The Atlas build system<a data-type="indexterm" data-primary="Atlas" data-secondary="build system"/> lets 
you build EPUB, Mobi, PDF, and HTML content</p>


HTML element: <sup>


<p>The area of a circle is πr<sup>2</sup></p>


HTML element: <sub>


<p>The formula for water is H<sub>2</sub>O</p>

Heading Elements


HTML elements: <h1>, <h2>, <h3>, <h4>, <h5>, or <h6>

Content Model: text and/or zero or more Inline Elements

Notes: Many main book components (e.g., chapters, parts, appendixes) require headings. The appropriate element from <h1><h6> is outlined below, as well as in the corresponding documentation for these components:

book title -> h1
part title -> h1
chapter title -> h1
preface title -> h1
appendix title -> h1
colophon title -> h1
dedication title -> h1
glossary title -> h1
bibliography title -> h1
sect1 title -> h1
sect2 title -> h2
sect3 title -> h3
sect4 title -> h4
sect5 title -> h5
sidebar title -> h5


HTML element: <header>

Content Model: A Heading element at the proper level designated (h1h5) for the parent Book Component, as outlined in the previous Headings section (e.g., an <h1> for a chapter <header>); then zero or more <p> elements for subtitles or author attributions, each of which must have a data-type of either subtitle or author


<section data-type="chapter">
    <h1>Chapter title</h1>
    <p data-type="subtitle">Chapter subtitle</p>
  <!-- Chapter content here... -->

Interactive Elements


HTML element: <video>


Note: Fallback content is strongly recommended for output formats that do not support HTML5 interactive content

<video id="asteroids_video" width="480" height="270" controls="controls" poster="images/fallback_image.png">
<source src="video/html5_asteroids.mp4" type="video/mp4"/>
<source src="video/html5_asteroids.ogg" type="video/ogg"/>
<em>Sorry, the &lt;video&gt; element not supported in your
  reading system. View the video online at</em>


HTML element: <audio>

Note: Fallback content is strongly recommended for output formats that do not support HTML5 interactive content


<audio id="new_slang">
<source src="audio/new_slang.wav" type="audio/wav"/>
<source src="audio/new_slang.mp3" type="audio/mp3"/>
<source src="audionew_slang.ogg" type="audio/ogg"/>
<em>Sorry, the &lt;audio&gt; element is not supported in your
  reading system. Hear the audio online at</em>


HTML element: <canvas>

Notes: Should include fallbacks for environments that don’t support HTML5 or JavaScript (e.g., link or image). You may include <script> elements in your HTMLBook document <head> elements to include/reference JS code for Canvas handling.


<canvas id="canvas" width="400" height="400">
 Your browser does not support the HTML 5 Canvas. See the interactive example at


To add comments to an HTMLBook document, either use standard HTML/XML comment syntax:

<!-- This is a comment -->

Or add a data-type="comment" attribute to any HTML element, e.g.:

<div data-type="comment">This is a comment preceding a paragraph of text</div>
<p>This is a paragraph of text <span data-type="comment">Inline comment in paragraph</span></p>


Metadata points

HTML element: <meta>

Attribute requirements: name (for name of metadata point); content (for value of metadata point)

Content model: Empty

Note: All <meta> elements must be children of the <head> element of the HTML file.


  <title>Title of the Book</title>
  <meta name="isbn-13" content="9781449344856"/>

Element Classification

Block Elements

In HTMLBook, the majority of elements classified by the HTML5 specification as Flow Content (minus elements also categorized as Heading Content, Phrasing Content, and Sectioning Content) are considered to be Block Elements. Here is a complete list:

Inline Elements

In HTMLBook, the majority of elements classified by the HTML5 specification as Phrasing Content are considered to be Inline Elements. Here is a complete list: