mirror/vcpkg
1
0
Fork 0
mirror of https://github.com/microsoft/vcpkg.git synced 2024-11-24 14:59:05 +08:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
6ee0e916d3
vcpkg/docs/index.md

58 lines
3.0 KiB
Markdown
Raw Normal View History

[vcpkg-docs] Rework documentation for compatibility with readthedocs.io and MkDocs.
2017-05-25 14:33:16 +08:00
### Quick Start
[docs] Fix typo in docs/index.md (#16522) The subject ("Your commitment") here is singular (IIUC). I thought this worth fixing as it's one of first things many folks will read about the project.
2021-03-11 03:33:41 +08:00
Vcpkg helps you manage C and C++ libraries on Windows, Linux and MacOS. This tool and ecosystem are constantly evolving; your involvement is vital to its success!
[vcpkg-docs] Rework documentation for compatibility with readthedocs.io and MkDocs.
2017-05-25 14:33:16 +08:00
### Examples
Rename example documents The current names and titles of the examples put too much emphasis on the package which is being demonstrated rather than the concept. This can be jarring for newcomers. This patch renames them to put the emphasis on the concept instead.
2018-11-15 19:18:48 +08:00
- [Installing and Using Packages Example: sqlite](examples/installing-and-using-packages.md)
- [Packaging Zipfiles Example: zlib](examples/packaging-zipfiles.md)
Add packaging GitHub repo example
2018-11-16 19:24:19 +08:00
- [Packaging GitHub Repositories Example: libogg](examples/packaging-github-repos.md)
Rename example documents The current names and titles of the examples put too much emphasis on the package which is being demonstrated rather than the concept. This can be jarring for newcomers. This patch renames them to put the emphasis on the concept instead.
2018-11-15 19:18:48 +08:00
- [Patching Example: Patching libpng to work for x86-uwp](examples/patching.md)
[vcpkg-docs] Rework documentation for compatibility with readthedocs.io and MkDocs.
2017-05-25 14:33:16 +08:00
### User Help
- [Integration with build systems](users/integration.md)
[vcpkg-docs] Initial commit of triplets documentation
2017-06-07 02:40:47 +08:00
- [Triplet files](users/triplets.md)
Allow redirection of the downloads folder with an environment variable. (#4883) * Add detection for VCPKG_DOWNLOADS environment variable in vcpkgpaths.cpp. * Pass the downloads directory from VcpkgPaths to cmake. * Also fixup bootstrap on *nix. * Make error message a little prettier. * Make that bash script actually work :) * [vcpkg] Alter Optional<> usage style * [vcpkg-docs] Add section on Environment Variables to the docs
2018-12-12 03:48:41 +08:00
- [Configuration and Environment](users/config-environment.md)
[vcpkg] Improve Android doc (triplets, usage with cmake and prefab) (#11264) * Android: add docs/examples/vcpkg_android_example_cmake/ * Add docs/users/android.md * Improve Android prefab doc Following additional informations given by @atkawa7 at https://github.com/microsoft/vcpkg/pull/11264 * Link to android.md * Update the prefab usage instructions: "vcpkg install" the 4 archs before exporting a prefab * added --prefab-debug flag * added gradle integration info * reviewed the prefab output directory structure (from a dump of an actual export) * docs/users/triplets.md: link to android.md * docs/index.md: link to android.md * android.md: specify 2 possibiities for android_ndk_home * Added examples/vcpkg_android_example_cmake_script/cmake/vcpkg_android.cmake Usage: 1. Main CMakeLists: if (VCPKG_TARGET_ANDROID) include("cmake/vcpkg_android.cmake") endif() 2. cmake invocation: cmake .. -DVCPKG_TARGET_ANDROID=ON -DANDROID_ABI=armeabi-v7a * trigger pipeline build * trigger pipelines
2020-05-14 07:42:13 +08:00
- [Usage with Android](users/android.md)
Fix broken doc link (#14833)
2020-11-30 05:44:03 +08:00
- [Using a manifest file to declare your dependencies](users/manifests.md)
[vcpkg-docs] Rework documentation for compatibility with readthedocs.io and MkDocs.
2017-05-25 14:33:16 +08:00
### Maintainer help
[vcpkg manifest] Add documentation! (#13488) * [vcpkg docs] add docs for manifest files These are just for the maintainer docs, not user docs. * [vcpkg] EBNF-ify platform expression parsing this modifies nothing about what strings are accepted or rejected, it just moves stuff around. also adds tests. * [vcpkg docs] add manifest mode example * [wip] docs for augustin also fix tabs * [vcpkg manifest] switch to using maps for features * Apply suggestions from code review * un-experimentize format-manifest * flesh out the user manifest mode docs * CRs * billy CRs * final personal pass-thru
2020-09-15 06:07:02 +08:00
- [Control files](maintainers/control-files.md) - in general, one should use manifest files instead
- [Manifest files](maintainers/manifest-files.md)
[vcpkg-docs] Rework documentation for compatibility with readthedocs.io and MkDocs.
2017-05-25 14:33:16 +08:00
- [Portfile functions](maintainers/portfile-functions.md)
[docs] Add maintainer guidelines (#6871) * [maintainer-guide] Initial commit of maintainer guidelines * [maintainer-guide] Rearrange sections * [maintainer-guide] Add note about GitHub Draft PRs * [maintainer-guide] Improvements * [maintainer-guide] Address comments about versioning conventions * [maintainer-guide] Add section about how portfiles interact with CMakeLists.txt * [maintainer-guidelines] Add link from docs index
2019-06-22 12:33:29 +08:00
- [Maintainer Guidelines](maintainers/maintainer-guide.md)
[vcpkg-docs] Rework documentation for compatibility with readthedocs.io and MkDocs.
2017-05-25 14:33:16 +08:00
Update tests, and add documentation! (#7506) This PR does the following: * fix tests -- now, they're always built in the CMake scripts, and they work on VS2015 *add a new flag, BUILD_TESTING, which allows one to turn off testing builds * Add documentation for running tests
2019-08-03 00:52:39 +08:00
### Tool Maintainer Help
- [Testing](tool-maintainers/testing.md)
[vcpkg docs] More tool maintainer docs! (#7821) * [vcpkg docs] Add benchmarking 🏎 to the docs! Also, minor changes to the testing docs. * add documentation for the layout of the project
2019-08-25 02:36:12 +08:00
- [Benchmarking](tool-maintainers/benchmarking.md)
- [Layout of the vcpkg source tree](tool-maintainers/layout.md)
Update tests, and add documentation! (#7506) This PR does the following: * fix tests -- now, they're always built in the CMake scripts, and they work on VS2015 *add a new flag, BUILD_TESTING, which allows one to turn off testing builds * Add documentation for running tests
2019-08-03 00:52:39 +08:00
- [Maintainer Guidelines](maintainers/maintainer-guide.md)
[docs] Add references to awesome community websites. Fixes #16278 (#16421)
2021-02-27 04:33:48 +08:00
### Community Resources (not directly affiliated with vcpkg)
Update to Community resources (#16489) - vcpkgx now also list older versions, no point in keeping the differentiator
2021-03-03 06:00:56 +08:00
- [vcpkg.info](https://vcpkg.info/) - Package index + search
[docs] Add references to awesome community websites. Fixes #16278 (#16421)
2021-02-27 04:33:48 +08:00
- [vcpkgx](https://vcpkgx.com/) - Package index + search
[vcpkg-docs] Rework documentation for compatibility with readthedocs.io and MkDocs.
2017-05-25 14:33:16 +08:00
### Specifications
- [Export](specifications/export-command.md)
Allow redirection of the downloads folder with an environment variable. (#4883) * Add detection for VCPKG_DOWNLOADS environment variable in vcpkgpaths.cpp. * Pass the downloads directory from VcpkgPaths to cmake. * Also fixup bootstrap on *nix. * Make error message a little prettier. * Make that bash script actually work :) * [vcpkg] Alter Optional<> usage style * [vcpkg-docs] Add section on Environment Variables to the docs
2018-12-12 03:48:41 +08:00
- [Feature Packages](specifications/feature-packages.md)
[vcpkg-docs] Rework documentation for compatibility with readthedocs.io and MkDocs.
2017-05-25 14:33:16 +08:00
### Blog posts
Add crossplatform announcement to docs
2018-04-25 06:52:32 +08:00
- [Announcing a single C++ library manager for Linux, macOS and Windows: Vcpkg](https://blogs.msdn.microsoft.com/vcblog/2018/04/24/announcing-a-single-c-library-manager-for-linux-macos-and-windows-vcpkg/)
adding a blog link in the doc
2018-05-17 00:25:44 +08:00
- [Vcpkg: Using multiple enlistments to handle multiple versions of a library](https://blogs.msdn.microsoft.com/vcblog/2017/10/23/vcpkg-using-multiple-enlistments/)
[vcpkg-docs] Rework documentation for compatibility with readthedocs.io and MkDocs.
2017-05-25 14:33:16 +08:00
- [Vcpkg: introducing the export command](https://blogs.msdn.microsoft.com/vcblog/2017/05/03/vcpkg-introducing-export-command/)
- [Binary Compatibility and Pain-free Upgrade Why Moving to Visual Studio 2017 is almost "too easy"](https://blogs.msdn.microsoft.com/vcblog/2017/03/07/binary-compatibility-and-pain-free-upgrade-why-moving-to-visual-studio-2017-is-almost-too-easy/)
- [Vcpkg recent enhancements](https://blogs.msdn.microsoft.com/vcblog/2017/02/14/vcpkg-recent-enhancements/)
- [Vcpkg 3 Months Anniversary, Survey](https://blogs.msdn.microsoft.com/vcblog/2017/01/11/vcpkg-3-months-anniversary-survey/)
- [Vcpkg updates: Static linking is now available](https://blogs.msdn.microsoft.com/vcblog/2016/11/01/vcpkg-updates-static-linking-is-now-available/)
- [Vcpkg: a tool to acquire and build C++ open source libraries on Windows](https://blogs.msdn.microsoft.com/vcblog/2016/09/19/vcpkg-a-tool-to-acquire-and-build-c-open-source-libraries-on-windows/)
### Other
- [FAQ](about/faq.md)
- [Privacy](about/privacy.md)
Reference in New Issue Copy Permalink