From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id yJ7nFaeIqGIQegEAbAwnHQ (envelope-from ) for ; Tue, 14 Jun 2022 15:09:59 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id EN2xFaeIqGInoAAAauVa8A (envelope-from ) for ; Tue, 14 Jun 2022 15:09:59 +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 EB0A73C1BC for ; Tue, 14 Jun 2022 15:09:58 +0200 (CEST) Received: from localhost ([::1]:55438 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o16Iw-00018e-5W for larch@yhetil.org; Tue, 14 Jun 2022 09:09:58 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:59612) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o16GX-0007pY-3F for emacs-orgmode@gnu.org; Tue, 14 Jun 2022 09:07:29 -0400 Received: from mail-pg1-x532.google.com ([2607:f8b0:4864:20::532]:39837) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1o16GO-000134-GC for emacs-orgmode@gnu.org; Tue, 14 Jun 2022 09:07:27 -0400 Received: by mail-pg1-x532.google.com with SMTP id q140so8463715pgq.6 for ; Tue, 14 Jun 2022 06:07:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=user-agent:from:to:subject:date:message-id:mime-version; bh=y46H4rrK5lchoW+dO0kxnXM4u/K7oetnmG8JsRVffKE=; b=dYdroUy3lz+eBCEBGdNO730OgI7oaOb13v5RQUcpg17ikN9K9AeLDTyjKlm0Qkatrl 099l5OS2uYlK9NMJ2IbvIKjCcCVrrFRwJovxc1MLtfp3M4bXxH95iRYFBFJHLPiljJvT PQLGS2e9FrG9pwrdTMMqWvmGitHINmv0Ve7cAfO7fq0M+38IsxYq65uxSetQjCUgqcuk NSjaq2H1deKnmzYka9954XZam/f12zkCKc0/IVDK/5s9eSP+HlSzKhN9nSs2IjzpsLQQ AeyxOZQO8cteWLpb4GqqpLvVDbkAOq3mVd5fZhWXOKki3718AlSnWt3vC47bLUxs+tg/ ytKw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:user-agent:from:to:subject:date:message-id :mime-version; bh=y46H4rrK5lchoW+dO0kxnXM4u/K7oetnmG8JsRVffKE=; b=SKfWkWm89JnXNn1SZXo6BEPzNHBpN/H/kQnYFumzT7FP8cE+MkNMYHEmcBC6ILjOKR HXHvcfNu6UPDysiP83em67/idhYpfPAEw4WaBnHlxmTfp0mmsfMGtvZoudwPApWu7lO8 QL/8/XYl9VvbpyaJSPb1zyGi010shc904o0lt/Y9C7UCtbbbAJy5ftTH/mJs6h0Qm/oj Onmzkl8E1xo0LsaL9X6Wkz2u9jskiIQR0k/Om89GJUgLE2ECk9HjqQ2CPPp7L1MAVZe/ JEhVyzVB/nv64G9z1pioyVZnL7szXyKzjLibe+rlcaaz/efvgLmm3hMluxMnnftZTzYg lEPQ== X-Gm-Message-State: AOAM533e+LUm9VT4G7qRIXAPvfM3i8BnCEnFuoWAiE8mP9Kq6c8+yvJz oC6tLLrygY5Ptx1FYRvIdCwkNh7YhtU= X-Google-Smtp-Source: ABdhPJzKgyBAQQs0c6dnytiDFasLUf/dJgwgM8L0mNzq9e68SJ6WuOuU8YAGV0VQJBDUn+1KwvedVA== X-Received: by 2002:a63:82c6:0:b0:408:7c23:55cd with SMTP id w189-20020a6382c6000000b004087c2355cdmr4435164pgd.301.1655212038030; Tue, 14 Jun 2022 06:07:18 -0700 (PDT) Received: from dingbat (2001-44b8-31f2-bb00-7e76-99db-206c-cd57.static.ipv6.internode.on.net. [2001:44b8:31f2:bb00:7e76:99db:206c:cd57]) by smtp.gmail.com with ESMTPSA id t64-20020a628143000000b0051bbc198f3fsm7813675pfd.13.2022.06.14.06.07.16 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 14 Jun 2022 06:07:17 -0700 (PDT) User-agent: mu4e 1.7.27; emacs 28.1.50 From: Tim Cross To: orgmode Subject: More Worg build workflow Date: Tue, 14 Jun 2022 22:17:35 +1000 Message-ID: <87y1xzieb0.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::532; envelope-from=theophilusx@gmail.com; helo=mail-pg1-x532.google.com 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, T_SCC_BODY_TEXT_LINE=-0.01 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-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1655212199; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=y46H4rrK5lchoW+dO0kxnXM4u/K7oetnmG8JsRVffKE=; b=Ts5vraHND0Bvy+adDJovDDnvJOeGekXIOZUeaEndDcLf3iLmgfGY6MGPyivYD76ToT2xHJ NWKQYGL2CwpeeRJaloTM9aSv78+1XoXlPpRDa6zpRg2VdIrpQF0x0SqqwWHSqOeLvVi65X h8PFuVZFzCHtOzv34FxU2XRq2DPCpY0YADEK+OhCVSEnx2osjFSgJEuXb4dpSJns4dtMyT K7oxbw66uMQdhFhrY2HZfXh/zFaDXyvyFbtml5iwJza15V2Z5/QcRoUx458rywAIPPeEOG CaFrm137NlEC/lOl87tHm3SWn46itdX9+KiyzPOiQbNV67BP0sfITfK7kyH6WQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1655212199; a=rsa-sha256; cv=none; b=NNh6HxqBdKfoj5BZL+bfIRz9mLYZkhP7EFvJTdGegOrsRs052cQE81KVwfChP/Dj+W4K6W MbZ5ZahAePYGSSyeaMTY94k4AIHkzyKmwGOdwATf0nzGcdeHI2gKatOfakHNexaZoEaUNG jSIDMNJIkTWjaAQNE+KUKodGQaKcM+3VsWn2H1Ch0Zki8owUYgVTVeBfErx1zbRtjnRvuN c735DfiIxzOZnB8ZDhry1pRdVAOzNFcCZteegd1brJh1FbFm1H3b60GcNkHDJ4jNSogqvg 5SCqtTv+1od9Rl44KW2KJ+2/BRGEyjpBxmhkC678vv5xI7FtKhwUTOIaSfqX1Q== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=dYdroUy3; 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.99 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=dYdroUy3; 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: EB0A73C1BC X-Spam-Score: -3.99 X-Migadu-Scanner: scn1.migadu.com X-TUID: 1nzIL02d6p95 apologies if these questions about worg are becoming a little tiresome - still just trying to work out how things all work and more importantly, what level of comfort the community has with change. i As I'm digging more and more into understanding worg, I'm finding things which I think need to be changed. This is not to say what has been done is wrong, but rather that as things have developed, as technology (including org) has improved and as user expectations have changed, there are things we probably should adjust to bring worg forward and keep it current. However, it is also likely some things are the way they are for very good reasons I'm just not aware of. I'm therefore reluctant to make any significant changes without first raising it on this list. Based on only a few hours going through worg and Org mode's support for generating static web content, there are 3 very broad goals I would like to achieve 1. Improve worg's presentation layer to - Improve page responsiveness wrt different size screens - Improve accessibility support (fonts, colours, links, tags etc) - Improve page navigation. Make it easier to find specific information and easier to browse and explore the site. 2. Make it easier for users to contribute new content, updates for existing content or provide feedback 3. Improve the build and deployment workflow. - Add the ability to deploy to a dev/uat site. Reduce unexpected impact to production site and increase confidence when making changes or adding new content. - Allow anyone to easily clone the worg repository and bring up a working site locally for development, testing and experimentation etc. Today I have been going through what is required in order to deploy a copy of the worg site locally so that I have something to work with while looking at points 1 and 2. This has been slightly harder than I think it should be. Some of the issues are due to hard coded paths and URLs scattered through the source files, conflicts with my local Emacs and org settings and possibly some version issues (not sure yet). Some of these issues seem to be related to the very simple build workflow being used. The worg site is not using the org publish functionality - while it sort of does the same thing, it really is just a recursive call to org-html-export-to-html for all files with a *.org extension. While org publish does pretty much the same thing, it does have some 'sugar' which can make the process a little more flexible and provides a consistent way to apply settings consistently across the whole project. As a simple example. Each org file has an org-html-link-home settings which is https://orgmode.org/worg/. We really don't want that link hard coded in every *.org file. Would be far better if that link is added as part of the publishing process as we could then change it depending on the environment we are deploying to. Removing things like this from the individual org files also means things are easier for new contributors as they don't need to worry about adding such values. What I'm thinking and wanted feedback on is 1. Update the build process to be based on org publish by defining an org-publish-project-alist variable. 2. Moving as many 'global' and/or static settings to be managed within the org-publish-project-alist properties and removing them from each individual org file. These changes will likely also require re-arrangement of file and directory layout within the git repository to better meet the updated publishing workflow requirements. Finally, as this is likely to be a sizeable piece of work, can anyone tell me if the FSF copyright assignment process comes into play? I know this is the case with org changes, but I'm hoping it isn't with worg as I have other constraints which prevent me from signing such an agreement.