Setting up the appendices to use ReSpec external include functionality.
authorJames Craig <jcraig@apple.com>
Sun, 02 Dec 2012 00:18:58 -0800
changeset 39 559fb035ef7b
parent 38 53dd2ae6bed5
child 40 af76dc7646fb
Setting up the appendices to use ReSpec external include functionality.
src/csi/screen.css
src/css/screen.css
src/include/ack.html
src/include/terms.html
src/indie-ui-context.html
src/indie-ui-events.html
src/ssi/ack.html
src/ssi/terms.html
--- a/src/csi/screen.css	Sat Dec 01 23:28:50 2012 -0800
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,92 +0,0 @@
-
-.note {
-	border-color: #585;
-}
-.note-title span {
-	color: #585;
-	font-weight: bold;
-}
-
-.ednote {
-	color:#c00 !important;
-	font-style:italic;
-	position:relative;
-}
-div.ednote, p.ednote{
-	padding-right:150px;
-}
-div.ednote:before, p.ednote:before{
-	content: 'Editorial Note';
-	position:absolute;
-	top:0;
-	right:0;
-	font-size:11px;
-	padding:0.2em 0.5em;
-	margin:0;
-	border:solid 1px #c00;
-}
-
-.todo, .todo:before {
-	color:#c00 !important;
-	border-color:#c00 !important;
-}
-.todo[title]:before{
-	content: 'To-do';
-	position:absolute;
-	top:0;
-	right:0;
-	font-size:11px;
-	padding:0.2em 0.5em;
-	margin:0;
-	border:solid 1px #c00;
-	border-width: 0 0 1px 1px;
-}
-
-.example {
-	margin: 1em 0;
-	padding: 0.7em 1em 0.2em;
-	border: solid 1px #999;
-	position:relative;
-}
-.example[title]:before{
-	content:attr(title);
-	position:absolute;
-	top:0;
-	left:0;
-	font-size:11px;
-	padding:0.2em 0.5em;
-	margin:0;
-	border:solid 1px #999;
-	border-width: 0 1px 1px 0;
-}
-.example h4, .note h4{
-	margin:0.5em 0;
-}
-.example ol li, .note ol li{
-	margin:0 0 0.5em;
-}
-
-html code, html pre, html kbd{ /* more specific selector than the default W3C style sheet */
-	/* Most browsers default 'monospace' to Courier, which has an ex-height of about 60% normal size. */
-	/* Monaco has a normal ex-height so font sizes appear more consistent with surrounding non-monospaced text. */
-	font-family: "Monaco", "Courier New", "Courier", monospace;
-	font-family: "Monaco", "Courier New", "Courier"; /* declare as separate rule to account for browser font-size inconsistencies, monospace fallback from previous rule should still work in the [almost non-existant] case that a user system does not have Courier */
-	font-size:0.9em;
-}
-html kbd {
-	text-transform: lowercase;
-	font-variant: small-caps;
-	font-style: bold;
-	font-size:1em; 
-}
-html pre { /* more specific selector than the default W3C style sheet */
-	font-size:0.75em; /* text in blocks code blocks looked too big now that font is back to normal size */
-	line-height:1.4; /* [sic] unitless multiplier, not EM size */
-}
-code sup {
-	font-size:0.73em;
-}
-.placeholder {
-	color:#999;
-	font-style:italic;
-}
\ No newline at end of file
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/css/screen.css	Sun Dec 02 00:18:58 2012 -0800
@@ -0,0 +1,92 @@
+
+.note {
+	border-color: #585;
+}
+.note-title span {
+	color: #585;
+	font-weight: bold;
+}
+
+.ednote {
+	color:#c00 !important;
+	font-style:italic;
+	position:relative;
+}
+div.ednote, p.ednote{
+	padding-right:150px;
+}
+div.ednote:before, p.ednote:before{
+	content: 'Editorial Note';
+	position:absolute;
+	top:0;
+	right:0;
+	font-size:11px;
+	padding:0.2em 0.5em;
+	margin:0;
+	border:solid 1px #c00;
+}
+
+.todo, .todo:before {
+	color:#c00 !important;
+	border-color:#c00 !important;
+}
+.todo[title]:before{
+	content: 'To-do';
+	position:absolute;
+	top:0;
+	right:0;
+	font-size:11px;
+	padding:0.2em 0.5em;
+	margin:0;
+	border:solid 1px #c00;
+	border-width: 0 0 1px 1px;
+}
+
+.example {
+	margin: 1em 0;
+	padding: 0.7em 1em 0.2em;
+	border: solid 1px #999;
+	position:relative;
+}
+.example[title]:before{
+	content:attr(title);
+	position:absolute;
+	top:0;
+	left:0;
+	font-size:11px;
+	padding:0.2em 0.5em;
+	margin:0;
+	border:solid 1px #999;
+	border-width: 0 1px 1px 0;
+}
+.example h4, .note h4{
+	margin:0.5em 0;
+}
+.example ol li, .note ol li{
+	margin:0 0 0.5em;
+}
+
+html code, html pre, html kbd{ /* more specific selector than the default W3C style sheet */
+	/* Most browsers default 'monospace' to Courier, which has an ex-height of about 60% normal size. */
+	/* Monaco has a normal ex-height so font sizes appear more consistent with surrounding non-monospaced text. */
+	font-family: "Monaco", "Courier New", "Courier", monospace;
+	font-family: "Monaco", "Courier New", "Courier"; /* declare as separate rule to account for browser font-size inconsistencies, monospace fallback from previous rule should still work in the [almost non-existant] case that a user system does not have Courier */
+	font-size:0.9em;
+}
+html kbd {
+	text-transform: lowercase;
+	font-variant: small-caps;
+	font-style: bold;
+	font-size:1em; 
+}
+html pre { /* more specific selector than the default W3C style sheet */
+	font-size:0.75em; /* text in blocks code blocks looked too big now that font is back to normal size */
+	line-height:1.4; /* [sic] unitless multiplier, not EM size */
+}
+code sup {
+	font-size:0.73em;
+}
+.placeholder {
+	color:#999;
+	font-style:italic;
+}
\ No newline at end of file
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/include/ack.html	Sun Dec 02 00:18:58 2012 -0800
@@ -0,0 +1,4 @@
+<h2>Acknowledgements</h2>
+<p class="placeholder">Add members of IndieUI group at time of publishing.</p>
+	<!-- Add special thanks. -->
+	<!-- Add link to original proposal by James/Chris at http://lists.w3.org/Archives/Public/www-dom/2010JulSep/att-0106/UserInterfaceIndependence.html -->
\ No newline at end of file
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/include/terms.html	Sun Dec 02 00:18:58 2012 -0800
@@ -0,0 +1,18 @@
+<h2>Important Terms</h2>
+<dl>
+	
+	<dt id="def_assistive_technology">Assistive Technology</dt>
+	<dd class="placeholder">TBD</dd>
+	
+	<dt id="def_point_of_regard">Point-of-Regard</dt>
+	<dd class="placeholder">TBD</dd>
+	
+	<dt id="def_request_event_receiver">Request Event Receiver</dt>
+	<dd>
+		<p class="ednote">TBD: need to explain difference between the event.target, the element handler the event (addEventListener), and the "receiver" of the UIRequestEvent. The event "receiver" will be author-defined with an attribute (potentially @actions or @ui-actions) that describe the type of UI actions that can be performed on the element (the UIRequestEvent "receiver") as is a contract declaration of the types of UIRequestEvents that will be received and handled by the web application.</p>
+	</dd>
+	
+	<dt id="def_user_agent">User Agent</dt>
+	<dd class="placeholder">TBD</dd>
+	
+</dl>
\ No newline at end of file
--- a/src/indie-ui-context.html	Sat Dec 01 23:28:50 2012 -0800
+++ b/src/indie-ui-context.html	Sun Dec 02 00:18:58 2012 -0800
@@ -3,7 +3,7 @@
 	<head>
 		<meta http-equiv="Content-type" content="text/html; charset=utf-8">
 		<title>IndieUI 1.0: User Context</title>
-		<link href="./csi/screen.css" rel="stylesheet" type="text/css">
+		<link href="./css/screen.css" rel="stylesheet" type="text/css">
 		
 		<!-- 
       === NOTA BENE ===
@@ -45,7 +45,7 @@
           // it is recommended that the respec.css stylesheet be kept
           extraCSS:             [
             "http://dev.w3.org/2009/dap/ReSpec.js/css/respec.css",
-            "./csi/screen.css"
+            "./css/screen.css"
           ],
 
           // editors, add as many as you like
@@ -308,11 +308,13 @@
 		</section>
 		<!-- :::::::::::::::::::: END window.accessibility :::::::::::::::::::: -->
 		
-		
-		<section class="placeholder appendix">
-			<h2>Acknowledgements</h2>
-			<p>Placeholder for footer content (acknowledgements, terms, etc.)</p>
-		</section>
+		<!--
+		ReSpec example: Use @data-transform to reuse a content transformer, and @data-oninclude to transform external content prior to inclusion.
+		<script type="text/javascript">function xmp(r, content) { return content.replace(/</g,'&lt;').replace(/>/g,'&gt;'); } </script>
+		<pre data-transform='xmp'>This markup is <b>escaped</b> like an <code>xmp</code>.</pre>
+		-->
+		<section id="terms" class="appendix" data-include="./include/terms.html"></section>
+		<section id="acknowledgements" class="appendix" data-include="./include/ack.html"></section>
 		
 	</body>
 </html>
--- a/src/indie-ui-events.html	Sat Dec 01 23:28:50 2012 -0800
+++ b/src/indie-ui-events.html	Sun Dec 02 00:18:58 2012 -0800
@@ -3,7 +3,7 @@
 	<head>
 		<meta http-equiv="Content-type" content="text/html; charset=utf-8">
 		<title>IndieUI: Events 1.0</title>
-		<link href="./csi/screen.css" rel="stylesheet" type="text/css">
+		<link href="./css/screen.css" rel="stylesheet" type="text/css">
 		
 		<!-- 
       === NOTA BENE ===
@@ -45,7 +45,7 @@
           // it is recommended that the respec.css stylesheet be kept
           extraCSS:             [
             "http://dev.w3.org/2009/dap/ReSpec.js/css/respec.css",
-            "./csi/screen.css"
+            "./css/screen.css"
           ],
 
           // editors, add as many as you like
@@ -520,36 +520,13 @@
 		</section>
 		<!-- :::::::::::::::::::: END Accessibility Event Interfaces :::::::::::::::::::: -->
 
-		<section class="appendix">
-			<h2>Appendices</h2>
-			
-			<section id="terms">
-				<h3>Important Terms</h3>
-				<dl>
-					
-					<dt id="def_assistive_technology">Assistive Technology</dt>
-					<dd class="placeholder">TBD</dd>
-					
-					<dt id="def_point_of_regard">Point-of-Regard</dt>
-					<dd class="placeholder">TBD</dd>
-					
-					<dt id="def_request_event_receiver">Request Event Receiver</dt>
-					<dd>
-						<p class="ednote">TBD: need to explain difference between the event.target, the element handler the event (addEventListener), and the "receiver" of the UIRequestEvent. The event "receiver" will be author-defined with an attribute (potentially @actions or @ui-actions) that describe the type of UI actions that can be performed on the element (the UIRequestEvent "receiver") as is a contract declaration of the types of UIRequestEvents that will be received and handled by the web application.</p>
-					</dd>
-					
-					<dt id="def_user_agent">User Agent</dt>
-					<dd class="placeholder">TBD</dd>
-					
-				</dl>
-			</section>
-			
-			<section id="acknowledgements">
-				<h3>Acknowledgements</h3>
-				<p class="placeholder">Placeholder for footer content (acknowledgements, terms, etc.)</p>
-			</section>
-			
-		</section>
+		<!--
+		ReSpec: Use @data-transform to reuse a JavaScript content formatter, and @data-oninclude to transform external content before inclusion.
+		<script type="text/javascript">function xmp(r, content) { return content.replace(/</g,'&lt;').replace(/>/g,'&gt;'); } </script>
+		<pre data-transform='xmp'>This markup is <b>escaped</b> like an <code>xmp</code>.</pre>
+		-->
+		<section id="terms" class="appendix" data-include="./include/terms.html"></section>
+		<section id="acknowledgements" class="appendix" data-include="./include/ack.html"></section>
 		
 	</body>
 </html>
--- a/src/ssi/ack.html	Sat Dec 01 23:28:50 2012 -0800
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,6 +0,0 @@
-<div class="section" id="acknowledgements">
-	<p>Placeholder for Acknowledgements.</p>
-	<!-- Add members of IndieUI group at time of publishing. -->
-	<!-- Add special thanks. -->
-	<!-- Add link to original proposal by James/Chris at http://lists.w3.org/Archives/Public/www-dom/2010JulSep/att-0106/UserInterfaceIndependence.html -->
-</div>
\ No newline at end of file
--- a/src/ssi/terms.html	Sat Dec 01 23:28:50 2012 -0800
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,3 +0,0 @@
-<div class="section" id="terms">
-	<p>Placeholder for Glossary/Terms.</p>
-</div>
\ No newline at end of file