{"id":18817987,"url":"https://github.com/starknet-io/docs-common-content","last_synced_at":"2026-01-15T13:30:18.982Z","repository":{"id":187455142,"uuid":"676922486","full_name":"starknet-io/docs-common-content","owner":"starknet-io","description":"Content that is shared between multiple Antora-based repos","archived":false,"fork":false,"pushed_at":"2024-06-23T11:06:15.000Z","size":184,"stargazers_count":7,"open_issues_count":2,"forks_count":15,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-30T02:29:21.397Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/starknet-io.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2023-08-10T10:17:17.000Z","updated_at":"2024-10-26T08:14:05.000Z","dependencies_parsed_at":"2024-06-23T12:39:38.797Z","dependency_job_id":null,"html_url":"https://github.com/starknet-io/docs-common-content","commit_stats":null,"previous_names":["starknet-io/docs-common-content"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starknet-io%2Fdocs-common-content","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starknet-io%2Fdocs-common-content/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starknet-io%2Fdocs-common-content/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starknet-io%2Fdocs-common-content/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/starknet-io","download_url":"https://codeload.github.com/starknet-io/docs-common-content/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239753733,"owners_count":19691162,"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-08T00:14:16.551Z","updated_at":"2026-01-15T13:30:18.889Z","avatar_url":"https://github.com/starknet-io.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"= docs-common-content\n\n:experimental:\n\nThe content in this repo is shared, or can be shared, between multiple Antora-based documentation repos, such as:\n\n* https://github.com/starknet-io/starknet-docs\n* https://github.com/starknet-edu/starknetbook\n\n== Prerequisites\n\n* Knowledge of Antora and AsciiDoc\n* Knowledge of the contribution guidelines for https://docs.starknet.io. See link:https://github.com/starknet-io/starknet-docs[The Starknet docs Contribution guidelines] in the Starknet docs repo.\n\n== Glossary for this repo\n\n[horizontal]\nchild repo:: This repo. Include this repo in the playbook.yml file of a parent repo.\nparent repo:: The repo for the Antora-based site that includes content from this repo.\nchild file:: A file in this repo that you want to include in the parent repo.\nparent file:: The file in the parent repo that has an `include::` directive to include a child file.\n\nYou can only use child files by using the AsciiDoc `include` directive to include a child file in a parent AsciiDoc file in the parent repo. The child file must be in the `partials` family directory.\n\nIf you directly reference a file in the `pages` family directory in a `nav.adoc` file, which defines the left navigation pane, clicking on the file in the pane leads Antora to go to the nav.adoc file of the module that contains the actual AsciiDoc file in the child repo. Because that module by its nature is not synchronized with a parent repo, Antora's context switches to show the nav.adoc for the child module which means that the left nav pane is empty.\n\nIt's much simpler to just include a file from the child repo with an `include` directive in a file in the parent repo.\n\n.Example\n\n* The parent repo is `https://github.com/starknet-io/starknet-docs`. (Published output: https://docs.starknet.io)\n* The child repo is the repo that you are now viewing, at `https://github.com/starknet-io/docs-common-content`.\n\n`/modules/ROOT/partials/partial_glossary.adoc` is a Glossary that I want to include in the parent repo as a standalone page.\n\nTo bring the child file into the parent site:\n\n. Create a parent file in the parent site named `glossary.adoc`. For example, I created this file as `https://github.com/starknet-io/starknet-docs/dev/components/Starknet/modules/ROOT/pages/glossary.adoc`. Here's the entire contents of `glossary.adoc`:\n+\n[source,adoc]\n----\n\\include::1.0.0@docs-common-content:ROOT:partial$partial_glossary.adoc[]\n----\n. Include the child repo in the playbook under the `sources` key. For example:\n+\n[source,yaml]\n----\n  sources:\n    - url: . \u003c1\u003e\n      branches:\n        - 'HEAD'\n      edit_url: 'https://github.com/starknet-io/starknet-docs/edit/dev/{path}'\n      start_paths:\n        - components/Starknet\n    - url: https://github.com/starknet-io/docs-common-content.git \u003c2\u003e\n      branches: 'HEAD'\n      edit_url: 'https://github.com/starknet-io/docs-common-content/edit/main/{path}'\n----\n\u003c1\u003e This section defines the main repo for the parent.\n\u003c2\u003e This section is the child repo.\n. Add the parent file to `nav.adoc` for the module in which you want to include it. You might have to experiment to place it as desired within the left nav pane.\n\nIf you make any changes to a child file, you need to manually regenerate the parent document.\n\n[IMPORTANT]\n====\nThe btn:[Edit this page] button in the parent document does not allow you to edit the _child_ file directly, only files in the parent repo.\n\nWhen a reader clicks btn:[Edit this page], the parent file opens. In order to enable the reader to make a direct contribution to the child file, you must add a comment with the URL that actually opens the child file in the Github editor.\n\nFor example:\n\n.The parent glossary.adoc file\n[source,adoc]\n----\n\\include::1.0.0@docs-common-content:ROOT:partial$partial_glossary.adoc[]\n\n// The source for the included file is in a separate repository.\n//\n// To edit the source page directly, go to:\n//\n// `https://github.com/starknet-io/docs-common-content/edit/main/modules/ROOT/partials/partial_glossary.adoc`\n----\n====\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstarknet-io%2Fdocs-common-content","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstarknet-io%2Fdocs-common-content","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstarknet-io%2Fdocs-common-content/lists"}