Date: Tue, 16 Feb 2021 15:16:20 +0100 From: Daniel Ebdrup Jensen <debdrup@FreeBSD.org> To: freebsd-doc@freebsd.org Subject: Re: Regarding AsciiDoctor and long lines Message-ID: <20210216141620.k4rwqtvwfnhk7xty@nerd-thinkpad.local> In-Reply-To: <CAOa83AcBASoD=tOxx6xtAwtf5Wz7XeTm3qacBpM9dxYvX7C0LQ@mail.gmail.com> References: <c7d36625-0688-9ebb-de03-0e9b5eb55a82@freebsd.org> <20210210160348.xfy3un6bx5u7cqvj@nerd-thinkpad.local> <YCZ4TedB5G1sI8L1@emphyrio.blackend.org> <CAFwocyOYepw%2BntThzGp8ZNKQrPHm9bzgK60_fpfu1BZ5v39y9Q@mail.gmail.com> <20210212170859.lzzj5qrriovjd2ux@nerd-thinkpad.local> <CAFwocyOdSqnVUcRgUhiecXvG2qGasnL2VU0JugwEVc-WuvJxOg@mail.gmail.com> <CAFwocyOBLW0Siwtk0A%2BQox_MQt4KqCnMvHa_1s23RmjqqmLUkw@mail.gmail.com> <YCq31UMUj8DH2En3@emphyrio.blackend.org> <20210216074810.qwaotlonqdaulvk2@nerd-thinkpad.local> <CAOa83AcBASoD=tOxx6xtAwtf5Wz7XeTm3qacBpM9dxYvX7C0LQ@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--rsdh7ahyvm7qxe5e Content-Type: text/plain; charset=iso-8859-1; format=flowed Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Feb 16, 2021 at 01:01:45PM +0000, Ceri Davies wrote: >On Tue, 16 Feb 2021 at 07:48, Daniel Ebdrup Jensen <debdrup@freebsd.org> >wrote: > >> On Mon, Feb 15, 2021 at 07:05:09PM +0100, Marc Fonvieille wrote: >> >Le 12.02.2021 18:24, Sergio Carlavilla a =E9crit : >> >> >> >> I think the doceng team should pronounce about this. >> >> >> >> IMHO, use the 72 characters per line would be a problem in the future. >> >> >> > >> >Why it would be a problem? >> > >> >-- >> >Marc >> >> Hi folks, >> >> Can we make a compromise where real paragraphs, ie. the only things >> which don't seem to need much in the way of AsciiDoctor markup, are kept >> at 72 columns, and headings, lists, images, include macros, variables >> and custom macros are allowed to go beyond the 72 columns? >> If they have to, there's always word-smithing options for trying to be >> as concise as possible (without, of course, making things too obtuse - >> it's a tough balance, admittedly? >> >> That seemed to work for DocBook, so is there a reason it won't work >> here? >> > > For HTML output it doesn't look like it's an issue; although whitespace >is preserved in the output, it's luckily irrelevant to HTML output. > >For other output formats such as PDF or mdoc then I can see that it is >problematic to hard wrap text but that suggests that there's a tooling >issue; Marc's need to be able to actually see what has changed is really >important. > >Butting out for another 9 years now :D > >Ceri I don't see how mdoc would be impacted, since that lives in the src=20 repo. As for pdf files, I couldn't tell you the last time I used the handbook=20 in a pdf format, so I had to generate it by grabbing asciidoctor-pdf=20 and running it on doc/documentation/content/en/books/handbook/book.adoc -= =20 and it produced [1]. Aside from things which I think can be addressed separately, the change=20 I made in order to test the theories that pdf should work with extra=20 linebreaks inserted at 72 columns, is on page 21, on the paragraph=20 "The hardware requirements to install FreeBSD vary by.." To me, this looks exactly like how I would expect it to look. So I think we'll be fine with this change, at least for newlines as it=20 relates to paragraphs. Yours, Daniel Ebdrup Jensen [1]: https://people.freebsd.org/~debdrup/book.pdf --rsdh7ahyvm7qxe5e Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQGTBAABCgB9FiEEDonNJPbg/JLIMoS6Ps5hSHzN87oFAmAr07RfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDBF ODlDRDI0RjZFMEZDOTJDODMyODRCQTNFQ0U2MTQ4N0NDREYzQkEACgkQPs5hSHzN 87oLfAf8CIjU2yDRT9Cck/ShiTpobO2RvDPri9ZzTjq7JfoFUQLCEdf/9q8JxtLI 8gT6zY9EpSOCWlfFhO5I1zDE0Y8dDcnwrq/+qTbK+ah2Pw3AI+E7TZ5Tv8RAKgpg HEzIg8PSn7pAGpw4l3AoLSW3Hzs7YY7uOsf14vSDHX9D+qHbkC5cW4k53shcWwsd FkBdEgUqTAQtIWF9ftN8f8H8qFiOYOAa4BOgr4yUzGLhNoVgyw7Jo5lZHIxnt0f6 NE1jpiwLj3EsxXKyoMCqAcNz0ptZUBrJp0g35FE19Jxtr3AlBZ1SioSFGU01sPbr NkRze/R9MfMdS13AXO2PGLsxAi7gXA== =21Kj -----END PGP SIGNATURE----- --rsdh7ahyvm7qxe5e--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20210216141620.k4rwqtvwfnhk7xty>