Received-SPF: pass (google.com: domain of linux-kernel+bounces-1149-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:40f1:3f00::1 as permitted sender) client-ip=2604:1380:40f1:3f00::1;
Message-ID: <db501d4f-f922-4a78-8496-858ac528df9e@oracle.com>
Date: Fri, 15 Dec 2023 16:04:12 +0100
User-Agent: Mozilla Thunderbird
Subject: Re: [PATCH v2] docs: translations: add translations links when they
 exist
Content-Language: en-US
To: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org, Carlos Bilbao <carlos.bilbao@amd.com>,
        Alex Shi <alexs@kernel.org>, Hu Haowen <src.res.211@gmail.com>,
        linux-kernel@vger.kernel.org, Federico Vaga <federico.vaga@vaga.pv.it>,
        Jani Nikula <jani.nikula@linux.intel.com>,
        Akira Yokosawa
 <akiyks@gmail.com>, Yanteng Si <siyanteng@loongson.cn>
References: <20231215123701.2712807-1-vegard.nossum@oracle.com>
From: Vegard Nossum <vegard.nossum@oracle.com>
Autocrypt: addr=vegard.nossum@oracle.com; keydata=
 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 8A==
In-Reply-To: <20231215123701.2712807-1-vegard.nossum@oracle.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: 
	=?utf-8?B?UjBVRkFiY21xamUxWWVKdVorM0taUUV4eDZXZUhqNU02STdKZEVHMEtVYlVI?=
 =?utf-8?B?MG1EcHM5MVhVdUlxZlppNkpGbW9JdnRaQ2Vwbi8vWHdOdmtzSUV6dVNVVDAy?=
 =?utf-8?B?TDJJaVpJTzlmemJ0ZGtFMllEaXRqOEhqRVU4d3VJeEFadnVXbDdOeXNqUmJn?=
 =?utf-8?B?ZlZkSzFYUy9BalB4a0FKbm9pZm9EODhHYlhNT3RoLy9Cam1GQVhqT3k1NjE0?=
 =?utf-8?B?cStabnZSeDY1RUpqdTBsZTE5RkM5QnRGeFlmOGZTU0dmNTkzdXA4c3VZdldr?=
 =?utf-8?B?bkRJTVg3V1BFT1FyamMyZmZjYW5WejlJTmtUNWVDcnBsc3BpY2YyWWhEZmxE?=
 =?utf-8?B?Rzc0SmFycElPS3Y2SGtGUnovdzRjbDZ2UVo1LzFBRFk5TXd5cUZFUWNIem5w?=
 =?utf-8?B?N1FTUDQ3K25EUVBhODI2RTgzQVoremNYRyt1cnVQd3V3dXp3cUVUbHFEdVMz?=
 =?utf-8?B?SllJc2pYaHJPbDJzRUNtWDRudWNyM2tWSWpPdTVOb2hNQWlMUGMwQ2d4WkI1?=
 =?utf-8?B?VnQ0WVJIOVlXMEdZTkpUd3lmSjJuU2ZKTk14S0VaaDZhb0xqTldKVm0zdW5u?=
 =?utf-8?B?amtQbmRveVpDUktzb2NnaklTUlhGUVU4OWtnd1YrOEtobmR3VC9ic1hPcGFp?=
 =?utf-8?B?MllWbkVsdmNWL3pOd3htVGlMVVhuR0Z1OXJiSVBpdUlJTGdMNGJ2b3M3Z2or?=
 =?utf-8?B?YmZzNGR4ZzlFYkxicWx2S256alJ5UHN6NTM2L3o5S0Y3RlN6aDl5cUdXakJy?=
 =?utf-8?B?NUNyaVpGcUNlZDNTS0x2bTJUdEF5MDBSUVhIMU5SaW92aGY3YllKcXlyVElI?=
 =?utf-8?B?SUc3OVVQdDI3VDEwd3RpWlNjTlhaL0pwaHlxTFV5cEZvQk1pQW5taUorZHBU?=
 =?utf-8?B?M2pXYktHRGlRczl0SHF4SW05SDlwOGFWT1JrNlM0M21sSkJ5Vm91b1k0TmlH?=
 =?utf-8?B?aW5NMTRGS1VmY0t0dnZ5SUNoZ3A5aCsyZGhta2cwd3JHNmtCM1dIbzZ4UUhW?=
 =?utf-8?B?eUhFeFpQSmtXVUkrc01xcVpaQ0RzYktiTTBpN2Y4b2lpT1VqbENjOFZJaEhm?=
 =?utf-8?B?b2RDRnJMOWJ2OUUzM3hla2VJVGU2S2FlSHArOFNZb200WHZVUlBUSnVpNHhG?=
 =?utf-8?B?OGJqU0ttOUIyS1hCQ3RUQVpsbE9FZlNvWUoyTGcwN2k4UDVzcGZ6YzMwWnI4?=
 =?utf-8?B?emdCY3JzdHRjbWtHS2ZpWGZhTDJxVGZ3elUvV1pDRzJXSTMwUFlKRmhwWmNW?=
 =?utf-8?B?VDNqRmJTWEVNeVNJS0ZsdWxlbkh3Y3dVNVlQc2Z1TjhhQ2k0UTFaaGpSK0Jr?=
 =?utf-8?B?eEErREVPcExNeUlOOU40N2NzK2pZWDFPWXl2d0k0bmNiQW0xcjFFOEs0MVM3?=
 =?utf-8?B?c3E1T2VzZ3BwVjRESmN0S011ZWR6M0U1M1FPT2toVC9hcmprOGFwRGZCOUp5?=
 =?utf-8?B?QjdkRjJKUHV3OTZiZWNsWGJPVzBiOVBJSG1xTGFDNzRzMjZlTVJFcmdCVXRB?=
 =?utf-8?B?NFpTRjZSMFBCL1FuS1ozdENjWjdxVEZZNndrcmQxZ2IvelE3bk1Gd2hWV0NZ?=
 =?utf-8?B?L2YyNmJ1TFdzR0NaY2gzMmkyKzFxQldaQWZCaExiYy9XUkRrY1ZkVnMwWXVt?=
 =?utf-8?B?WjdVaXZQUXViMnlHL05JWEhrdmxGc3FCaHYwRkFUb3R5S0JPczRLNHFWaU5X?=
 =?utf-8?B?SGdLMXJBWUhMTHIxdmdpVTBqS0FENjdXaEt6cld6SEt6MzVCOUcycHhLUHdG?=
 =?utf-8?B?Ylc1NDJXelpUOUpnbjdIL0hWQ3N5S0MrWjcwaUo2aVdyNzRqTE1YTGNUdVlX?=
 =?utf-8?B?Q3JXQlhkNjNxVWxJRU5pQi80Zmg4SzNtZzJ4T0tZb245OWhMWUNoN1V5c1RG?=
 =?utf-8?B?ZjlYcTlLZEx6YVY0Yk5LbmVrR0sxVnQvWCswZUU3Zm1mY2VielpQNVh0SXhl?=
 =?utf-8?B?SkxoVkpuc2dMb0tKaThOb2xFbkN4dXN2K0d2c1ZYU0xNWFJqT0tOMEJ3SWFG?=
 =?utf-8?B?ejluR1FXT1Zvei9NL3ZXUDhZR1U3QVhVTFdVV0xYZHk1QUsxSWtsZGcwejV2?=
 =?utf-8?B?ZFFpakpPejB6NDMrYVEwalNwTmk3RXBmcnlXQWQ2VkVkV1FUREVxVWZrdS9X?=
 =?utf-8?B?Q2hLa0NLdGh5UWNFTUd5SjArT1hYcDZ5TTJZN0t3Sy8rdnFhb1h4TFpwUi9y?=
 =?utf-8?B?RXc9PQ==?=
X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: 
	aOqGViWqKJ9GVADLh1ZUfnoURRNYFlMJ4cBwKM+D7cL/r3Oy0/FIMJgmuutuhNI0A60xeS/eX/hqxtRkrQKWECNQzBJLFQnZdk58KrFvFFLttnp6lytGTV7UAWM3XXZTG+UlMtrjMCjaE5b7/rtXRPQl5wYlLuh5nICOiAee0GlLx0+HzZDC6I4IHR+322PPNd+g9jOd0oSw2gPn7k38XT4/wSk5/y09YxV5PBlcls1JHIBn0AlyDaL9tnm/hLWz0TxOMczUMQ9Y8uqjlVuCrkf0/BSn1BpwhF0m54uMqekPyBuOa6T5CFk8N0ms41EdKl1zlqMjIaVasvao76izXDCaW08Wxn3WiXCBfWb1fqHZnOcTQr8SgGIESCw4yX6THEVjtzopE+dGHNZLnufF5jM1pG0M1A5/c1r63lR3JM/JX8/Dc4en9OeKPpOGipgkt4SZgJ9cu00AI6eWnv7uUnsU4r89lp70J3kHUXL62KqSBLCovSycO6JgAgtMtw65fUsChPIkumJuEt5OLGRABcHNGnWd9N7PSXLawTA/5Vs1zLFoqAE6SF5FL/8ug60+1zGFK0WvpvVL5X2ja3VgdnHKJZlhAnveiu3s7PDE+pM=
X-OriginatorOrg: oracle.com
X-MS-Exchange-CrossTenant-Network-Message-Id: b5c1a27c-1bb3-4cdf-c059-08dbfd7f1bc5
X-MS-Exchange-CrossTenant-AuthSource: PH0PR10MB5433.namprd10.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 15 Dec 2023 15:04:17.4519
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: J+Xw/pPjsjaSXpjAAXRwqKhaQcwC85WCtu8XZCSwwNNPeab+fFzcmxkTCrDcKsdBKJ2Mpz6/Nyglde44goqV6qEvvhNcGrcuiSq/h0rxvYo=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA1PR10MB5760
X-Proofpoint-Virus-Version: vendor=baseguard
 engine=ICAP:2.0.272,Aquarius:18.0.997,Hydra:6.0.619,FMLib:17.11.176.26
 definitions=2023-12-15_09,2023-12-14_01,2023-05-22_02
X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 malwarescore=0
 mlxlogscore=999 adultscore=0 phishscore=0 suspectscore=0 mlxscore=0
 spamscore=0 classifier=spam adjust=0 reason=mlx scancount=1
 engine=8.12.0-2311290000 definitions=main-2312150103
X-Proofpoint-GUID: _nW-pg_Kw-vZvXg35fBQvsWDH0-6CYpj
X-Proofpoint-ORIG-GUID: _nW-pg_Kw-vZvXg35fBQvsWDH0-6CYpj


On 15/12/2023 13:37, Vegard Nossum wrote:
> Add a new Sphinx extension that knows about the translations of kernel
> documentation and can insert links to the translations at the top of
> the document.
> 
> It basically works like this:
> 
> 1. Register a new node type, LanguagesNode.
> 
> 2. Register a new transform, TranslationsTransform, that inserts a new
>     LanguageNode at the top of every document. The LanguageNode contains
>     "pending references" to translations of the document. The key here
>     is that these are pending (i.e. unresolved) references that may or
>     may not actually exist.
> 
> 3. Register a 'doctree-resolved' event that iterates over all the
>     LanguageNode nodes. Any unresolved references are filtered out; the
>     list of resolved references is passed to the 'translations.html'
>     template and rendered as an HTML node (if HTML output is selected).
> 
> Testing: make htmldocs, make latexdocs with Sphinx v4.3.2 and Firefox.

Oh no, there's still a problem. If I run make htmldocs, make latexdocs,
make htmldocs, then all the translation menus disappear from the HTML.

So ignore this for now.

If anybody has a solution feel free to respond with it.


Vegard