06.xhtml 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <!--
  3. h t t :: / / t /
  4. h t t :: // // t //
  5. h ttttt ttttt ppppp sssss // // y y sssss ttttt //
  6. hhhh t t p p s // // y y s t //
  7. h hh t t ppppp sssss // // yyyyy sssss t //
  8. h h t t p s :: / / y .. s t .. /
  9. h h t t p sssss :: / / yyyyy .. sssss t .. /
  10. <https://y.st./>
  11. Copyright © 2016 Alex Yst <mailto:copyright@y.st>
  12. This program is free software: you can redistribute it and/or modify
  13. it under the terms of the GNU General Public License as published by
  14. the Free Software Foundation, either version 3 of the License, or
  15. (at your option) any later version.
  16. This program is distributed in the hope that it will be useful,
  17. but WITHOUT ANY WARRANTY; without even the implied warranty of
  18. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  19. GNU General Public License for more details.
  20. You should have received a copy of the GNU General Public License
  21. along with this program. If not, see <https://www.gnu.org./licenses/>.
  22. -->
  23. <!DOCTYPE html>
  24. <html xmlns="http://www.w3.org/1999/xhtml">
  25. <head>
  26. <base href="https://y.st./en/weblog/2016/05-May/06.xhtml" />
  27. <title>The washing machine now leaks and Cyrus is probably coming back on Sunday. &lt;https://y.st./en/weblog/2016/05-May/06.xhtml&gt;</title>
  28. <link rel="icon" type="image/png" href="/link/CC_BY-SA_4.0/y.st./icon.png" />
  29. <link rel="stylesheet" type="text/css" href="/link/basic.css" />
  30. <link rel="stylesheet" type="text/css" href="/link/site-specific.css" />
  31. <script type="text/javascript" src="/script/javascript.js" />
  32. <meta name="viewport" content="width=device-width" />
  33. </head>
  34. <body>
  35. <nav>
  36. <p>
  37. <a href="/en/">Home</a> |
  38. <a href="/en/a/about.xhtml">About</a> |
  39. <a href="/en/a/contact.xhtml">Contact</a> |
  40. <a href="/a/canary.txt">Canary</a> |
  41. <a href="/en/URI_research/"><abbr title="Uniform Resource Identifier">URI</abbr> research</a> |
  42. <a href="/en/opinion/">Opinions</a> |
  43. <a href="/en/coursework/">Coursework</a> |
  44. <a href="/en/law/">Law</a> |
  45. <a href="/en/a/links.xhtml">Links</a> |
  46. <a href="/en/weblog/2016/05-May/06.xhtml.asc">{this page}.asc</a>
  47. </p>
  48. <hr/>
  49. <p>
  50. Weblog index:
  51. <a href="/en/weblog/"><abbr title="American Standard Code for Information Interchange">ASCII</abbr> calendars</a> |
  52. <a href="/en/weblog/index_ol_ascending.xhtml">Ascending list</a> |
  53. <a href="/en/weblog/index_ol_descending.xhtml">Descending list</a>
  54. </p>
  55. <hr/>
  56. <p>
  57. Jump to entry:
  58. <a href="/en/weblog/2015/03-March/07.xhtml">&lt;&lt;First</a>
  59. <a rel="prev" href="/en/weblog/2016/05-May/05.xhtml">&lt;Previous</a>
  60. <a rel="next" href="/en/weblog/2016/05-May/07.xhtml">Next&gt;</a>
  61. <a href="/en/weblog/latest.xhtml">Latest&gt;&gt;</a>
  62. </p>
  63. <hr/>
  64. </nav>
  65. <header>
  66. <h1>The washing machine now leaks and Cyrus is probably coming back on Sunday.</h1>
  67. <p>Day 00426: Friday, 2016 May 06</p>
  68. </header>
  69. <p>
  70. I spent most of the day cleaning up around the house and doing laundry.
  71. Unfortunately, our washing machine now leaks.
  72. Strange plastic pieces of the washing machine broke off yesterday in the wash, but now even more has broken off and we can see where they are coming from.
  73. Our hope is that what we are seeing are pieces of the washing machine&apos;s seal.
  74. If it&apos;s only the seal that&apos;s broken, that should be one of the easier and less expensive pieces to replace.
  75. </p>
  76. <p>
  77. I did some research on <a href="https://www.w3.org./TR/html5/"><abbr title="Extensible Hypertext Markup Language">XHTML</abbr>5</a> tags in order to make sure that my <abbr title="Extensible Hypertext Markup Language">XHTML</abbr>-to-plain-text conversion class in <a href="https://git.vola7ileiax4ueow.onion/y.st./include.d">include.d</a> takes into account all valid <abbr title="Extensible Hypertext Markup Language">XHTML</abbr>5 tags and built what I believe to be a complete list of valid tags.
  78. Any tag that is unrecognized or invalid will be treated as nonexistent by the conversion class, as if the tag wasn&apos;t even in the markup.
  79. This will allow <abbr title="Extensible Hypertext Markup Language">XHTML</abbr> documents that have other <abbr title="Extensible Markup Language">XML</abbr> types embedded in them to be processed without throwing errors or exceptions.
  80. Likewise, older and newer versions of <abbr title="Extensible Hypertext Markup Language">XHTML</abbr> should be processed fairly well.
  81. I worked a bit more on this class, but at this point, nothing notable is happening.
  82. I&apos;m simply going through the tag list, implementing anything easy to implement, removing anything that shouldn&apos;t be implemented from the list, and setting aside anything that will take more in-depth work to complete.
  83. With all the minor work out of the way, it&apos;ll be much easier to see the major work.
  84. In fact, I might even release it without certain features (such as <code>&lt;table/&gt;</code> tag processing) and release those later as improvements.
  85. I don&apos;t need such complex markup for my own use case and it&apos;d be nice to be able to get my site upgraded.
  86. The later improvements will be just for completeness, in case someone else decides to use my code and actually expects it to function in a reasonable way.
  87. </p>
  88. <p>
  89. If you&apos;re reading this and plan to use this code though, please realize that this is an <abbr title="Extensible Hypertext Markup Language">XHTML</abbr>-processing class.
  90. At it&apos;s core, it processes <abbr title="Extensible Markup Language">XML</abbr> and demands well-formed-ness.
  91. It cannot process <abbr title="Hypertext Markup Language">HTML</abbr> that isn&apos;t well-formed; to process <abbr title="Hypertext Markup Language">HTML</abbr>, said <abbr title="Hypertext Markup Language">HTML</abbr> must properly close elements, including by using the newly-allowed-in-<abbr title="Hypertext Markup Language">HTML</abbr> <abbr title="Extensible Markup Language">XML</abbr> self-closing syntax.
  92. This inability to process documents that aren&apos;t well-formed is not in any way a bug.
  93. Besides, if you get right down to it, the <abbr title="Extensible Markup Language">XML</abbr>-processing code that my class uses is built into <abbr title="PHP: Hypertext Preprocessor">PHP</abbr>.
  94. I can&apos;t fix up the parser to handle non-<abbr title="Extensible Markup Language">XML</abbr>.
  95. </p>
  96. <p>
  97. While researching <abbr title="Extensible Hypertext Markup Language">XHTML</abbr> tags, I found that I have been misusing a few tags.
  98. I can&apos;t go back and fix all four hundred twenty-six past journal entries.
  99. That simply isn&apos;t feasible.
  100. However, I&apos;ve reworked my main template code to allow for both the old weblog entries&apos; code and a new code setup in newer entries so that I can start using these tags correctly.
  101. First, the <code>&lt;q/&gt;</code> tag is supposed to be used only to quote things that were actually said or written, by either real or fictional entities.
  102. It should never be used to provide &quot;scare quotes&quot;.
  103. The &amp;quot; entity should be used to provide such quotation marks instead.
  104. The <code>&lt;title/&gt;</code> tag should provide a name for the page that is recognizable out of context.
  105. While the <code>&lt;h1/&gt;</code> tag is allowed to assume that the reader knows the context that it is used in, the <code>&lt;title/&gt;</code> tag is not allowed to take such liberties due to the <code>&lt;title/&gt;</code> often being recorded and displayed elsewhere, such as in bookmarks lists in most Web browsers.
  106. I&apos;ve added the <abbr title="Uniform Resource Identifier">URI</abbr> of each page to its respective <code>&lt;title/&gt;</code> tag.
  107. After all, what gives context better than a globally-unique identifier? Lastly, <code>&lt;h1/&gt;</code>, <code>&lt;h2/&gt;</code>, <code>&lt;h3/&gt;</code>, <code>&lt;h4/&gt;</code>, <code>&lt;h5/&gt;</code>, and <code>&lt;h6/&gt;</code> tags cannot be used to semantically extend another of these tags.
  108. For example, I&apos;ve been using <code>&lt;h1/&gt;</code> tags to provide the main title of my weblog entries while using <code>&lt;h2/&gt;</code> tags to provide a subheading that isn&apos;t used to denote a subsection.
  109. Such use is invalid.
  110. Instead, one option is to use the <code>&lt;header/&gt;</code> tag to group a <code>&lt;p/&gt;</code> tag to the <code>&lt;h1/&gt;</code> tag and use the <code>&lt;p/&gt;</code> tag to provide the subtitle.
  111. I&apos;ve now set up all new pages to use that style of heading.
  112. </p>
  113. <p>
  114. Cyrus left for Springfield today, but he didn&apos;t take the suitcase.
  115. Likewise, our mother told him to have a nice weekend, implying that he&apos;d be back on Sunday as usual.
  116. It sounds like at least for now, they are sort of getting along again.
  117. </p>
  118. <hr/>
  119. <p>
  120. Copyright © 2016 Alex Yst;
  121. You may modify and/or redistribute this document under the terms of the <a rel="license" href="/license/gpl-3.0-standalone.xhtml"><abbr title="GNU&apos;s Not Unix">GNU</abbr> <abbr title="General Public License version Three or later">GPLv3+</abbr></a>.
  122. If for some reason you would prefer to modify and/or distribute this document under other free copyleft terms, please ask me via email.
  123. My address is in the source comments near the top of this document.
  124. This license also applies to embedded content such as images.
  125. For more information on that, see <a href="/en/a/licensing.xhtml">licensing</a>.
  126. </p>
  127. <p>
  128. <abbr title="World Wide Web Consortium">W3C</abbr> standards are important.
  129. This document conforms to the <a href="https://validator.w3.org./nu/?doc=https%3A%2F%2Fy.st.%2Fen%2Fweblog%2F2016%2F05-May%2F06.xhtml"><abbr title="Extensible Hypertext Markup Language">XHTML</abbr> 5.1</a> specification and uses style sheets that conform to the <a href="http://jigsaw.w3.org./css-validator/validator?uri=https%3A%2F%2Fy.st.%2Fen%2Fweblog%2F2016%2F05-May%2F06.xhtml"><abbr title="Cascading Style Sheets">CSS</abbr>3</a> specification.
  130. </p>
  131. </body>
  132. </html>