doc/documentation/content/es/books/faq, branch main FreeBSD documentation tree New Documentation Portal 2021-12-11T09:57:33+00:00 Sergio Carlavilla Delgado carlavilla@FreeBSD.org 2021-12-11T09:57:33+00:00 2b027dd0175e739f8b5fedd2ae6bd96cf0c14125 I'm very pleased to announce the release of our new Documentation Portal. Key features: * Responsive * Modern design * Theme support: Light, Dark, High contrast * Removed Python dependency Acknowledgment: * Alexander Leidinger <netchild (at) FreeBSD.org> * Baptiste Daroussin <bapt (at) FreeBSD.org> * Benedict Reuschling <bcr (at) freebsd.org> * Daniel Ebdrup Jensen <debdrup (at) FreeBSD.org> * Danilo G. Baio <dbaio (at) FreeBSD.org> * Dave Cottlehuber <dch (at) FreeBSD.org> * Ed Maste <emaste (at) FreeBSD.org> * Fernando Apesteguía <fernape (at) FreeBSD.org> * Pedro Giffuni <pfg (at) FreeBSD.org> * Joseph Mingrone <jrm (at) ftfl.ca> * Rocky Hotas <rockyhotas (at) firemail.cc> * Pau Amma <pauamma (at) gundo.com> * The FreeBSD Foundation Approved by: core, doceng 
I'm very pleased to announce the release of
our new Documentation Portal.

Key features:
* Responsive
* Modern design
* Theme support: Light, Dark, High contrast
* Removed Python dependency

Acknowledgment:

* Alexander Leidinger <netchild (at) FreeBSD.org>
* Baptiste Daroussin <bapt (at) FreeBSD.org>
* Benedict Reuschling <bcr (at) freebsd.org>
* Daniel Ebdrup Jensen <debdrup (at) FreeBSD.org>
* Danilo G. Baio <dbaio (at) FreeBSD.org>
* Dave Cottlehuber <dch (at) FreeBSD.org>
* Ed Maste <emaste (at) FreeBSD.org>
* Fernando Apesteguía <fernape (at) FreeBSD.org>
* Pedro Giffuni <pfg (at) FreeBSD.org>
* Joseph Mingrone <jrm (at) ftfl.ca>
* Rocky Hotas <rockyhotas (at) firemail.cc>
* Pau Amma <pauamma (at) gundo.com>
* The FreeBSD Foundation

Approved by: core, doceng
Build offline documentation using Hugo and other improvements 2021-11-03T16:44:52+00:00 Sergio Carlavilla Delgado carlavilla@FreeBSD.org 2021-11-03T16:39:08+00:00 64acd169b82416fe39ad8c4b1be106680d4a3eb3 * Allow to build the documentation offline using Hugo * Fix link problems * Remove SVN entities * Fix lang problems to help weblate * Move all the AsciiDoctor translations to the shared folder to help weblate * Allow the possibility to build each document. For example each document can be edited in and watched the result in real time in VS Code or Vim/NeoVim. Breaking changes: Eliminate the possibility of building books or articles. They must be builded at the same time. This functionality will be restored when version 0.89.0 is in the repositories in a couple of weeks. Reviewed by: dbaio@ Differential Revision: https://reviews.freebsd.org/D31926 
* Allow to build the documentation offline using Hugo
* Fix link problems
* Remove SVN entities
* Fix lang problems to help weblate
* Move all the AsciiDoctor translations to the shared folder to
  help weblate
* Allow the possibility to build each document. For example each
document can be edited in and watched the result in real time in
VS Code or Vim/NeoVim.

Breaking changes:

Eliminate the possibility of building books or articles.
They must be builded at the same time.
This functionality will be restored when version 0.89.0 is in the
repositories in a couple of weeks.

Reviewed by:            dbaio@
Differential Revision:  https://reviews.freebsd.org/D31926
Revert "Add Hugo's lang shortcode" 2021-06-19T21:30:16+00:00 Danilo G. Baio dbaio@FreeBSD.org 2021-06-19T21:30:16+00:00 8e22e76d94dc5fef83abcb3c082ab4242ef90ba2 This reverts commit 3462d12db6ebf303064db168a2333374344f369a. Too soon, it broke asciidoctor-pdf which doesn't know Hugo's shortcode. It will take more time and care. 
This reverts commit 3462d12db6ebf303064db168a2333374344f369a.

Too soon, it broke asciidoctor-pdf which doesn't know Hugo's shortcode.
It will take more time and care.
Add Hugo's lang shortcode 2021-06-19T19:09:00+00:00 Danilo G. Baio dbaio@FreeBSD.org 2021-06-19T18:56:16+00:00 3462d12db6ebf303064db168a2333374344f369a This is a prerequisite for the translation workflow through .po files and Weblate. The asciidoctor include with the shortcode variable will help because won't be needed to change the includes manually after converting the translation (.po file) back to .adoc. It will help other areas like, language attributes, which today is fixed in every document. The use of shortcode was suggested by jmooring@ from Hugo's project on Github. Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D30823 
This is a prerequisite for the translation workflow through .po files
and Weblate.

The asciidoctor include with the shortcode variable will help because
won't be needed to change the includes manually after converting the
translation (.po file) back to .adoc.

It will help other areas like, language attributes, which today is fixed
in every document.

The use of shortcode was suggested by jmooring@ from Hugo's project on
Github.

Reviewed by:	carlavilla
Differential Revision: https://reviews.freebsd.org/D30823
Use correct syntax markup for shell 2021-03-14T12:08:55+00:00 Li-Wen Hsu lwhsu@FreeBSD.org 2021-03-14T12:08:55+00:00 a9a9e661059557e5bb6ab3e756e007b8e5d231ce Approved by: carlavilla 
Approved by:	carlavilla
Migrate doc to Hugo/AsciiDoctor 2021-01-25T23:31:29+00:00 Sergio Carlavilla Delgado carlavilla@FreeBSD.org 2021-01-25T23:31:29+00:00 989d921f5d4ac8d8b7c831c13b8954ad1901be24 I'm very pleased to announce the release of our new website and documentation using the new toolchain with Hugo and AsciiDoctor. To get more information about the new toolchain please read the FreeBSD Documentation Project Primer[1], Hugo docs[2] and AsciiDoctor docs[3]. Acknowledgment: Benedict Reuschling <bcr@> Glen Barber <gjb@> Hiroki Sato <hrs@> Li-Wen Hsu <lwhsu@> Sean Chittenden <seanc@> The FreeBSD Foundation [1] https://docs.FreeBSD.org/en/books/fdp-primer/ [2] https://gohugo.io/documentation/ [3] https://docs.asciidoctor.org/home/ Approved by: doceng, core 
I'm very pleased to announce the release of
our new website and documentation using
the new toolchain with Hugo and AsciiDoctor.

To get more information about the new toolchain
please read the FreeBSD Documentation Project Primer[1],
Hugo docs[2] and AsciiDoctor docs[3].

Acknowledgment:
Benedict Reuschling <bcr@>
Glen Barber <gjb@>
Hiroki Sato <hrs@>
Li-Wen Hsu <lwhsu@>
Sean Chittenden <seanc@>
The FreeBSD Foundation

[1] https://docs.FreeBSD.org/en/books/fdp-primer/
[2] https://gohugo.io/documentation/
[3] https://docs.asciidoctor.org/home/

Approved by:    doceng, core