From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id wB4HC5VNRmMkZAEAbAwnHQ (envelope-from ) for ; Wed, 12 Oct 2022 07:16:05 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id IIo3CpVNRmMvAQAAG6o9tA (envelope-from ) for ; Wed, 12 Oct 2022 07:16:05 +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 B47143D489 for ; Wed, 12 Oct 2022 07:16:04 +0200 (CEST) Received: from localhost ([::1]:56304 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oiU67-0002yI-JE for larch@yhetil.org; Wed, 12 Oct 2022 01:16:03 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:39134) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oiU4n-0002y8-1W for emacs-orgmode@gnu.org; Wed, 12 Oct 2022 01:14:41 -0400 Received: from ciao.gmane.io ([116.202.254.214]:58064) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oiU4l-0000Nl-F4 for emacs-orgmode@gnu.org; Wed, 12 Oct 2022 01:14:40 -0400 Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1oiU4j-0002Gr-KF for emacs-orgmode@gnu.org; Wed, 12 Oct 2022 07:14:37 +0200 X-Injected-Via-Gmane: http://gmane.org/ To: emacs-orgmode@gnu.org From: Max Nikulin Subject: Re: Some links in online manual do not work Date: Wed, 12 Oct 2022 12:14:23 +0700 Message-ID: References: <87r0zqknbd.fsf@vagabond.tim-landscheidt.de> <86fsg6szf6.fsf@gmail.com> <87mtaakvpt.fsf@vagabond.tim-landscheidt.de> <87mta960wp.fsf@localhost> <877d1bzm15.fsf@gnu.org> <87mta7fm5l.fsf@vagabond.tim-landscheidt.de> <6559964f-1d94-913a-04b4-a911fa30ae38@gmail.com> <875ygqc44k.fsf@gnu.org> <2b352b13-ddd9-ae79-6fe5-c3ea6b75f129@gmail.com> <87mta2pzcc.fsf@gnu.org> <596ec649-deb5-a0e0-97af-c25e4a90cc9b@gmail.com> <87mta2g20x.fsf@gnu.org> <871qrei938.fsf@gnu.org> <87a661he9o.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.2.2 Content-Language: en-US In-Reply-To: <87a661he9o.fsf@gnu.org> Received-SPF: pass client-ip=116.202.254.214; envelope-from=geo-emacs-orgmode@m.gmane-mx.org; helo=ciao.gmane.io X-Spam_score_int: 0 X-Spam_score: -0.1 X-Spam_bar: / X-Spam_report: (-0.1 / 5.0 requ) BAYES_00=-1.9, DKIM_ADSP_CUSTOM_MED=0.001, FORGED_GMAIL_RCVD=1, FORGED_MUA_MOZILLA=2.309, FREEMAIL_FORGED_FROMDOMAIN=0.25, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25, NICE_REPLY_A=-2.934, NML_ADSP_CUSTOM_MED=0.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no 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=1665551764; 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: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=qnwe2vcuxg4vu3iH0g7ZUiXooIxyPXfr/AUw+yWmKRI=; b=SiR7TPi2/LvI9SX5RNvF0O8mi6AL6u82KR6bOtiwWFRSroVmNhNwb1w1MZOiCkkj4VWNQj 2gzjxGkUeXXUjEP0tk3dF1SZypKhBQRSNOQnV8l6VbaoCqY91YyVnxdIOYyZv/93LIO1JN 1uW7eXvXOHYRtvdKex2xK++z3W+lb51qXvKf8DB1XVSU9kK/mO2Vozd6AsmGa3FKoM3Q1D aMwDYfsjHCiBThzOiOqBlh3iZASDL7EzVJLuU8RfBHMCh7oBS6wzr+jqIMpLcxxaTYSQpn OBF0GqYTRkiEC9YX807xqQMTYju3a8TVWKXPVOyCFe/yB8gzcstyn4rxI5eNPg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1665551764; a=rsa-sha256; cv=none; b=o4FyJSyOkQKM3/uTBzlz4MZnzCovaFUOofAOVL6qWoV7Ocsmb860HtKA2gHn+yR/TT91ka Fz2IRFiuko8EjepZwxzSobZ4BPJnosY/rvzr4noGIaxlYc8t4k2RA1C21GD6A46nvoEM2g NNQ/f0zFc4ttbX1JDBtgA+5Gb2IE2RO1g1FhqGHdfZm4KB5hoNcrBosWyWPlT7nglsqyri zeNHA3n+WHEXPDIFOpk8Djymaehvt56ylon9fbgwJ59pqrIC+GFNo6tmCL3shcm8uYEWoz myZpvdZAVf1J4+41V1gPOB69EAHr+ljHBuie9YW1vFQKiGb5I/YxfnxMLa0NMA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=fail reason="SPF not aligned (relaxed), No valid DKIM" header.from=gmail.com (policy=none); 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: 2.00 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=fail reason="SPF not aligned (relaxed), No valid DKIM" header.from=gmail.com (policy=none); 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: B47143D489 X-Spam-Score: 2.00 X-Migadu-Scanner: scn0.migadu.com X-TUID: IY/5IAAAZIU3 On 12/10/2022 11:11, Bastien Guerry wrote: > Max Nikulin writes: > >> If redirection directives were included as separate files then it >> would be possible to just check them by a command like >> >> awk '{ if ($NF >= 3) print $3; }' /tmp/manual.txt | >> xargs --replace -- \ >> curl --head --write-out '%{http_code} %{url_effective}\n' \ >> --silent --show-error --output /dev/null \ >> 'https://orgmode.org/manual/{}' > > https://git.sr.ht/~bzg/worg/tree/master/item/nginx.conf contains the > list of redirections -- the checks could be done from here, right? It is not hard to copy text from nginx.conf to separate text files. Implementing nginx parser to filter only manual or just guide rules is more tricky. My opinion, the following structure is even more convenient to maintain: nginx.conf: # ... rewrite ^/list(.*) https://list.orgmode.org$1 permanent; location /manual { include manual-rewrite.inc; } location /guide { include guide-rewrite.inc; } } # ... manual-rewrite.inc: rewrite /Add_002don-packages\.html Add_002don-Packages.html permanent; rewrite /Adding-export-back_002dends\.html Adding-Export-Back_002dends.html permanent; rewrite /Adding-hyperlink-Types\.html Adding-Hyperlink-Types.html permanent; # ... I suggested it assuming tracking of changes in the manual. If you are against it then this list is almost static and regular check is less important. However it might catch removing of a section that is a redirection target. >> Original proposal to add redirections contained an s-expression with >> mappings. I would consider tracking it in the main Org repository. I >> believe, list of info nodes in the released manual should be added to >> it as known names. > > I'm not sure I understand. Nothing should be added to the main Org > repository to fix a problem with the orgmode.org website, even if it > is a problem with the HTML manual as produced from org-mode.git. I do not insist. The idea was to put a file that is tightly bound to contents and edit history of manual close to the source of the docs since a script that can detect necessary changes requires list of HTML files generated from org-manual.org. > But more complex rewrite rules (from old manual nodes to new ones) is > IMHO calling for trouble. What if we split the "Properties and Column" > manual page into "Properties" and "Columns"? Where to redirect? From my point of view, any variant is better than 404. Alternatively redirection target may be an anchor to any of the new items in the table of contents. Thank you for restoring rewrite rules. After earlier Tim's messages I was quite pessimistic believing that such attempt of improvement was buried.