From nobody Sun Nov 14 21:14:38 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 E85BE184D792 for ; Sun, 14 Nov 2021 21:14:56 +0000 (UTC) (envelope-from jdpc86.li@gmail.com) Received: from mail-oi1-x22c.google.com (mail-oi1-x22c.google.com [IPv6:2607:f8b0:4864:20::22c]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1D4" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4HslTC3hDHz4cfZ; Sun, 14 Nov 2021 21:14:55 +0000 (UTC) (envelope-from jdpc86.li@gmail.com) Received: by mail-oi1-x22c.google.com with SMTP id n66so30516810oia.9; Sun, 14 Nov 2021 13:14:55 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=0Sr4+S9jL66Zx/OpZQ2yAZd5wLSvsjNKAuJl5iUunsk=; b=Kp+YufIxSXvRlkpfRW0vvdbHxNkKCgUkyKZZ7M2P1cCBJalFInaiyBo6g7tYjqAryY HwVrt7+og92jVm+iLHTMyk5VgSXRfmQw1Q6cU9VbdXGSQHnn+tx2Dy5ku2cCs9gQetME Ie8vbCj+HNpRvBW/bNSae7yvYgZS0e95kEvCRdIsxEKq9dj1hWOvmT49pgFtbqoxRsUa 2dJ8aeUWWm/W/4vtRBEuXQXyRyd8BFk3afz8xOnSpSG+aTOl6uQb2ZBikjSEaMxpv4vb WUDEp7fjguz3U8OQwV6BDFBZ7+raO+WN7cA3FUe/W8z9TfynP05CCIOQG+ivyyJVz4L1 Kfjw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=0Sr4+S9jL66Zx/OpZQ2yAZd5wLSvsjNKAuJl5iUunsk=; b=2qq19cuCBBQWrY0ydi+rubAKbabPRd1Pz9Sb8Jy0RBF3JLTjsKQsYrJkLlPYxFUKTj m5qX+bscN1go5eV6gjpkqVwFNG0sBGsSlyO+uTVmNimlJ3H5PSwrCO4b8jiQ6yKahMoL uRrfSS6KGNNCk9xFmLyN2XwKpSPQlHIzCZU4qvUaAWJd8CNl7EqZYBxgtmeDuwXCZ+aZ GsR2W2qyCDiSCMXJ9cQd5qRTKR5B+xb0exYpy7b80u9ajo5ZT2jlP6inalCxCNxPzMk2 klS5g+NPrHzwQ/eO/73t1wmFe6of7Ceb3gfP0WPpt+w26JQ6qLo0aFi19DdKSd2bu2HH uz5Q== X-Gm-Message-State: AOAM5321DBYsy6yg9BXR35zidUiG9Bxs8cXu3tJyPVIA3KdL2BrGnoZN f5w5f3cADb89wr0MvQ3LAk1tchUCBngRShMCWNpOeJ4v X-Google-Smtp-Source: ABdhPJw6CR4GYtYsxawBwtvkOUy5BmPJ0GDXVybiRN3oxiqKZwqxNSP1gxzn5o6mztN471fYAspz1Z1ShtG0o1+XDZ0= X-Received: by 2002:a05:6808:1246:: with SMTP id o6mr27293937oiv.136.1636924488875; Sun, 14 Nov 2021 13:14:48 -0800 (PST) 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 References: <20211114183114.g6zw5zcampk2zx2s@delpotro> <20211114211143.xxclm6t3lwo7vlq3@delpotro> In-Reply-To: <20211114211143.xxclm6t3lwo7vlq3@delpotro> From: Jindong Li Date: Sun, 14 Nov 2021 16:14:38 -0500 Message-ID: Subject: Re: Use make to only build new files in the documentation To: Rocky Hotas Cc: Sergio Carlavilla , freebsd-doc@freebsd.org Content-Type: multipart/alternative; boundary="000000000000af020705d0c62eec" X-Rspamd-Queue-Id: 4HslTC3hDHz4cfZ X-Spamd-Bar: --- Authentication-Results: mx1.freebsd.org; dkim=pass header.d=gmail.com header.s=20210112 header.b=Kp+YufIx; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (mx1.freebsd.org: domain of jdpc86li@gmail.com designates 2607:f8b0:4864:20::22c as permitted sender) smtp.mailfrom=jdpc86li@gmail.com X-Spamd-Result: default: False [-3.97 / 15.00]; ARC_NA(0.00)[]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; R_DKIM_ALLOW(-0.20)[gmail.com:s=20210112]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[3]; R_SPF_ALLOW(-0.20)[+ip6:2607:f8b0:4000::/36:c]; FREEMAIL_FROM(0.00)[gmail.com]; MIME_GOOD(-0.10)[multipart/alternative,text/plain]; DWL_DNSWL_NONE(0.00)[gmail.com:dkim]; NEURAL_HAM_LONG(-1.00)[-1.000]; TO_DN_SOME(0.00)[]; TO_MATCH_ENVRCPT_SOME(0.00)[]; MID_RHS_MATCH_FROMTLD(0.00)[]; DKIM_TRACE(0.00)[gmail.com:+]; DMARC_POLICY_ALLOW(-0.50)[gmail.com,none]; RCVD_IN_DNSWL_NONE(0.00)[2607:f8b0:4864:20::22c:from]; NEURAL_HAM_SHORT(-0.97)[-0.970]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+,1:+,2:~]; FREEMAIL_ENVFROM(0.00)[gmail.com]; ASN(0.00)[asn:15169, ipnet:2607:f8b0::/32, country:US]; TAGGED_FROM(0.00)[]; RCVD_TLS_ALL(0.00)[]; RCVD_COUNT_TWO(0.00)[2] X-ThisMailContainsUnwantedMimeParts: Y --000000000000af020705d0c62eec Content-Type: text/plain; charset="UTF-8" hmm guys i'm kind of new to this, if I was going to apply this change (since it appears already committed?), what would I need to do? :) On Sun, Nov 14, 2021 at 4:12 PM Rocky Hotas wrote: > 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 > > --000000000000af020705d0c62eec--