{"id":20589660,"url":"https://github.com/coreos/fedora-coreos-docs","last_synced_at":"2025-04-13T00:44:23.905Z","repository":{"id":37797585,"uuid":"170553473","full_name":"coreos/fedora-coreos-docs","owner":"coreos","description":"Documentation for Fedora CoreOS","archived":false,"fork":false,"pushed_at":"2025-04-11T21:19:45.000Z","size":960,"stargazers_count":55,"open_issues_count":78,"forks_count":131,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-04-11T22:27:21.389Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://docs.fedoraproject.org/en-US/fedora-coreos/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coreos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-02-13T17:56:57.000Z","updated_at":"2025-04-11T21:19:49.000Z","dependencies_parsed_at":"2023-10-02T21:30:38.061Z","dependency_job_id":"272da86b-862b-488a-b865-6a59c06f3a18","html_url":"https://github.com/coreos/fedora-coreos-docs","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coreos%2Ffedora-coreos-docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coreos%2Ffedora-coreos-docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coreos%2Ffedora-coreos-docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coreos%2Ffedora-coreos-docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coreos","download_url":"https://codeload.github.com/coreos/fedora-coreos-docs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248650419,"owners_count":21139672,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T07:30:15.103Z","updated_at":"2025-04-13T00:44:23.885Z","avatar_url":"https://github.com/coreos.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fedora Docs Template\n\nThis repository contains the Fedora CoreOS documentation. The format is [AsciiDoc](https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/) to enable integration into the official [Fedora documentation](https://docs.fedoraproject.org/en-US/docs/).\n\n## Structure\n\n```\n|-- README.md\n|-- antora.yml ....................... 1.\n|-- docsbuilder.sh ................... 2.\n|-- nginx.conf ....................... 3.\n|-- site.yml ......................... 4.\n`-- modules\n    `-- ROOT ......................... 5.\n        |-- assets\n        |   `-- images ............... 6.\n        |       `-- *\n        |-- nav.adoc ................. 7.\n        `-- pages .................... 8.\n            `-- *.adoc\n```\n\n1. Metadata definition.\n2. A script that does a local build. It shows a preview of the site in a web browser by running a local web server. Uses podman or Docker.\n3. A configuration file used by the local preview web server.\n4. A definition file for the build script.\n5. A \"root module of this documentation component\". Please read below for an explanation.\n6. **Images** to be used on any page.\n7. **Menu definition.** Also defines the hierarchy of all the pages.\n8. **Pages with the actual content.** They can be also organised into subdirectories if desired.\n\n## Components and Modules\n\nAntora introduces two new terms:\n\n* **Component** — Simply put, a component is a part of the documentation website with its own menu. Components can also be versioned. In the Fedora Docs, we use separate components for user documentation, the Fedora Project, Fedora council, Mindshare, FESCO, but also subprojects such as CommOps or Modularity.\n* **Module** — A component can be broken down into multiple modules. Modules still share a single menu on the site, but their sources can be stored in different git repositories, even owned by different groups. The default module is called \"ROOT\" (that's what is in this example). If you don't want to use multiple modules, only use \"ROOT\". But to define more modules, simply duplicate the \"ROOT\" directory and name it anything you want. You can store modules in one or more git repositories.\n\n## Local preview\n\nThis repo includes a script to build and preview the contents of this repository.\n\n**NOTE**: Please note that if you reference pages from other repositories, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://pagure.io/fedora-docs/docs-fp-o/) for instructions.\n\nThe script works on Fedora (using Podman or Docker) and macOS (using Docker).\n\nTo build and preview the site, run:\n\n```\n$ ./docsbuilder.sh -p\n```\n\nThe result will be available at http://localhost:8080\n\nTo stop the preview:\n\n```\n$ ./docsbuilder.sh -k\n\n```\n\n### Installing Podman on Fedora\n\nFedora Workstation doesn't come with Podman preinstalled by default — so you might need to install it using the following command:\n\n```\n$ sudo dnf install podman\n```\n\n### Preview as a part of the whole Fedora Docs site\n\nYou can also build the whole Fedora Docs site locally to see your changes in the whole context.\nThis is especially useful for checking if your `xref` links work properly.\n\nTo do this, you need to clone the main [Fedora Docs build repository](https://pagure.io/fedora-docs/docs-fp-o), modify the `site.yml` file to reference a repo with your changes, and build it.\nSteps:\n\nClone the main repository and cd into it:\n\n```\n$ git clone https://pagure.io/fedora-docs/docs-fp-o.git\n$ cd docs-fp-o\n```\n\nFind a reference to the repository you're changing in the `site.yml` file, and change it so it points to your change.\nSo for example, if I made a modification to the Modularity docs, I would find:\n\n```\n...\n   - url: https://pagure.io/fedora-docs/modularity.git\n     branches:\n       - master\n...\n```\n\nAnd replaced it with a pointer to my fork:\n```\n...\n   - url: https://pagure.io/forks/asamalik/fedora-docs/modularity.git\n     branches:\n       - master\n...\n```\n\nI could also point to a local repository, using `HEAD` as a branch to preview the what's changed without the need of making a commit.\n\n**Note:** I would need to move the repository under the `docs-fp-o` directory, because the builder won't see anything above.\nSo I would need to create a `repositories` directory in `docs-fp-o` and copy my repository into it.\n\n```\n...\n   - url: ./repositories/modularity\n     branches:\n       - HEAD\n...\n```\n\nTo build the whole site, I would run the following in the `docs-fp-o` directory.\n\n```\n$ ./docsbuilder.sh -p\n```\n# License\n\nSPDX-License-Identifier: CC-BY-SA-4.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoreos%2Ffedora-coreos-docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoreos%2Ffedora-coreos-docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoreos%2Ffedora-coreos-docs/lists"}