aboutsummaryrefslogtreecommitdiff
path: root/documentation/content/en/books/handbook/eresources
Commit message (Collapse)AuthorAgeFilesLines
* Avoid the use of "you" in remaining handbook chaptersBenedict Reuschling2025-09-261-3/+3
| | | | | | | | | | | Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Differential Revision: https://reviews.freebsd.org/D52235
* doc: Update source files (en .po), for translationsDanilo G. Baio2025-05-011-95/+94
|
* [documentation]: Fix front matter "path" parameter.Fernando Apesteguía2025-02-181-1/+2
| | | | | | | | "path:" parameter in the front matter was not documented and it has been deprecated in gohugo 0.144.0. Create a custom parameter with the same name in preparation for the upcoming update of www/gohugo to 0.144.1
* documentation: Adjust path variables for Hugo 0.123.X upgradeDanilo G. Baio2024-03-231-1/+1
| | | | | | | | These adjustments ensure menu and navigation will work fine with the recent changes. Reviewed by: fernape Differential Revision: https://reviews.freebsd.org/D44284
* doc: Update source files (en .po), for translationsDanilo G. Baio2023-09-091-60/+55
|
* Handbook - eresources: Remove MarkMailSergio Carlavilla Delgado2023-09-071-1/+0
| | | | | PR: 273547 Reported by: Graham Perrin <grahamperrin@gmail.com>
* doc: Update source files (en .po), for translationsDanilo G. Baio2023-07-151-96/+118
|
* Handbook: Internet resources: correctnessGraham Perrin2023-07-151-2/+2
| | | | | | | | | | The Users’s Handbook is not a thing. Rewrite this list item. In the subsequent line, FreeBSD Foundation requires a 'The' prefix. https://bugs.freebsd.org/264754 PR: 264754
* Handbook: Internet resources: opening paragraphsGraham Perrin2023-07-151-6/+8
| | | | | | | | | | | | It's no longer realistic to count USENET amongst the top three media for effective reach. Rewrite the first two paragraphs. Some of what's here belongs elsewhere in the FreeBSD Handbook, but it's a start. https://bugs.freebsd.org/264754 PR: 264754
* Handbook: Internet resources: {freebsd-test}Graham Perrin2023-07-151-1/+1
| | | | | | | | | | {freebsd-test} requires a 'the' prefix. Whilst fixing the omission, reword the sentence. https://bugs.freebsd.org/264754 PR: 264754
* Handbook: Internet resources: text/html realityGraham Perrin2023-07-151-2/+8
| | | | | | | | | | Make what's stated closer to the reality of what happens when a multi-part email message includes text/plain and text/html parts. Opening comment 0 at https://bugs.freebsd.org/264754#c0 PR: 264754
* Handbook: Internet resources: list archivesGraham Perrin2023-07-151-2/+3
| | | | | | | | | | Make the FreeBSD-provided search interface primary. Add MarkMail. https://bugs.freebsd.org/264754 264754
* Handbook: Internet resources: misplaced directionsGraham Perrin2023-07-151-3/+4
| | | | | | | | | | | | Direction about what type of content to post does not belong under 'How to Subscribe'. Whilst moving text, be more assertive about subscription to freebsd-announce@ https://bugs.freebsd.org/264754 PR: 264754
* Handbook: Internet resources: misleading contentGraham Perrin2023-07-151-6/+2
| | | | | | | | | | | For each list, there is more than one unsubscription option. A URL is not found at the bottom of every email received from the list. That approach ceased maybe two years ago. https://bugs.freebsd.org/264754 PR: 264754
* Handbook: Internet resources: unreal mailto: URLsGraham Perrin2023-07-151-3/+3
| | | | | | | | | listname@freebsd.org and listname+unsubscribe@freebsd.org are unreal. Do not misrepresent them as mailto: URLs. https://bugs.freebsd.org/264754 PR: 264754
* Handbook WG - Create a new network chapterSergio Carlavilla Delgado2023-07-061-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | Create a new chaper with the basic configuration of a wired and wireless networks in FreeBSD. Sections of the new chapter: - Synopsis - Setting up the Network - Wired Networks - Wireless Networks - Hostname - DNS - Troubleshooting Changes: - Move wired network section from config to network - Move virtual hosts section from config to advanced networking - Move basic wireless section from advanced networking to network - Move IPv6 from advanced networking to network - Upgrade all command outputs - Use sysrc - Improve AsciiDoc syntax Differential Revision: https://reviews.freebsd.org/D40546 Reviewed by: bcr, dbaio, fernape, karels Sponsored by: Daifressh
* doc: Update source files (en .po), for translationsDanilo G. Baio2023-04-201-3044/+104
|
* Remove Mailing Lists from eresources chapterSergio Carlavilla Delgado2023-03-041-1004/+19
| | | | | | | | | | Instead of keeping two listings (the one from the currently obsolete handbook and the other one generated by mlmmj), tell the user where the listing auto-generated by mlmmj is located. Approved by: dbaio@, doceng@ Reviewed by: grahamperrin Differential Revision: https://reviews.freebsd.org/D38653
* Remove useless Hugo alias in HandbookSergio Carlavilla Delgado2023-03-041-1/+0
|
* Move wayland section to its own chapterSergio Carlavilla Delgado2022-11-021-1/+1
| | | | | | | | No changes, only move the content from X11 to a new chapter Patch by: trhodes@, with some minor changes from carlavilla@ Differential Revision: https://reviews.freebsd.org/D35099
* handbook: Update source files (en .po), for translationsDanilo G. Baio2022-10-011-632/+632
|
* handbook: Adjust YAML/aliases in the Front MatterDanilo G. Baio2022-10-011-5/+1
| | | | | | | | | | | | The aliases tags are valid YAML, but the po4a tool is not prepared to identify them. This change works around the issue until we have a proper fix on po4a. These aliases tags were introduced recently to improve SEO in the Handbook. Discussed with: carlavilla
* Add hugo aliases to improve SEO in the HandbookSergio Carlavilla Delgado2022-09-021-0/+5
|
* doc: Add source .po files for translationsDanilo G. Baio2022-08-071-0/+3485
| | | | | | | | | | | | | | | | | | This helps the Weblate translation workflow and offline translations through .po files, it's important to update these files constantly. The goal here is to have a semi-automated translation workflow; Weblate will pull updates automatically from the main repository and commit translations to another repository. Doc committers are encouraged to update the source .po files whenever there are updates in the English documentation part. $ ./tools/update_translate_template.sh documentation Anyway, I'll keep doing this periodically. Discussed with: doceng
* handbook/resources: remove references to bsd.networkDave Cottlehuber2022-05-051-1/+0
| | | | | | | | | | | As requested by bsd.network admins, the Mastodon-based social community is a private group, not a public resource. While many BSD aligned people may use it, this also ensures the privacy of those users is respected. Reported by: Peter Hessler <admin@bsd.network> Approved by: debdrup Sponsored by: SkunkWerks, GmbH Differential Revision: https://reviews.freebsd.org/D35126
* Add freebsd-accessibility@ to FreeBSD handbook mailing listsSergio Carlavilla Delgado2022-05-031-0/+3
| | | | | PR: 263318 Submitted by: PauAmma <pauamma (AT) gundo.com>
* handbook/mirrors: Refresh sectionDanilo G. Baio2022-02-111-143/+0
| | | | | | | | | Remove mirrors sections with stale information in favor of a small and unified one. Reviewed by: pauamma_gundo.com, philip, trasz Approved by: philip (clusteradm) Differential Revision: https://reviews.freebsd.org/D34156
* handbook: Fix trailing whitespace in eresources/Edward Tomasz Napierala2022-02-021-7/+7
|
* handbook: Fix typoEdward Tomasz Napierala2022-02-021-1/+1
| | | | Submitted By: Pau Amma
* handbook: Update the list of websites/community servicesEdward Tomasz Napierala2022-02-011-10/+18
| | | | | | Reviewed By: debdrup (earlier version), Pau Amma Sponsored By: EPSRC Differential Revision: https://reviews.freebsd.org/D34092
* New Documentation PortalSergio Carlavilla Delgado2021-12-111-0/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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
* handbook/eresources: Fix typoDanilo G. Baio2021-11-071-1/+1
| | | | Reported by: Pau Amma
* handbook/eresources: Point SVN lists to their archivesDanilo G. Baio2021-11-061-6/+2
| | | | Differential Revision: https://reviews.freebsd.org/D32753
* Build offline documentation using Hugo and other improvementsSergio Carlavilla Delgado2021-11-031-11/+28
| | | | | | | | | | | | | | | | | | | | | | * 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
* Remove references of old mailing listsDanilo G. Baio2021-10-141-14/+0
| | | | | | | | | - freebsd-eol - freebsd-lfs - freebsd-tilera - cvs-* It covers only English documents.
* Replace mailman-lists* variables with mailing-lists*Danilo G. Baio2021-10-131-1/+1
| | | | | | | | mailman-lists-desc --> mailing-lists-desc mailman-lists-url --> mailing-lists-url mailman-lists --> mailing-lists Following mailing lists migration from Mailman to Mlmmj.
* Replace Mailman to Mlmmj addressesDanilo G. Baio2021-10-121-1/+1
| | | | | | | Following mailing lists migration from Mailman to Mlmmj. Reviewed by: bapt Differential Revision: https://reviews.freebsd.org/D32466
* handbook/eresources: Remove mention of UTC in context of mirrors.Ceri Davies2021-06-251-2/+0
| | | | It is not necessary at best, and confusing at worst.
* Revert "Add Hugo's lang shortcode"Danilo G. Baio2021-06-191-3/+3
| | | | | | | 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 shortcodeDanilo G. Baio2021-06-191-3/+3
| | | | | | | | | | | | | | | | | | 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 One Sentence Per Line in the HandbookSergio Carlavilla Delgado2021-06-061-72/+188
|
* Improve SEO with the keywors meta tagSergio Carlavilla Delgado2021-05-041-0/+1
| | | | | | Add in all articles and books the tag list. Modify the theme to use the tag list defined in articles and books to generate the keywords meta tag
* Improve the SEO of the documentation portalSergio Carlavilla Delgado2021-05-011-0/+1
| | | | | | | 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
* Corrected the notation of mailing list name.Ryusuke SUZUKI2021-04-131-7/+7
|
* Migrate doc to Hugo/AsciiDoctorSergio Carlavilla Delgado2021-01-251-0/+1194
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-10-17 14:37:21 +0000