From nobody Sun Nov 14 21:11:43 2021 X-Original-To: freebsd-doc@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 65844184C016 for ; Sun, 14 Nov 2021 21:11:51 +0000 (UTC) (envelope-from rockyhotas@firemail.cc) Received: from mail.cock.li (mail.cock.li [37.120.193.124]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 4HslPf6vksz4bCK; Sun, 14 Nov 2021 21:11:50 +0000 (UTC) (envelope-from rockyhotas@firemail.cc) Date: Sun, 14 Nov 2021 22:11:43 +0100 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=firemail.cc; s=mail; t=1636924306; bh=eSg36Jp3LakqFhPyFoaP60WvRiixfZhGep3zDjF1lVg=; h=Date:From:To:Cc:Subject:Reply-To:References:In-Reply-To:From; b=pZYzSWFjBX3nEVIwCcNdBq5qeOGHFqLiVpqjnN23AK1Y5xgFaTsq/uIzx+dm4bLgX pfrGC2UAUOxY7BsdaSXRU3+KZzhHq6zNco4j/YZzwcfQIOkQKaSZvPzU8kTg3E2d2u LNcKhHJCpWL/T/ZEsZZsVUdcWTMnANJsGcZA4WkfQIlk2Feziwa69hRI6jRlFhxv8o SVo9J2q7191+ZdXgqWRZo0QmnIw4ONBiZfM9r8RaBa4EQ7rc8ypAMTQ7LM5MFxxiPx agttlGurPKMVLOQx2dyAiGf5G1YZQns542Rp4aonbP4oZay+GUblyyayJAVjW8J9+Q qsku9WZj3ERRg== From: Rocky Hotas To: Sergio Carlavilla Cc: freebsd-doc@FreeBSD.org Subject: Re: Use make to only build new files in the documentation Message-ID: <20211114211143.xxclm6t3lwo7vlq3@delpotro> Reply-To: Rocky Hotas References: <20211114183114.g6zw5zcampk2zx2s@delpotro> List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Rspamd-Queue-Id: 4HslPf6vksz4bCK X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[] X-Spam: Yes X-ThisMailContainsUnwantedMimeParts: N On nov 14 19:46, Sergio Carlavilla wrote: > > Hi Rocky, > > You have two options here. > > First option is to build the documentation only with one language. > For example, to build only the english language use: > > make run DOC_LANG="en" > > In the second option you can go to the folder of the modified document and run: > > asciidoctor _index.adoc > > Let me know if this helps you. > > PS: In my laptop, building all the documents in English took 1'5 > minutes. I'm using a Thinkpad X200. Hi! Thank you for the suggestions. Building with English only is significantly faster, I'm on an old `Intel(R) Core(TM)2 CPU' with 2 cores, but it takes about less than 3 minutes to build. This is ok! I also tried with `asciidoctor _index.adoc', but it didn't work: % asciidoctor _index.adoc asciidoctor: ERROR: _index.adoc: line 11: level 0 sections can only be used when doctype is book and this occurs if _index.adoc is related to an article (for example documentation/content/en/articles/rc-scripting) or a Handbook chapter (a subdirectory of documentation/content/en/books/handbook). However, if Hugo's internal webserver is active (after a `make run'), and I modify a _index.adoc file (and save it), it gets updated also as a webpage, so I can instantly browse the updated contents. This is great and may be another solution. Thank you! Rocky