aboutsummaryrefslogtreecommitdiff
path: root/documentation/config
Commit message (Collapse)AuthorAgeFilesLines
* doc/config/offline: Allow git commandDanilo G. Baio2024-09-071-1/+1
| | | | Following 826d39cdc4921ba5fce1780cfeeb116da0f0f556
* Allow git commandFernando Apesteguía2024-08-191-1/+1
| | | | | | | Use the default configuration as show in the Hugo site: https://gohugo.io/about/security/#security-policy Necessary for the upcoming update to hugo 0.133.0
* offline/config.toml: Remove unknown output configurations `list` andMarc Fonvieille2024-02-171-2/+0
| | | | `single`
* Remove warnings in configuration filesMinsoo Choo2024-01-221-3/+1
| | | | | | | | | | | | | | | | | From Hugo doc: > With v0.109.0 and earlier the basename of the site configuration file was config instead of hugo. You can use either, but should transition to the new naming convention when practical. Therefore `config.toml` is moved to `hugo.toml`. > The taxonomyTerm page kind was effectively aliased to the taxonomy page kind in v0.73.0 (https://github.com/bep/hugo/commit/114d4012a89ca88583de5979a6ec4a4799c739b7) `list` and `single` are unknown configurations. Remove them. Differential Revision: https://reviews.freebsd.org/D43406
* doc: Increase Hugo timeoutDanilo G. Baio2024-01-172-2/+2
| | | | | We are receiving several reports of pkg-fallouts with the error message "... timed out after 1m0s."
* Hugo config: Set timeout for 60sLi-Wen Hsu2024-01-102-2/+2
| | | | | | | | | | | In 93f1bbf374afa5b350b2a8423c8b512bec76486b we wanted to double the default timeout, set it explicitly. Ref: * https://gohugo.io/getting-started/configuration/#timeout * https://pkg.go.dev/time#Duration Sponsored by: The FreeBSD Foundation
* Documentation Portal: Move GitHub url from edit to blobSergio Carlavilla Delgado2023-08-301-1/+1
| | | | | Approved by: fernape@, dbaio@ by email Differential Revision: https://reviews.freebsd.org/D41601
* doc: Increase Hugo timeout for default buildsDanilo G. Baio2023-04-251-1/+1
| | | | | | Some developers and contributors have reported experiencing timeouts when using cloud VMs with low resources. Configure the same timeout as that used for offline builds.
* doc: Increase Hugo timeout for offline buildsDanilo G. Baio2023-04-201-1/+1
| | | | | | | I still hit the timeout when building misc/freebsd-doc-* ports in parallel on poudriere. And occasionally we are receiving package-fallouts because of this.
* Increase Hugo timeout for offline buildSergio Carlavilla Delgado2023-04-101-0/+1
|
* Increase Hugo timeoutSergio Carlavilla Delgado2023-04-091-0/+1
| | | | | In some situations the default timeout in Hugo was not enough The timeout is doubled
* Move heading anchors to the end and add improve rendering on mobileSergio Carlavilla Delgado2022-09-011-1/+1
|
* Activate section anchors in the Documentation PortalSergio Carlavilla Delgado2022-07-151-0/+1
| | | | | | | | Right now every heading except the main one will display an anchor when the cursor is over the heading. In this way parts of the documentation can be easily shared only clicking in the anchor.
* Activate git info in the documentation portal and in the websiteSergio Carlavilla Delgado2022-04-081-1/+1
| | | | | | | | | In all pages except the main page for documentation portal and website will be shown information about who made the last modification and when. Thanks to dbaio@ and lwhsu@ to work into the CI infrastructure to reactivate the git info :)
* Add Indonesian translation of Mailing List FAQ articleAzrael JD2022-03-311-0/+4
| | | | | | | | | | | As this is a new language in the FreeBSD documentation, other files/translations were added together. Reviewed by: dbaio (translating it back to English) Approved by: dbaio (doceng) Differential Revision: https://reviews.freebsd.org/D34599 Co-authored-by: Danilo G. Baio <dbaio@FreeBSD.org>
* Disable Git informationSergio Carlavilla Delgado2022-03-251-1/+1
| | | | | The Hugo git information fails in the jenkins instance. Disable until find a proper solution.
* Add last modified to documentation and websiteSergio Carlavilla Delgado2022-03-251-0/+1
| | | | | Add the last modified information to the articles and books in the Documentation Portal and in the website.
* Remove Google AnalyticsSergio Carlavilla Delgado2022-03-211-1/+0
| | | | | | | | | | | | Remove Google Analytics from the Website and from the Documentation Portal. Also upgrade the FreeBSD's privacy policy page to reflect the Google Analytics removal. In the near future it will be replace with an open source alternative Approved by: core@, webmaster@
* Activate download pdf links for articles and booksSergio Carlavilla Delgado2022-02-281-0/+1
|
* Fix problems with links and CSS in offline modeSergio Carlavilla Delgado2022-01-291-6/+7
| | | | Reported by: dbaio@
* Activate the edit button for articles and booksSergio Carlavilla Delgado2021-12-271-0/+1
|
* Add new security configuration to Hugo configuration.Sergio Carlavilla Delgado2021-12-272-0/+22
| | | | | | | | | | | | | Hugo added a security policy in 0.91 version to restric access to os/exec, remote communication and similar as can be readed here[1] * Allow the use of AsciiDoctor to 'exec' * Add 'LOAD_PATH' and 'RUBYLIB' to 'osEnv' variables to allow the use of custom AsciiDoctor extensions Reported by: Li-Wen Hsu [1] https://gohugo.io/about/security-model/
* Upgrade FreeBSD Documentation Portal title to Documentation PortalSergio Carlavilla Delgado2021-12-2619-19/+19
| | | | | PR: 259371 Submitted by: Graham Perrin <grahamperrin (AT) gmail.com>
* Fix download link and translate Hugo theme to SpanishSergio Carlavilla Delgado2021-12-112-2/+2
|
* New Documentation PortalSergio Carlavilla Delgado2021-12-112-6/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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 improvementsSergio Carlavilla Delgado2021-11-032-4/+40
| | | | | | | | | | | | | | | | | | | | | | * 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
* documentation: Fix bn-bd language configDanilo G. Baio2021-10-091-1/+1
|
* hugo: Ignore gettext po files when buildingDanilo G. Baio2021-06-121-1/+1
|
* Improve the SEO of the documentation portalSergio Carlavilla Delgado2021-05-011-1/+2
| | | | | | | Changes: - Add the description meta tag in the index, articles and books - Add a brief description in each article and book. - Remove the SVN expansion tag
* Allow building the documentation and the website with upstream hugoSergio Carlavilla Delgado2021-03-311-1/+1
| | | | | | | | | | | | | | | | | | | | | | | When we build our documentation and website we use a hacked version of www/gohugo that allows for arbitrary asciidoc extensions. This was added as a patch in r562416. The suggested pull request[1] this patch was based on was not accepted "as is" and only allows the execution of extensions in Ruby's $LOAD_PATH. With these changes, we add our <docroot>shared/lib directory to Ruby's library directory so we can load our custom extensions. This also allows building the docs and website outsite FreeBSD using upstream and unmodified tools. Tested with the upcoming vanilla gohugo-0.82 provided by gohugo's maintainer. [1] https://github.com/gohugoio/hugo/pull/8131 Patch by: fernape@ Differential Revision: https://reviews.freebsd.org/D29410
* Add gitref macro to reference a git hashSergio Carlavilla Delgado2021-02-131-1/+1
| | | | | | | | | | | | | | | | | | With this extension a git hash can be easily referenced. The porters handbook versions chapter uses this extension as an example in the FreeBSD 14.0 version table. An example of use gitref:hash[repository="src|doc|ports",length=hash-longitude] The repository should be src, doc or ports. And if no length it's specified the macro will use 12 characters of the specified hash. PR: 253050 Submitted by: jhb@
* Use production settingLi-Wen Hsu2021-02-071-1/+1
| | | | | | PR: 253134 Reported by: wosch Approved by: carlavilla (implicitly)
* Enable robots.txt in docs.freebsd.orgSergio Carlavilla Delgado2021-01-261-0/+1
| | | | | | | Enable again robots.txt for docs.freebsd.org PR: 253031 Submitted by: wosch@
* Migrate doc to Hugo/AsciiDoctorSergio Carlavilla Delgado2021-01-2520-0/+104
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
generated by cgit v1.2.3 (git 2.25.1) at 2025-08-15 08:31:27 +0000