The translation is temporarily closed for contributions due to maintenance, please come back later.
Zen

Source string Source string

25/10000 · 25

This translation is currently locked.

English Actions
Building a local preview
Because the documentation site is using a markup language instead of a WYSIWYG editor, the sources do not look exactly like the rendered page will. Therefore it is necessary to check that your changes look the way you want them to before you push and make a pull request. This involves building a local preview.
There are two shell scripts available in each existing repository (including the template repository used to create new content): `build.sh` and `preview.sh`.
To preview, run the `build.sh` script; this is the one that actually builds a local version of the site (or, more precisely, the subset of the full site that resides in your current repository). Then, run `preview.sh`, which starts a webserver and serves the site at link:http://localhost:8080/[]. Opening this URL in any web browser will show you the preview, which will be available until you kill the process (kbd:[Ctrl+C] in the terminal).
To run the scripts you'll need to install [application]`Podman` if using a Linux OS such as Fedora or [application]`Docker CE` if using macOS.
Previewing multiple repositories
If your work spans content in multiple repositories, e.g. because you xref:asciidoc-fedora:markup.adoc#external-antora-link[link to another repository], you can extend the preview by adding more repositories to `site.yml` as follows:
content:
sources:
- url: .
branches: HEAD
- url: https://pagure.io/fedora-docs/another-repository.git
branches: main
Correct entries to use can be found from https://pagure.io/fedora-docs/docs-fp-o/blob/prod/f/site.yml[docs-fp-o site.yml].
Using the regular Antora scripts
If you want to use the regular Antora build and preview workflow - follow the instructions on https://docs.antora.org/[Antora Documentation page].
Once you have ``Antora CLI`` and ``Antora Site Generator`` you can build and preview the pages without the container scripts.
To build the pages in the project directory run:
antora generate site.yml
This will create a new directory ``public`` which contains all the necessary files. Navigate there and run a server command. You might already have a Python simple server, in which case run:
python3 -m http.server
or if you only have Python 2 on your machine:
python -m SimpleHTTPServer
It opens a local preview at port 8000.
If you have cargo (Rust package manager), you could also install and use ``miniserve`` or any other simple server of your choice for that matter.

Loading…

User avatar rffontenelle

Comment added

  1. fedora-docs-l10n/fedora-docs-contributing
  2. master/pages/local-preview
  3. English

Command line, do not translate.

3 years ago
User avatar None

Source string added

  1. fedora-docs-l10n/fedora-docs-contributing
  2. master/pages/local-preview
  3. English
antora generate site.yml
4 years ago
Browse all string changes
User avatar rffontenelle

Source string comment

Command line, do not translate.

3 years ago

Things to check

Multiple failing checks

Following checks are failing:
Unchanged translation: Portuguese (Brazil), Turkish, Indonesian

Reset

Comments

There is 1 unresolved comment for this string.

View

Glossary

English English
No related strings found in the glossary.

String information

Source string description
type: delimited block -
Flags
no-wrap, read-only
Source string location
./pages/local-preview.adoc:42
String age
4 years ago
Last updated
10 months ago
Source string age
4 years ago
Translation file
pot/master/pages/local-preview.pot, string 14