From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>
Received: from mp0 ([2001:41d0:2:4a6f::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by ms11 with LMTPS
	id IOxOOzozk19WdAAA0tVLHw
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Fri, 23 Oct 2020 19:47:06 +0000
Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by mp0 with LMTPS
	id 8Ac6Nzozk1/xSgAA1q6Kng
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Fri, 23 Oct 2020 19:47:06 +0000
Received: from lists.gnu.org (lists.gnu.org [209.51.188.17])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(No client certificate requested)
	by aspmx1.migadu.com (Postfix) with ESMTPS id 3ECCE9402A8
	for <larch@yhetil.org>; Fri, 23 Oct 2020 19:47:06 +0000 (UTC)
Received: from localhost ([::1]:40502 helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	id 1kW31j-0006yu-Jc
	for larch@yhetil.org; Fri, 23 Oct 2020 15:47:03 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:35096)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <tecosaur@gmail.com>)
 id 1kW315-0006yl-5H
 for emacs-orgmode@gnu.org; Fri, 23 Oct 2020 15:46:23 -0400
Received: from mail-pf1-x42d.google.com ([2607:f8b0:4864:20::42d]:33734)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.90_1) (envelope-from <tecosaur@gmail.com>)
 id 1kW310-0001Tu-13
 for emacs-orgmode@gnu.org; Fri, 23 Oct 2020 15:46:22 -0400
Received: by mail-pf1-x42d.google.com with SMTP id j18so2224854pfa.0
 for <emacs-orgmode@gnu.org>; Fri, 23 Oct 2020 12:46:17 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=user-agent:from:to:subject:date:message-id:mime-version;
 bh=N5WsBRo0kU5fNR/Qj+vuOPY3UmD/ein54EsyaZURUVU=;
 b=Z89xomPDiC5eAikTOP9RkDM3gPVLySLpx9fHcwZmcfY2iNYVi83AlH2EpxLh+Fy9hG
 PsQAEQA/8WUeglGTgcMiRYVmqmRInrmuimFcI+iuaYhQCtIHZ2fvfQ+EeH4lwLgL5Whe
 5ejUGLwohwc0dksqx2TBwMIFXOiePtCt0E2KPEQYW+4qxl0Sld0eTaXBhL8WEq7VhLBR
 ur8ggdD/T6vuzo2Uw4Pr0b26UDaLo05AGmVSsLptDjlPPICCMvefv745Oqsj51CyTZCz
 P/CH+BKiWxnbkzmCkOZ3xoVoKJVKXQ/j7xy+/vdEGGTighggG++ZrcSB5gjICTmh9q0S
 Xezg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:user-agent:from:to:subject:date:message-id
 :mime-version;
 bh=N5WsBRo0kU5fNR/Qj+vuOPY3UmD/ein54EsyaZURUVU=;
 b=DZg3BUgVL/lU8tNAuzPaNrjYNXXriDgHDoLNb8BIa2AsrHUJmaGuEIY+jhhgFWCAxg
 TPPKAve+Jiodj5cOuV2/FyRs3fA8BS3y9EwEyWVRBqHktRK3GuYd9OEGsgfcWubAcFYP
 ZotvYoDmKANmb/CyZr1tWIMqJX+d/vhFncv6h6OmmKy2LCcbBJz2TWGU5Av1p9cWjroO
 LKZwus0QkAd/+lSfxl9ZfScb7qYb+nElP8JAhi3QZUzCluEjMvxWXIEGFANjxB/SdoJb
 Pem05Eg9RX5NaWZZsVNLjqoVUUqzLWM1DOChqSuUBCWYNzeGmgiDHVQQ1z+5PR57D+3/
 mA+g==
X-Gm-Message-State: AOAM5327bPKa3gVPbZya4+zkpRhBzXNC1g8ivcP6+qEtkjMDjzdKn4xW
 FZ97y8SGw7v4slQ61rsgTtHw9Q6v/kw=
X-Google-Smtp-Source: ABdhPJx+vbAc4HkQoTWKaRrVml0LvzQ0cM6ku6kmbFHG1cSNhqAQbPtzVbdei0VSWVp+H87NOqv/mg==
X-Received: by 2002:a17:90a:430a:: with SMTP id
 q10mr4047864pjg.45.1603482375507; 
 Fri, 23 Oct 2020 12:46:15 -0700 (PDT)
Received: from localhost (180-150-91-8.b4965b.per.nbn.aussiebb.net.
 [180.150.91.8])
 by smtp.gmail.com with ESMTPSA id b1sm2821964pft.127.2020.10.23.12.46.13
 for <emacs-orgmode@gnu.org>
 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
 Fri, 23 Oct 2020 12:46:14 -0700 (PDT)
User-agent: mu4e 1.4.13; emacs 27.1
From: TEC <tecosaur@gmail.com>
To: org-mode-email <emacs-orgmode@gnu.org>
Subject: W3C violations in Org's HTML export
Date: Sat, 24 Oct 2020 03:04:22 +0800
Message-ID: <87sga4914t.fsf@gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; format=flowed
Received-SPF: pass client-ip=2607:f8b0:4864:20::42d;
 envelope-from=tecosaur@gmail.com; helo=mail-pf1-x42d.google.com
X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache.
 That's all we know.
X-Spam_score_int: -20
X-Spam_score: -2.1
X-Spam_bar: --
X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,
 DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001,
 RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-BeenThere: emacs-orgmode@gnu.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org
Sender: "Emacs-orgmode" <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>
X-Scanner: scn0
Authentication-Results: aspmx1.migadu.com;
	dkim=pass header.d=gmail.com header.s=20161025 header.b=Z89xomPD;
	dmarc=pass (policy=none) header.from=gmail.com;
	spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org
X-Spam-Score: -0.21
X-TUID: hnHN/jL0w5kv

Hi everyone,

In developing my take on the Org website and my coFig file, it has 
come
to my attention that there seem to be a few W3C violations in the 
HTML
export.

I always export with these settings,
which may affect some of the items below.
#+begin_src emacs-lisp
(setq org-html-doctype "html5"
      org-html-html5-fancy t)
#+end_src

* Error: Element p not allowed as child of element h2 in this 
  context
  Org currently seems to put a p.subtitle inside the heading.
  This violates the "phrasing content" restriction.
  https://html.spec.whatwg.org/multipage/sections.html#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements

** Suggestion
   Make the subtitle an independent element, is can still be a
   p.subtitle, just not /inside/ the h2 title

* Warning: The type attribute is unnecessary for JavaScript 
  resources.
  This seems to be from the '<script type="text/javascript">' code
  highlighting script.

** Suggestion
   Remove the ' type="text/javascript"' part of that.

* Error: Attribute alt not allowed on element object at this 
  point.
  This occurs when one has an svg figure, and one wishes to add 
  alt text
  (good for accessibility). This is of course applied to the 
  <object
  type="image/svg+xml">.
  
  What's interesting here is that the benefit of using an <object> 
  over
  an <img> for SVGs seems to basically be that it allows for a 
  raster
  fallback (with the downside that it is downloaded even when not
  needed). However... if we're using HTML5, the <picture> element 
  exists
  for exactly this case, and provides a better implementation of
  fallbacks. Even if one is not using HTML5, I don't see any way 
  that
  Org actually makes use of the potential for a raster fallback 
  ...
  raising the question of why an <object> is used over <img> in 
  the
  first place. It appears that browser support for SVGs in <img> 
  tags
  was originally sketchy, however that issue seems to have bee 
  long
  since resolved: https://caniuse.com/svg-img

** Suggestion
   Switch <object> to <img> for SVGs, if Org does add a mechanism 
   for
   defining fallback images in the future, use <picture> with 
   HTML5

* Error: Duplicate ID org0424ed6.
  Clearly, this can happen. I'm not sure how.
  I'd like to draw attention to this email I sent a while ago 
  (excuse
  the mangled start)
  https://orgmode.org/list/E1jxAjq-0004Dk-LH@lists.gnu.org/

* Error: Character reference expands to a control character 
  (U+0002).
  I have no idea where this is coming from, or why it's there --- 
  but it
  is, and it's not alone:
  + Error: Character reference expands to a control character 
  (U+001d).
  + Error: Character reference expands to a control character 
  (U+001f).
  + Error: Character reference expands to a control character 
  (U+0016).
  + Error: Character reference expands to a control character 
  (U+000f).
  + Warning: Document uses the Unicode Private Use Area(s), which 
  should
    not be used in publicly exchanged documents. (Charmod C073)
  + Error: Character reference expands to a control character 
  (U+001b).

  I suspect this may be htmlize, but I'm not sure, and it's 
  Org-related,
  so I'll include it.

* (not an error) Difficulty in 'wrapping' sections
  It's quite reasonable (IMO) to want to wrap a (sub*)section in a
  certain element, such as a link. Indeed I've wanted to do this 
  to
  create clickable 'cards' on the homepage of my org website 
  revamp.
  Unfortunately there doesn't seem to be any property like 
  :HTML_WRAP:
  etc. that can be applied, forcing me to try this:

  #+begin_src org
  ,** Features
  @@html:<a href="features.html">@@
  [[file:resources/img/stars.svg]]

  Delve into the possibilities.
  @@html:</a>@@
  #+end_src

  This produces the following errors:
  + Error: End tag p seen, but there were open elements.
  + Error: Unclosed element a.
  + Error: End tag a violates nesting rules.
  + Fatal Error: Cannot recover after last error. Any further 
  errors
    will be ignored.

  It would be good to have a way to do this that doesn't cause W3C
  issues.

That's all that I could see on a first glance. I'm hoping that
documenting these issues here will be the first step to solving 
them.

To identify these issues, I applied https://validator.w3.org/ to
https://orgmode.tecosaur.com/ and 
https://tecosaur.github.io/emacs-config/config.html

All the best,

Timothy.