Re: [Rfc-markdown] Markdown for presentations

Benson Muite <benson_muite@emailplus.org> Sat, 24 July 2021 07:21 UTC

Return-Path: <benson_muite@emailplus.org>
X-Original-To: rfc-markdown@ietfa.amsl.com
Delivered-To: rfc-markdown@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 98DEE3A2EBF for <rfc-markdown@ietfa.amsl.com>; Sat, 24 Jul 2021 00:21:28 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.098
X-Spam-Level:
X-Spam-Status: No, score=-2.098 tagged_above=-999 required=5 tests=[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, NICE_REPLY_A=-0.001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=emailplus.org header.b=cJ/xvAjw; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=Be4GTA7F
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 5P3kieBwzJjE for <rfc-markdown@ietfa.amsl.com>; Sat, 24 Jul 2021 00:21:23 -0700 (PDT)
Received: from out4-smtp.messagingengine.com (out4-smtp.messagingengine.com [66.111.4.28]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 9B3033A3064 for <rfc-markdown@ietf.org>; Sat, 24 Jul 2021 00:21:21 -0700 (PDT)
Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.nyi.internal (Postfix) with ESMTP id 7A35F5C00AE; Sat, 24 Jul 2021 03:21:17 -0400 (EDT)
Received: from mailfrontend2 ([10.202.2.163]) by compute4.internal (MEProxy); Sat, 24 Jul 2021 03:21:17 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=emailplus.org; h=subject:to:cc:references:from:message-id:date:mime-version :in-reply-to:content-type:content-transfer-encoding; s=fm1; bh=V IvRuRuRN5C0pPhET3HirXRzjslIxo8Thc/aExiM3BE=; b=cJ/xvAjw7LN40gHVS Tnp2HBnRyBVh0k645kmsCNDrfQAu/RtVNTZqN9TrdYXtL9c+8vxKL+46xybQwm3J CRSzTcQozzrfPa+5b9Y3S/gYVsmNDTNap85C++BpFdCyA0DNeC46c40t4mlqC4q7 bc+a43+SBw7YzeClrSwKORZcBOJS3hNDXgzzErBCviGmPlWKYtivUDqzjfTfH6U2 2jS9PuFGJkUZJkgTAm/TGpw+xLEG7vKEPpgTwcXlM4qRvGSnq3VoHMHafNL+jTq8 5W4lojeRibySRVlwznqOdIKy3Q+D86WHq4oepEJNQcYNA1rCEt3/ELrgwVatw65u HOlow==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm3; bh=VIvRuRuRN5C0pPhET3HirXRzjslIxo8Thc/aExiM3 BE=; b=Be4GTA7F06+Zyo7NirfF7jVLUgHd/Jl7Fal0+6lCCuvFlD7iOs+7uDyFP VXl1P8tGESB8efhXHn9VCPcGB0o0643MJZ9XOXxJoouIAhpa0qwE2LdAnyPdtidw 5xWJbG/IlRqtSxbphurqI21DLEX79L54i12Ni3jGITdqB3fhTQhanEs8Dbscri9D /0aG5yHKZ/Ti7/fwBalLXVoPsmr3gFkmhfDPmaqKanITbduAU/cpEvpK1dwvH9Qt UpGYJG8yLN+gRRF0FWbhFd7UJ2/dddm1SqWjQ5rAsHL+veGGYI+GoDXFT5wKvxxg 52g24tXimfPg7/1Hq4eP9sjZe+lXw==
X-ME-Sender: <xms:bL_7YOrQBH3JNSvBQ_d0YaoDWy8mcpp-P-Eyna5kEyI8uPQ-lvUZIw> <xme:bL_7YMpLbVoYJMSYChQkKORGn8RousRgk8P8ovU3KSxvVptmFFQu-dpTQtww_JUvI lJPHAVBOavqrF0w>
X-ME-Received: <xmr:bL_7YDMZObQ8isQvvZe4Xiu_F7KMi9seQ72xqBh4YIKmTirdwH1ph_wkRi4izpyIPoy6kK81KLX7>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvtddrfeelgdduudeiucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhepuffvfhfhkffffgggjggtgfesthekredttdefjeenucfhrhhomhepuegvnhhs ohhnucfouhhithgvuceosggvnhhsohhnpghmuhhithgvsegvmhgrihhlphhluhhsrdhorh hgqeenucggtffrrghtthgvrhhnpeefieelheettedugeethfefjefgjeetgfduteeutedu jeetheehteegleekledvjeenucffohhmrghinhepihgvthhfrdhorhhgpdhgihhthhhusg drtghomhdprhgvmhgrrhhkjhhsrdgtohhmpdhrfhgtqdgvughithhorhdrohhrghenucev lhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpegsvghnshhonh gpmhhuihhtvgesvghmrghilhhplhhushdrohhrgh
X-ME-Proxy: <xmx:bL_7YN742sJtClPxv712n4HLcebXbsJz_xnouqctU4TycEB5m8EEwA> <xmx:bL_7YN4uv9-wMIVnh_8S6Dz2EjQsXCToU3BsmCdWFNGKSzQIlDG8Ug> <xmx:bL_7YNgEEUJ9S-vf2at__AZ1M1oj7Llf8ynfpQE9hZjhf_OtvIUM1w> <xmx:bb_7YKgJryvZdRFU3zHmgwHXj2rRl--DiBum-aEdOxmkjKXUqMc9mQ>
Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sat, 24 Jul 2021 03:21:14 -0400 (EDT)
To: Carsten Bormann <cabo@tzi.org>
Cc: rfc-markdown@ietf.org
References: <3aa516c7-20fa-c424-3664-10dbb8e54538@emailplus.org> <9BC67769-0E8B-49B7-A90D-F61ED1651BE4@tzi.org>
From: Benson Muite <benson_muite@emailplus.org>
Message-ID: <18778d59-308f-cc91-08d5-1cc6cbf30255@emailplus.org>
Date: Sat, 24 Jul 2021 10:21:06 +0300
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.10.1
MIME-Version: 1.0
In-Reply-To: <9BC67769-0E8B-49B7-A90D-F61ED1651BE4@tzi.org>
Content-Type: text/plain; charset="utf-8"; format="flowed"
Content-Language: en-US
Content-Transfer-Encoding: 8bit
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/ytwLLqIVcNm1UCjhdyl2Lvn1UEs>
Subject: Re: [Rfc-markdown] Markdown for presentations
X-BeenThere: rfc-markdown@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "rfc-markdown is a discussion list for people writing I-Ds and RFCs in Markdown and the authors of the tools used for that." <rfc-markdown.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rfc-markdown/>
List-Post: <mailto:rfc-markdown@ietf.org>
List-Help: <mailto:rfc-markdown-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sat, 24 Jul 2021 07:21:29 -0000

> 
> There also have been various HTML-based slide presenters.  In the mid-2000s s5.html was popular; today reveal.js seems to be leading the mindshare in javascript packages for putting up HTML-based slides.
This is a nice package, though maybe heavier than what is needed when 
using a Git powered workflow. It has good design choices.
> 
> remark [1] [2], as used by the hackathon template, enables the use of markdown inside such an HTML-based deck; the JavaScript slide presenter inside an HTML shell essentially interprets that pasted-in markdown.
> 
My only worry is that some knowledge of HTML is required to use remark.
> Today, many markdown-based tools also include a slide mode.
> For instance the markdown-based collaborative editor Hedgedoc (née hackmd and then for a while CodiMD) has a slide mode; this is directly accessible on IETF’s codimd.ietf.org as well.
This is nice, seems to use revealjs. Does not require knowledge of Git.
> 
> I personally use a paid Mac-only tool called Deckset (which I cannot recommend to IETFers, but only because of “the illusion of vendor support” [RFC0873]).  It does serve me well, and the markdown ports back and forth great between code, slides, and I-Ds.
Nice to see that people are building other tools based on this.
> 
> The slide deck aspect (new slide, incremental builds, footers, styles) of markdown isn’t really written down, so everyone has their own little markdown extensions, e.g., [3], but these are similar enough and slide decks are usually small enough that a little hand conversion doesn’t hurt too much.
> 
Markdown slides do enable a very nice separation of concerns between the 
content and the template. Modifying a parser is ok for those with 
technical backgrounds/interest. There will be an audience of people, not 
all of whom have high technical backgrounds/interest, who want to make 
their presentation decks available to their presenters while they speak. 
  Making it easy to create portable Markdown presentation content might 
be helpful. PDF is not so great for online viewing and sharing, for 
example for IETF presentations:
https://datatracker.ietf.org/meeting/110/proceedings
Having a consistent format would also enable better data tracking of 
IETF presentation content.
> Grüße, Carsten
> 
> [1]: https://github.com/gnab/remark
> [2]: https://remarkjs.com/
> [RFC0873]: Padlipsky, M., "Illusion of vendor support", RFC 873, DOI 10.17487/RFC0873, September 1982, <https://www.rfc-editor.org/info/rfc873>.
> [3]: https://github.com/gnab/remark/wiki/Markdown
>