From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id QBmfOSZdOWN/ewAAbAwnHQ (envelope-from ) for ; Sun, 02 Oct 2022 11:43:03 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id 0PF9OCZdOWMGSwAAG6o9tA (envelope-from ) for ; Sun, 02 Oct 2022 11:43:02 +0200 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 9EB9BAD2C for ; Sun, 2 Oct 2022 11:43:01 +0200 (CEST) Received: from localhost ([::1]:47808 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oevUy-0006MP-QA for larch@yhetil.org; Sun, 02 Oct 2022 05:43:00 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:48152) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oevTy-0006M8-2a for emacs-orgmode@gnu.org; Sun, 02 Oct 2022 05:42:00 -0400 Received: from mail-pg1-x530.google.com ([2607:f8b0:4864:20::530]:40461) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oevTw-0004vh-7R for emacs-orgmode@gnu.org; Sun, 02 Oct 2022 05:41:57 -0400 Received: by mail-pg1-x530.google.com with SMTP id 2so1957771pgl.7 for ; Sun, 02 Oct 2022 02:41:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:message-id:date:references:in-reply-to:subject:cc:to :from:from:to:cc:subject:date; bh=hdkls624cpXU1mM4cmxWR1WrrhroWdB80llktio/jwQ=; b=mnnjPrPb0uf4CqJ/xb57nXkys7UQHfObKUz9YRQJoptFahimnkD5HJxz0IMdZhhBv+ OQJ0fvVuvdsug8yVIM51dY9uPAcyJchWwBRGQgD/H+V7nrsLnp9eGRLLCThUZPdlvRdv kX2ECezCMt3j2wnVJ9IuIMrkjDxdiU+tyEsYyNbdtcbD0RZYpCQQZ7WUZIpFvGMf4wNd Eh3uBy0vl2lpgpNF2LNhyF5862lQuT/znexEY9fXDhy69ubMYlTRMaoLcixb2RLbIrDJ 0dOJTEqWcsNXvN4XpZfmSDPAvq0jSxVd8KSRGEwLZwT5jRUyhqzvwWmQGxQimoz6A1Cb pxlg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=mime-version:message-id:date:references:in-reply-to:subject:cc:to :from:x-gm-message-state:from:to:cc:subject:date; bh=hdkls624cpXU1mM4cmxWR1WrrhroWdB80llktio/jwQ=; b=frzd6veqvvfNT//T5pvEkj/o1SXgqmODxRpyNuDyjQ68NEL1lmXMCarJtNwVj+gs1+ /bJ0Cc+OjssTlZok/mHSk74Y/2INTSfMdB4f7tLayqC7kBIFto4jYNIRD5mJs+h4LIqN JV9b73Z4S0hP8yoRD25gsdw5vBmhrxlscf9WYnQPsFnLP9m6X/1yZE+d91xQmaAOHHFU HQHtqenCym164ArDE4hxTzDPP30bsO30fSfI9BpF8HWvmKTME2J+jZpp7xdF6I5GsZDq AsKj6NLSUGX2Dunq7ybo1/MWUOv+/BQ2eMJpMAP3290xCXCsfgW2ZtVYx6CAOiZZZEeS l0cg== X-Gm-Message-State: ACrzQf069Gq7/gqes9TJBAre2JoaOgDe115o09RcvDiUkMW0TpHyyvdi G9kbXrF4qaQ8//kZgf92/VE= X-Google-Smtp-Source: AMsMyM6YiATDvWNlk37Pw0QAuVBveIblbgbb0TuCO7HB4UBb7lIWA7gZdtPVZXQ2IR1qNxAtzRREtw== X-Received: by 2002:a05:6a00:248b:b0:542:6ae2:24d5 with SMTP id c11-20020a056a00248b00b005426ae224d5mr17596462pfv.65.1664703712327; Sun, 02 Oct 2022 02:41:52 -0700 (PDT) Received: from localhost ([2409:8970:a80:3a4:8ec6:81ff:fe70:339d]) by smtp.gmail.com with ESMTPSA id f184-20020a6251c1000000b00537b6bfab7fsm5222615pfb.177.2022.10.02.02.41.49 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 02 Oct 2022 02:41:51 -0700 (PDT) From: Ihor Radchenko To: Tim Cross Cc: Timothy , Jude DaShiell , emacs-orgmode@gnu.org Subject: [HELP] Help implementing org-lint/warnings buffer during export (was: Org HTML export accessibility (was: org exported pdf files)) In-Reply-To: <86pmfeo4os.fsf@gmail.com> References: <87a66lpm5p.fsf@localhost> <8735cdpkiz.fsf@localhost> <87y1u5o1ko.fsf@localhost> <87a66k2j5y.fsf@tec.tecosaur.net> <7edd911f-b74-6521-634e-7f30acdb5fad@panix.com> <867d1nj1yn.fsf@gmail.com> <877d1n3ky0.fsf@tec.tecosaur.net> <86tu4ro11c.fsf@gmail.com> <87edvu95yr.fsf@localhost> <86pmfeo4os.fsf@gmail.com> Date: Sun, 02 Oct 2022 17:42:42 +0800 Message-ID: <87pmfazhm5.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::530; envelope-from=yantar92@gmail.com; helo=mail-pg1-x530.google.com X-Spam_score_int: -17 X-Spam_score: -1.8 X-Spam_bar: - X-Spam_report: (-1.8 / 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_ENVFROM_END_DIGIT=0.25, 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.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1664703781; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=hdkls624cpXU1mM4cmxWR1WrrhroWdB80llktio/jwQ=; b=ZtBfG3ySCkFMYl0kqpN4H9fS3JY7AQFOovZQyPGSFb2BC9M1RyzSDQNkW9D83ZF2M3pjiM +YtwsyheNHBPEOLJWfXKlDqjzTMnO0lIXRbbOPowOgr8A/dzSD2e90Ykpy2vchhd7QMpoS 7Ci4zi0IGJrwwKckeS19rE317PmiClsO1paN4yPy+Kk5HQM9vKy2tpCo50OPEHJYlWmGGz QJJgikLPhWJ6NbTpqaSj+VTDEnbHEY2vTV1xo7MolTXe8mMRnxTmM43WKul2YqJz5iW64/ vDn5LTud0LrZA3xlTcon+1SSbqFxBtHU1ar9goD2FYH0s/3FuJ8NIuBW9fzuCA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1664703781; a=rsa-sha256; cv=none; b=KwZ+i4pYP/6akQZDZRhOqjMwwcrX7L8FSi2e3ZAiHJT4ejf6vVTGbMtryLEP+KX9LEpiG5 vkEiJs5qkEH+no2zhKXdlA4k0AaCTaFTgqVWwc9vh9o7L/UqOngfRkA86t2+14jLxEO268 8NtNePqPi6w6n24sH/kr3VDrTgeM7jjmFzzS+dBubrnBIoixZjolqZkC27guAhIByVGcYG 0Iu9WI5DZ9zPYkT9eMrz1Iqjog6wWTmQd7HMZvTwbx6nr9oXb2Jw26pHy75ZFd7ryfWpxH /PPghsJGhUb3EwbrWzf2fiqtC1bi2R9IZBfDm8lc2fiqQSw+/xXD0Fb5OTGDxw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=mnnjPrPb; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -3.34 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=mnnjPrPb; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 9EB9BAD2C X-Spam-Score: -3.34 X-Migadu-Scanner: scn0.migadu.com X-TUID: 5yKG5pBlSJLg Tim Cross writes: > From an org-mode perspective, the key things which need to be maintained > (and which perhaps we could make even easier or possibly have > 'defaults') is the ability to add the alt attribute to any non-text > element. For example, images, videos, sound files etc. All such content > should always have some text describing the 'element'. However, it is > also important to be able to not have an alt tag in some situations (for > example, when using images as 'spacers' for formatting etc, we don't > want an alt tag. Things to be aware of are things like using single > characters or symbols (e.g. < and > for previous/next) or using unicode > and other symbols whose meaning/purpose may seem very obvious when > viewed, but is less so when 'spoken'. > > From an authoring perspective, it probably would be good if org mode was > able to alert the user to content which lacks an alt attribute but which > probably should have one e.g. an image with no caption, a link to a > video/audio file etc. This sounds like a good idea. Org currently attempts to be slightly helpful by indicating, for example, LaTeX compilation warnings. However, it is just done by writing a simple message in the echo area. What would be more useful is the kind of buffer displayed by org-lint, but instead used during export: - If there are any export issues (LaTeX errors/warnings) they can appear in the buffer - If there are any stylistic issues (like lack of alt attributes during html export), they can also appear Ideally, we should be able to jump directly to the line containing error. org-lint code could be used as a base, but otherwise we need to implement something generic way to check style/export warnings on per-backend basis. This is probably something we need to do before we dive into the accessibility specifics. AFAIU from the Tim's reply, many of the accessibility guidelines may need to be decided by the document author. Tim, let me know if I am wrong and some of the accessible tagging must be done unconditionally. I am marking this as a help request. Let me know what you think. -- Ihor Radchenko, Org mode contributor, Learn more about Org mode at https://orgmode.org/. Support Org development at https://liberapay.com/org-mode, or support my work at https://liberapay.com/yantar92