| Commit message (Collapse) | Author | Age | Files | Lines |
| |
|
|
|
|
|
| |
PR: 276795
Reported by: Paul Ivanov <pi@berkeley.edu>
|
| |
|
|
|
|
|
|
|
| |
Correct tag and macro syntaxes.
Reported by: bofh@
Fixes: d7957d161fd
|
|
|
|
|
|
|
|
| |
Via `sh tools/update_translate_template.sh documentation`
Reviewed by: dbaio
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D48234
|
|
|
|
|
|
|
| |
* Add description for some missing crossref macros.
* Remove a couple of dangling anchors
* Remove spurious '.' at the beginning of some descriptions
* Fix misspelled macro name
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
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
|
|
|
|
| |
Approved by: core
|
|
|
|
| |
PR: 274182
|
| |
|
|
|
|
|
| |
PR: 265276
Reported by: grahamperrin@
|
| |
|
|
|
|
|
|
| |
There are more things need to be updated in this doc.
Sponsored by: The FreeBSD Foundation
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Created a script that does the following:
- Calculates ports count yearly
- Calculates doc, ports, src, total unique committer numbers
This script is available at:
https://people.freebsd.org/~bofh/dropzone/dev-model.sh
And the graph generated is using this script. The tables has been
removed because it has been more than 28 years and putting this data in
the tables is not feasible at all. Additionally the tables of each 1000
milestone is difficult to achieve now hence has got ridden of it too.
Approved by: bcr (mentor)
Differential Revision: https://reviews.freebsd.org/D36972
|
|
|
|
|
|
|
|
| |
- Include myself in the doc committer counts
- Include ronald in the ports/total committers counts
Approved by: bcr (mentor)
Differential Revision: https://reviews.freebsd.org/D36931
|
|
|
|
|
| |
Reported by: bcr
Approved by: bcr (mentor)
|
|
|
|
|
|
|
|
|
|
| |
The current number of active committers is outdated in dev-model book.
Update the numbers from access files of the repo.
- Remove trailing whitespaces
- Remove trailing blank lines
PR: 264771
Approved by: carlavilla (mentor)
|
|
|
|
| |
- s/that that/that the/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
* 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
|
|
|
|
| |
It was missed when converted to Hugo/Asciidoctor.
|
|
|
|
|
|
|
| |
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
|
|
|
|
| |
Format the book with "One Sentence per Line"
|
|
|
|
|
|
| |
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
|
|
|
|
|
|
|
|
|
|
| |
Also add weights to some, to define the sort order in the index
Put the more commonly used items at the top of their respective lists
The improved descriptions were taken from the old books/articles list:
https://www.freebsd.org/docs/books/
Sponsored-By: Klara Inc.
|
|
|
|
|
|
|
| |
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
|
|
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
|