| Commit message (Collapse) | Author | Age | Files | Lines |
| |
|
|
|
|
|
| |
The boot1.efifat file was removed in 9a2b7c5. Update the instructions
with the file that actually exists in the system.
|
| |
|
|
|
|
| |
Purely cosmetic change.
|
|
|
|
| |
These look like a leftover from a patch, but are not necessary to have.
|
|
|
|
|
|
|
|
| |
"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
|
|
|
|
|
|
|
|
| |
Via `sh tools/update_translate_template.sh documentation`
Reviewed by: dbaio
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D48234
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Summary: Add the anchor text to the crossref macro
Test Plan:
Apply patch and build the documentation
A follow-up change will make the crossref macro fail if no description
is used.
Subscribers: delphij
Differential Revision: https://reviews.freebsd.org/D46721
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Use the crossref: macro for intra-file and intra-book links.
This will produce the correct link in Single HTML, Splitted HTML and PDF.
Rework the macro to include the PDF special render.
While here, briefly document macros.
PR: 266107
Reviewed by: bcr@, dbaio@, concussious.bugzilla_runbox.com
Differential Revision: https://reviews.freebsd.org/D46480
|
|
|
|
|
| |
Submitted by: ntremble@gmail.com
PR: 279481
|
|
|
|
|
| |
PR: 279295
Reviewed by: emaste
|
|
|
|
|
|
|
|
| |
These adjustments ensure menu and navigation will work fine with the
recent changes.
Reviewed by: fernape
Differential Revision: https://reviews.freebsd.org/D44284
|
|
|
|
|
|
|
|
|
| |
There is a redundant backtick.
Event: Advanced UNIX Programming Course (Fall’23) at NTHU
Reviewed by: Mina Galić <freebsd@igalic.co>, lwhsu
Pull Request: https://github.com/freebsd/freebsd-doc/pull/313
|
| |
|
|
|
|
|
|
| |
Reviewed by: Mina Galić <freebsd@igalic.co>
Approved by: carlavilla@
Pull Request: https://github.com/freebsd/freebsd-doc/pull/232
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
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
|
| |
|
|
|
|
|
|
|
|
|
|
| |
The ` keystroke alone no longer produces the ` character in my desktop
environment. I'll seek a fix for the input misbehaviour.
In the meantime, here's a fix for a commit that should have included
the character.
Fixes: 24b32e8dc6 Remove non-working note box markup within a table
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
From
https://web.archive.org/web/20211112014222/https://docs.freebsd.org/en/books/handbook/zfs/#zfs-term-quota
and from
https://web.archive.org/web/20211120235121/https://docs.freebsd.org/en/books/handbook/zfs/#zfs-term-quota
it seems that note box markup (below) ceased working, within a table,
some time between 12th and 20th November 2021.
[NOTE]
====
…
====
https://openzfs.github.io/openzfs-docs/man/7/zfsprops.7.html#quota
looks fine without using a note box, so let's not attempt to remake
the box in the documentation portal.
|
| |
|
|
|
|
|
| |
Reviewed by: dbaio
Pull Request: https://github.com/freebsd/freebsd-doc/pull/98
|
| |
|
| |
|
|
|
|
|
| |
PR: 257405
Reviewed by: grahamperrin@, pauamma@
|
|
|
|
|
|
|
|
| |
Pull Request: https://github.com/freebsd/freebsd-doc/pull/92
Reviewed by: carlavilla, gjb, pauamma (implicit)
Approved by: carlavilla (mentor), gjb (mentor)
|
|
|
|
|
|
|
|
| |
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
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
| |
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
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
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
|
|
|
|
|
| |
- s/is is/is/
- s/the the/the/
|
|
|
|
|
|
|
|
| |
* Upgrade OpenZFS link
* Remove old Oracle ZFS link
PR: 257404
Submitted by: Graham Perrin <grahamperrin (AT) gmail.com>
|
|
|
|
|
| |
PR: 263332
Submitted by: PauAmma <pauamma (AT) gundo.com>
|
|
|
|
|
|
|
|
|
|
|
|
| |
The handbook refers to the -P flag which according to zfs-send(8) means
(machine) parsable output, but the desired effect is for the properties
to be included in the send.
Change -P to -p, which zfs-send(8) identifies as the flag to include
properties.
Approved by: doc (debdrup), gerald (mentor)
Differential Revision: https://reviews.freebsd.org/D35015
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
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
|
|
|
|
| |
Dusting off my pointy hat: bcr
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
I used [1] to find the passive voice sentences and weasel words.
However, reviewers pointed out that some sentences were better of in the passive voice and that some of these weasel words were useful to understand the text. In those instances, I kept the original
sentences as they were.
The review became quite long in the process, but I think that the text
has improved a lot and that the concepts are better explained now.
Thanks to all the reviewers for their perseverance and good suggestions.
Reviewed by: debdrup, ceri, ygy, pauamma_gundo.com
Differential Revision: https://reviews.freebsd.org/D31707
[1] https://github.com/btford/write-good
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
* 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
|
|
|
|
|
|
|
| |
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 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 happening only on documentation/, basically in all places that
attaches a block or a paragraph to a list [1].
Although this is working, it impacts our translation tool po4a, the '+'
character is a difficult part when processing asciidoc[tor] files.
1 - https://docs.asciidoctor.org/asciidoc/latest/lists/continuation/#list-continuation
Reviewed by: carlavilla
Differential Revision: https://reviews.freebsd.org/D30688
|
| |
|
|
|
|
|
|
| |
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
|
|
|
|
|
|
|
| |
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
|
|
|
|
| |
Approved by: carlavilla
|
|
|
|
|
|
|
|
| |
Fix typo and renegade parenthesis in ZFS and virtualization
chapters in the handbook.
PR: 253264
Patch by: panden(at)gmail.com
|
|
|
|
|
| |
PR: 253075
Patch by: panden(at)gmail.com
|
|
|
|
|
| |
PR: 253153
Submitted by: Andreas Bjørnestad <panden at gmail dot com>
|