{"id":18840159,"url":"https://github.com/fortran-lang/fpm-docs","last_synced_at":"2026-01-27T03:07:50.687Z","repository":{"id":37015026,"uuid":"431533267","full_name":"fortran-lang/fpm-docs","owner":"fortran-lang","description":"Documentation repository for the Fortran package manager (fpm)","archived":false,"fork":false,"pushed_at":"2025-12-01T21:53:55.000Z","size":4315,"stargazers_count":42,"open_issues_count":23,"forks_count":27,"subscribers_count":14,"default_branch":"main","last_synced_at":"2026-01-13T02:39:32.657Z","etag":null,"topics":["documentation","fortran","fortran-package-manager","fortran-tutorial","fpm"],"latest_commit_sha":null,"homepage":"https://fpm.fortran-lang.org","language":"Fortran","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fortran-lang.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-11-24T15:20:53.000Z","updated_at":"2025-12-13T17:05:23.000Z","dependencies_parsed_at":"2023-12-25T11:30:47.796Z","dependency_job_id":"0a93efb8-8e67-4b4d-80a2-168e4201779c","html_url":"https://github.com/fortran-lang/fpm-docs","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fortran-lang/fpm-docs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fortran-lang%2Ffpm-docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fortran-lang%2Ffpm-docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fortran-lang%2Ffpm-docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fortran-lang%2Ffpm-docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fortran-lang","download_url":"https://codeload.github.com/fortran-lang/fpm-docs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fortran-lang%2Ffpm-docs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28798660,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T01:07:07.743Z","status":"online","status_checked_at":"2026-01-27T02:00:07.755Z","response_time":168,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["documentation","fortran","fortran-package-manager","fortran-tutorial","fpm"],"created_at":"2024-11-08T02:45:15.150Z","updated_at":"2026-01-27T03:07:50.666Z","avatar_url":"https://github.com/fortran-lang.png","language":"Fortran","readme":"# Fpm documentation\n\n[![pages](https://github.com/fortran-lang/fpm-docs/actions/workflows/sphinx.yml/badge.svg)](https://fpm.fortran-lang.org/)\n[![test](https://github.com/fortran-lang/fpm-docs/actions/workflows/build.yaml/badge.svg)](https://github.com/fortran-lang/fpm-docs/actions/workflows/build.yaml)\n\nRepository for building the documentation pages for the Fortran package manager (fpm).\n \n\n## Getting started\n\n### Get the code\n\n```\ngit clone https://github.com/fortran-lang/fpm-docs\ncd fpm-docs\n```\n\n### Install dependencies\n\nThe documentation pages are created using [sphinx](https://www.sphinx-doc.org).\nYou first need to install the required dependencies using conda or pip.\nThis project uses\n\n- [sphinx-build](https://www.sphinx-doc.org) for building the pages\n- [sphinx-intl](https://www.sphinx-doc.org/en/master/usage/advanced/intl.html) for translations\n- [ablog](https://ablog.readthedocs.io/en/latest/) for the news section and posts\n- [sphinx-book-theme](https://sphinx-book-theme.readthedocs.io/en/latest/) for the page theme\n- [myst-parser](https://myst-parser.readthedocs.io/en/latest/) for markdown support\n- [sphinx-design](https://sphinx-design.readthedocs.io/en/latest/) for the bootstrap building blocks\n- [sphinx-copybutton](https://sphinx-copybutton.readthedocs.io/en/latest/) to allow copying of code-blocks\n- [sphinx-jinja](https://github.com/tardyp/sphinx-jinja) to use templating for the registry\n\n#### conda\n\n```\nconda env create -n sphinx -f environment.yaml\nconda activate sphinx\n```\n\n#### pip\n\n```\npython3 -m venv venv\nsource venv/bin/activate\npip install -U pip\npip install -r requirements.txt\n```\n\n### Build fpm-docs\n\nBuild the documentation by invoking\n\n```\nmake html\n```\n\nThe website will be built in `_build/html` and can be previewed by opening the page with a browser (*e.g.* firefox, chromium or similar):\n\n```\nfirefox file://$PWD/_build/html/index.html\n```\n\nBy default all languages will be built.\nTo limit the build to a single language subtree, *i.e.* English, use\n\n```\nmake html LANGUAGES=en\n```\n\n\n### Translating via weblate\n\nTranslations can be contributed via [weblate](https://hosted.weblate.org/projects/fortran-lang/fpm/).\n\n[![Translation status](https://hosted.weblate.org/widgets/fortran-lang/-/fpm/horizontal-auto.svg)](https://hosted.weblate.org/engage/fortran-lang/)\n\n\n### Update or add translations\n\nThe documentation uses the\n[sphinx-intl](https://sphinx-intl.readthedocs.io/en/master/quickstart.html)\nutility to generate websites for multiple languages.\nIt generates `*.po` files,\nwhich contain the original sentences and a placeholder for translations.\n\nTo update translations run\n\n```\nmake gettext\n```\n\nif you only want to update a single translation add `LANGUAGES=de` to the command.\nThis command will generate the message catalog (`*.pot`) and update the `*.po` files in the *locale* directory of the respective translations.\nThen edit the `*.po` files,\ne.g. `locale/de/LC_MESSAGES/index.po`.\nIn the `*.po` files are paragraphs like\n```po\n#: ../../pages/index.md:16\nmsgid \"Package manager and build system for Fortran\"\nmsgstr \"\"\n```\n\nThe first line describes the file and line where to find the original text.\n\nThe second line is the original text.\n**Don't edit this line, edit the original document instead**.\n\nThe third line is meant for the translation.\n\nTo continue a long string in another line,\nsimply close the string in the current line with `\"`\nand open another one in the line underneath. E.g.\n```\nmsgstr \"This is \"\n\"one string\"\n```\n*don't forget a space between 'is' and 'one'*\n\nAfter adding or updating translations\nbuild the documentation as described above.\n\n## Pull Requests Previews\n\nYou can build the Preview of the fpm-docs website by opening a pull request\nand commenting `#preview` on the pull request. Similarly, you can force the\ndeletion of the preview by commenting `#delete-preview`.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffortran-lang%2Ffpm-docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffortran-lang%2Ffpm-docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffortran-lang%2Ffpm-docs/lists"}