Là một dự án mã nguồn mở, vapor/docs đã đạt 331 sao trên GitHub, ngôn ngữ Swift. 📖 Documentation markdown for all Vapor packages.
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Now, clone the repo and move to the folder where you cloned the repo
cd /path/to/folder/
then build the pacakge with SPM
swift run VaporDocs
This will generate a site folder, now go inside the site folder
cd ./site/
then run it with kiln
kiln serve
finally open from the browser on the port 8000
e.g.
http://127.0.0.1:8000
Contributing
If 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.
Translating
Localised 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.
The docs are generated with Kiln, a documentation site generator written in Swift, so you'll need a Swift 6.2+ toolchain (no Python required). Build the site by running swift run VaporDocs in the root of the repository; the generated site is written to the site/ directory.
The translations live in Sources/VaporDocs/Languages.swift — the languages array (which Version4.swift passes to the docs site). Check whether the language you want to translate to is already there. If not, add it:
Language(
.dutch, // a built-in LanguageCode, or .custom(code: "xx", name: "…")
siteName: "Vapor Documentatie",
description: "Vapor documentatie (webframework voor Swift).",
navTranslations: [
"Welcome": "Welkom",
"Install": "Installeren",
],
customStrings: [
// Docs-specific navbar/footer strings. Copy the keys from the English
// block above; any you leave out fall back to English.
"skipToContent": "Naar de inhoud",
// …
],
image: "assets/og/nl-2x.png", // per-language social card (see below)
localisation: .init(
searchPlaceholder: "Zoeken"
// … other built-in UI strings; any left unset fall back to English
)
)
Navigation titles are translated via navTranslations, keyed by the English title used in the navigation tree. Kiln's built-in UI strings (search box, "previous"/"next", error page, …) are translated via localisation, and the docs-specific chrome (the language/version/theme picker labels, footer links, the skip-to-content link, …) via customStrings — copy its keys from the English language block. Anything you leave unset in either falls back to English, so partial translations are fine.
Each language also gets its own social/OpenGraph preview card. Add a 1200×630 PNG (ideally 2×, i.e. 2400×1260) at docs/4.0/assets/og/<language code>-2x.png and point to it with image: "assets/og/<code>-2x.png". Omit it and the language falls back to the site-wide card.
Copy the markdown file you would like to translate and name it <original file name>.<language code>.md. For example:
- index.md <- the original English documentation
- index.nl.md <- the Dutch translation
You can preview your changes by running swift run VaporDocs and serving the output, e.g. python3 -m http.server --directory site. Once you are satisfied with your translations, feel free to create a PR.
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.
NOTE: The docs and main site show a small banner offering visitors their preferred language ("This site is available in …"). For a brand-new language to be proactively suggested there, its locale and native name also need adding to the LOCALES map in the shared design repo, vapor/design (src/js/languageSuggestion.js). The translation works without this — the banner just won't suggest the new language until it's added.
Finally, you should add the new language to the issue template to ensure that any future changes are applied to the new translation.
Licensing
Except where otherwise noted, Vapor Documentation by Vapor is licensed under CC BY-NC-SA 4.0
vapor/docs có 331 sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/vapor/docs. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
vapor/docs có những chủ đề gì?
GitHub topics của vapor/docs: "documentation", "server-side-swift", "vapor". TopGit xếp repo vào nhóm mã nguồn mở.
vapor/docs còn đang phát triển không?
Commit gần nhất trên vapor/docs là 21 ngày trước (theo timestamp GitHub). Repo có 333 fork — một chỉ báo về mức độ quan tâm của cộng đồng.
vapor/docs là gì?
vapor/docs (vapor/docs) là dự án Swift trên GitHub. Theo mô tả gốc: 📖 Documentation markdown for all Vapor packages.
vapor/docs viết bằng ngôn ngữ gì?
vapor/docs chủ yếu viết bằng Swift. Trường "language" của GitHub dựa trên phần lớn byte ở nhánh mặc định.
Đọc đầy đủ README ở tab phía trên.
Vẫn đang phân vân về docs?
Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về docs.