{"id":13872415,"url":"https://github.com/vapor/docs","last_synced_at":"2025-06-16T04:15:22.906Z","repository":{"id":37587529,"uuid":"64560805","full_name":"vapor/docs","owner":"vapor","description":"📖 Documentation markdown for all Vapor packages.","archived":false,"fork":false,"pushed_at":"2024-09-09T09:47:49.000Z","size":18291,"stargazers_count":316,"open_issues_count":38,"forks_count":327,"subscribers_count":38,"default_branch":"main","last_synced_at":"2024-09-09T22:46:16.656Z","etag":null,"topics":["documentation","server-side-swift","vapor"],"latest_commit_sha":null,"homepage":"https://docs.vapor.codes","language":"Swift","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/vapor.png","metadata":{"funding":{"github":["vapor"],"open_collective":"vapor"},"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"docs/security/authentication.de.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-07-30T19:28:18.000Z","updated_at":"2024-09-09T09:47:54.000Z","dependencies_parsed_at":"2023-12-18T18:24:38.371Z","dependency_job_id":"e3aeb162-28fd-4020-b4c8-084fdd171648","html_url":"https://github.com/vapor/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/vapor%2Fdocs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vapor%2Fdocs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vapor%2Fdocs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vapor%2Fdocs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vapor","download_url":"https://codeload.github.com/vapor/docs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226095757,"owners_count":17572980,"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":["documentation","server-side-swift","vapor"],"created_at":"2024-08-05T23:00:42.403Z","updated_at":"2024-11-23T20:31:02.427Z","avatar_url":"https://github.com/vapor.png","language":"Swift","funding_links":["https://github.com/sponsors/vapor","https://opencollective.com/vapor"],"categories":["Swift"],"sub_categories":[],"readme":"# Documentation\n\nRead the docs at [docs.vapor.codes](https://docs.vapor.codes)\n\n# Start with Docker \n* Prerequisite for this setup, you must have docker and docker compose installed on the system \n\n1. first clone the repo \n\n2. then run \n```\ndocker compose up \n```\n3. then open from the browser on the port 8000 \ne.g.  \n```\nhttp://127.0.1.1:8000\n```\n\n## Contributing\n\nIf you want to add information to the docs or have found any mistakes you wish to fix, feel free to create a PR  for the change.\n\n### *Translating*\n---\n\nLocalised docs are incredibly useful for allowing people to learn Vapor in their native language. If you wish to contribute to the Vapor documentation by translating, follow the steps below.\n\nYou'll need Python3 to build the docs. You can download this from the [Python Website](https://www.python.org/download/releases/3.0/) or install via Homebrew. Once installed, run `pip install -r requirements.txt` in the root directory of this repository. This will install all the needed dependencies in order to be able to build the documentation.  \n\nFollowing the installation of the dependencies, check if your language you want to translate to is already included in the `mkdocs.yml` file. If it is not, then you can add it like this:\n```yaml\nlanguages:\n  # Structure\n  \u003clanguage iso code\u003e:\n    name: \u003cThe name of the language\u003e\n    site_name: \u003cThe translated site name\u003e\n    build: true # Whether the documentation gets build or not. You can disable this if you don't want to build your language or want to temporarily disable other languages\n\n  # Example\n  nl:\n    name: Nederlands\n    site_name: Vapor Documentatie\n    build: true\n```\n\u003e NOTE: The language code you have to add must conform to the ISO 639-1 Standard. More information can be found [here](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes).\n\nIf there are navigation components that have to be translated, then you can add them under `nav_translations` in the mkdocs file. This is done by specifying a keyword defined in the `nav:` section of the `mkdocs.yml` file and then adding the translation. An example can be found below of how to add those:\n```yaml\nnav_translations:\n  # Structure\n  \u003clanguage code\u003e:\n    \u003ckeyword\u003e: \u003ctranslation\u003e\n\n  # Example\n  nl:\n    Welcome: Welkom\n    Install: Installeren\n```\n\nCopy the markdown file you would like to translate and name it `\u003coriginal name file\u003e.\u003clanguage code\u003e.md`. \nFor example:\n```\n- index.md \u003c- the original english documentation\n- index.nl.md \u003c- the dutch translation of the english documentation file\n```\n\nYou can check it out by running `mkdocs serve` in the terminal. Once you are satisfied with your translations, feel free to create a PR. Don't forget to turn the `build` flag to true for all languages!\n\n\u003e NOTE: If a file isn't translated, it will just default to the default language file. So you don't have to translate everything all at once.\n\nFinally, you should add the new language to the [issue template](https://github.com/vapor/docs/blob/main/.github/translation_needed.description.leaf) to ensure that any future changes are applied to the new translation and to the [search index script](https://github.com/vapor/docs/blob/main/fixSearchIndex.swift) to ensure search works correctly.\n\n## Licensing\n\n\u003cp xmlns:cc=\"http://creativecommons.org/ns#\" xmlns:dct=\"http://purl.org/dc/terms/\"\u003e\nExcept where otherwise noted, \u003ca property=\"dct:title\" rel=\"cc:attributionURL\" href=\"https://github.com/vapor/docs\"\u003eVapor Documentation\u003c/a\u003e by \u003ca rel=\"cc:attributionURL dct:creator\" property=\"cc:attributionName\" href=\"https://vapor.codes\"\u003eVapor\u003c/a\u003e is licensed under \u003ca href=\"http://creativecommons.org/licenses/by-nc-sa/4.0/\" rel=\"license noopener noreferrer\"\u003eCC BY-NC-SA 4.0 \u003cimg style=\"height: 16px;\" src=\"https://mirrors.creativecommons.org/presskit/icons/cc.svg\"\u003e \u003cimg style=\"height: 16px\" src=\"https://mirrors.creativecommons.org/presskit/icons/by.svg\"\u003e \u003cimg style=\"height: 16px\" src=\"https://mirrors.creativecommons.org/presskit/icons/nc.svg\"\u003e \u003cimg style=\"height: 16px;\" src=\"https://mirrors.creativecommons.org/presskit/icons/sa.svg\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvapor%2Fdocs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvapor%2Fdocs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvapor%2Fdocs/lists"}