Read Write Doc
Rediscover the beauty of HTMLby Read Write Tools
Read Write Doc is a distraction-free desktop app built on top of BLUEPHRASE. It is used for creating declarative templates and authoring HTML documents.
Why bother? Well, let's face it. HTML is not pretty.
Reading an HTML document is not for the faint-hearted. All those tags clutter things up. Fishing the author's words out of the tag soup is a challenge. And writing an HTML document is no better. Who wants to subject themselves to that torturous mix of
<tag>...</tag> for every highlighted word in their composition. It's slow and clumsy.
I'll show you how BLUEPHRASE cleans up the mess, and makes declarative templating and content authoring less of a chore.
Getting rid of tag soup
Take a look at this sample, written using BLUEPHRASE notation. Notice how the semantic meaning is still obvious, but the tags have mostly disappeared. The remainder is called semantax, which in this case is
h1, article, ul, b, blockquote, h2, and
When Read Write Doc is switched into preview mode, we can see how the browser renders it.
And in the source code view, we see how our BLUEPHRASE manuscript was compiled into HTML. It's straightforward and matches our expectations. Notice though, how the compiler generated the list items
<li>...</li> and paragraphs
<p>...</p> without requiring the author to be explicit. This is called implied semantax.
What I've demonstrated, in this first simple example, is an HTML fragment. We can expand it into a full document by enclosing it in a template.
!target-matter pragma, which is the insertion point for our HTML fragment.
In order to wrap our sample fragment with this enclosure, we amend the original sample with an
!enclosure pragma specifying the filename for the enclosure, and we identify a selector that triggers its use. In this case I've arbitrarily chosen the identifier
#story as the target matter to be wrapped.
We can examine the combined result when we switch Read Write Doc to HTML mode. Our document fragment is wrapped by our simple enclosure into a fully compliant HTML document ready for the internet.
BLUEPHRASE uses shorthand notation to specify attributes.
You've already seen one type of shorthand in action. It's the backtick delimiters `` used with the
!enclosure pragma, the
link to a CSS style sheet, and the anchor tag
a hyperlink destination. BLUEPHRASE understands these to be filename references or
href attributes or
src attributes based on their context within the document.
Another type of shorthand is a named attribute, which uses asterisk notation. You may have noticed its use in the meta tag
Two other commonly used shorthand symbols will be familiar to anyone that knows CSS. They are hashtag notation # for identifiers, and fullstop notation . for classnames. For example, we could modify our sample fragment to make use of
#story-title, .bullets and
.pull-quote to look something like this.
And the compiled HTML output would be as expected:
Read Write Doc is more than just a BLUEPHRASE wrapper. It also has syntax highlighting, HTML source code mode, spell-checking, PDF exports, and preview style-sheets. And BLUEPHRASE has much more than just declarative templating and shorthand notation. Together, they can be used to compose sophisticated documents for print or Web.
If your needs are simple, and you want a no-frills notepad-style templating app, you may be happy with Read Write Note. It has the same distraction-free authoring interface, and full BLUEPHRASE capabilities, including enclosures and shorthand notation.
You can also use Read Write View, a free app that lets you switch between BLUEPHRASE and browser preview mode. If you don't need syntax highlighting, you can create plain-text
.blue files in your favorite text editor, and compile them into HTML with Read Write View.
License and availability
Read Write Doc is available for Windows, Mac and Linux.
Read Write Doc Software License Agreement
Copyright © 2020 Read Write Tools.
- This Software License Agreement ("Agreement") is a legal contract between you and Read Write Tools ("RWT"). The "Materials" subject to this Agreement include the software app "Read Write Doc" and its associated documentation.
- By installing, copying or otherwise using the Materials, you agree to abide by the terms of this Agreement. If you choose not to agree with these provisions, you must uninstall and delete all copies of the Materials.
- The Materials are protected by United States copyright law, patent law, and trade secret law, as well as international treaties on intellectual property rights. The Materials are licensed, not sold to you, and can only be used in accordance with the terms of this Agreement. RWT is and remains the owner of all titles, rights and interests in the Materials, and RWT reserves all rights not specifically granted under this Agreement.
- Subject to the terms of this Agreement, RWT hereby grants to you a limited, non-exclusive license to use the Materials subject to the following conditions:
- You are allowed to install the Materials on more than one computer or device, as long as the Materials will not be used on more than one computer or device simultaneously. You may make additional copies of the Materials for backup purposes only.
- You may not distribute, publish, make publicly available, sub-license, sell, rent, or lease the Materials.
- You may not extract, decompile, or reverse engineer any binary or source code included in the Materials. Your license to use the Materials is limited to its use in its original packaged format, and does not include permission to extract or use parts on a separate basis.
- Node.js License
- V8 License
- Chromium License
- Electron License
- Ace License
- Joezone License
- Blue Phrase Processor Software License Agreement
The terms and conditions of those third-party agreements apply to the respective intellectual property covered by those software license agreements, and do not extend to any Material owned by Read Write Tools.