Compare commits

...

593 Commits

Author SHA1 Message Date
jurobystricky d92c70bd91 Update vnc.rst 2020-06-26 17:39:09 -07:00
Kristal Dale 52b294d2af Update TM&B in tutorials section of docs (#1193)
* Update TM&B in tutorials section of docs

- Add disclaimers for Intel trademarks
- Update some 3rd party trademark attributions

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Correct broken link in kubernetes.rst

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* - minor edit: escape asterisk(*) per feedback.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2020-06-26 12:51:20 -07:00
Peter Jackson d6aa1285ce peteonrails/add zfs tutorial (#1174)
* Initial conversion of markdown guide

* More formatting

* Update zfs.rst

* Acknowlege @zaffle and @rincebrain's work in the clear repo

* Update zfs tutorial to reflect a DKMS build

* Clean up zfs tutorial

* For clarity

* Start working on ZFS on Root outline

* Update zfs.rst

* Sentence casing

* Update zfs.rst

* Add ZFS to the tutorials list

* Fix derp

* Formatting and simplification of language

* Remove ZFS on root for now

* Update zfs.rst

* Update zfs.rst

* More formatting

* Merge

* Move links to end note format

* More formatting and wording

* Link to article on ZFS mount generator

* Typo - Update source/tutorials/zfs.rst

Co-authored-by: Brett T. Warden <4c0e8e88@tm.wgz.org>

* Typo - Update source/tutorials/zfs.rst

Co-authored-by: Brett T. Warden <4c0e8e88@tm.wgz.org>

* Capitalize LTS - Update source/tutorials/zfs.rst

Co-authored-by: Brett T. Warden <4c0e8e88@tm.wgz.org>

* Capitalize LTS - Update source/tutorials/zfs.rst

Co-authored-by: Brett T. Warden <4c0e8e88@tm.wgz.org>

* Remove sudo from systemd 01-zfs.conf creation -- Update source/tutorials/zfs.rst

Co-authored-by: Brett T. Warden <4c0e8e88@tm.wgz.org>

* Add caution to Background section per PR feedback.

* Remove -dev bundle installation -- not necessary

* Symlink services into /etc/systemd. Add note about other services.

* Remove sig_unenforce since DKMS does this for us

* Add troubleshooting info to Caution section

* Address more PR feedback -- Link ZFS on Linux repo

* Revise wording for legal compliance and correct syntax.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Respond to reviewer feedback on wording; add sudo to commands as applicable.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Incorporate reviewer feedback on wording, organization, commands.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Clarify OpenZFS kernel modules must be loaded before mnounting OpenZFS.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Co-authored-by: Brett T. Warden <4c0e8e88@tm.wgz.org>
Co-authored-by: Michael Vincerra <michael.vincerra@intel.com>
2020-06-26 12:50:50 -07:00
Kristal Dale 552db8b0f5 Update TM&B in guides section of docs (#1187)
* Update TM&B in guides section of docs

- Add disclaimers for Intel trademarks
- Update/correct product names in text per Intel guidance

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Fix syntax/indent errors.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* - Add link back in (accidental removal) (dlrs-inference.rst) - Minor language clarifications
(compatible-kernels.rst) - Correct missed trademark (performance.rst)

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* - Correct product name in dlrs-inference.rst (confirmed with original author)
- Correct product name in dbrs.rst (confirmed with original author)
- Correct product name in compatible-kernels.rst

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Add in missing (r) in dbrs.rst

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2020-06-16 10:59:01 -07:00
michael vincerra 73e66c91b4 Adds option to bare-metal-install-* to use YAML config file for installation. (#1189)
- Improve discoverability of install-configfile; add link in intro
- Closes #1083
- Adds related topics.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-06-08 10:17:21 -07:00
michael vincerra a72721e8a5 Removes error message re "Missing CLR_SWAP partition" (#1188)
- Error message no longer accurate given default change to swapfile.
- Closes #1132.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-06-03 16:44:56 -07:00
michael vincerra d31ed849ff Align bare-metal-install-* docs with clr-installer verify-iso-integrity (#1186)
* Align bare-metal-install-* docs with clr-installer verify-iso-integrity

- New clr-installer feature, uses checksum to verify ISO image
- See also: https://github.com/clearlinux/clr-installer/pull/737
- Closes #1185
- Adds new section, Choose boot menu option.
- Figure 01 revised in bare-metal-desktop and -server
- Changes hierarchical levels of headers for consistency.
- Removes Software(optional) section from bare-metal-install-desktop
- Latter section is not relevant to installation process; no value
- Respond to reviewer feedback on wording.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Wording revisions per reviewer feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-06-03 11:27:41 -07:00
bktan8 b3bbfbb1ca Update compatibility-check (#1183)
Closes #1076

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-06-02 20:24:03 -07:00
Kristal Dale b42486ccb3 Update TM&B in Reference section of docs (#1181)
- Add disclaimers for Intel trademarks
- Minor corrections to a couple of Intel trademarks
- Add required nouns to Intel trademarks
- Remove duplicate '* Other names and brands ...'
- Remove SKU from table header in compatible hardware (as SKU is only part of the name)

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2020-06-02 11:35:42 -07:00
Kevin Putnam f6b6364490 Implements copy button (#1180)
* Adds support for sphinx_copybutton.

Closes #1134

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Additional config.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Remove cruft.;)

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* **DO NOT MERGE** Please verify changes with tutorials/proxy.rst. Once verified remove changes to proxy.rst.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Provides example usage of new codeblock copy behavior:

1. ShellSession (line 228 in kernel-modules-dkms.rst) - will copy everything except prompt.
2. Console (line 74 in kernel-modules-dkms.rst) - will copy only the input line without the prompt.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

Co-authored-by: Michael Vincerra <michael.vincerra@intel.com>
2020-06-02 11:21:34 -07:00
Kristal Dale 7afc835e56 Update TM&B in About section of docs (#1182)
* Update TM&B in About section of docs

- Add disclaimers for Intel trademarks
- Add asterisk for 3rd party trademarks
- Remove redundant asterisks (only first use needed)

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Adds "See Note below" for legacy support of `systemd-networkd`.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Co-authored-by: Michael Vincerra <michael.vincerra@intel.com>
2020-06-02 09:53:22 -07:00
Kristal Dale 9917676b92 Update TM&B in Get Started section of docs (#1184)
- Add disclaimers for Intel trademarks

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2020-06-02 09:21:35 -07:00
michael vincerra 0866c4a17f Revises tutorial ratings flowchart for logical coherence. (#1176)
- "Will impact of errors cause system failure" had 2 "yes" outputs.
- Export flowchart as SVG for improved scalability in web/mobile
- Closes #1175

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-05-21 11:34:49 -07:00
Kevin Putnam 203882bc7e Update to Sphinx 2.2.0 to update jquery.js to 3.4.1 (#1179)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-05-21 10:38:52 -07:00
bktan8 f4670e50bf Update "Proxy Configuration" tutorial (#1165)
Closes #1125

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-05-20 10:02:12 -07:00
michael vincerra 408f5965a7 Add 3 tutorials to tutorials index for discoverability. (#1173)
- Closes #1171

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-05-20 08:38:37 -07:00
michael vincerra 3a84441854 Deprecate OpenVINO tutorial; CL no longer supports computer-vision-openvino (#1177)
* Deprecate OpenVINO tutorial; CL no longer supports computer-vision-openvino.

- Closes #1166
- openvino was also removed from containers-basic bundle
- See also: https://community.clearlinux.org/t/openvino-in-clear-linux-os-moving-to-docker/4566

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Remove ref to computer-vision-openvino in developer-workstation.

- Remove ref to openVINO in tutorials index.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-05-19 11:54:20 -07:00
michael vincerra 659052ef96 Revise tutorial index to Low, Moderate, Difficult per CL meeting. (#1170)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-05-15 16:53:45 -07:00
bktan8 75f5e6d3b7 Shorten WordPress, LAMP, HPC tutorial titles (#1168)
Closes #1167

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-05-15 16:25:23 -07:00
bktan8 3a28d5d548 Tutorial: Create a mirror of upstream update server (#1153)
Closes #1133

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-05-15 16:22:42 -07:00
Kevin Putnam aa214223a5 Add reDocs GUI support (#1117)
* Adding support for reDocs GUI to Clear Linux Docs repo.

1. Added .tox and MANIFEST to .gitignore
2. Added py rule to make.bat to enable building of bundles.html.txt in Windows
3. Added .tox to exclude_patterns in conf.py
4. Added tox.ini and setup.py support files to project.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Updated setup.py with Clear Linux docs info.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Small adjustment.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-05-12 17:45:00 -07:00
michael vincerra 179a464571 Adds rationale for tutorial difficulty ratings (#1144)
- Closes #1082
- Add flowchart, and relocate skill-levels to reference dir
- Revises flowchart to show revised rating categories
- Revises title to "Tutorial difficulty ratings"
- Incorporates reviewer feedback
- Adds link in tutorials index to tutorial-ratings
- Revises filename and title for consistency

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-05-12 16:15:34 -07:00
Kevin Putnam 112f19c842 Cool columns of tutorials sorted by experience level. (#1143)
* Cool columns of tutorials sorted by experience level.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Fixed wording of 1st paragraph

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Moved kubernetes to High category.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Made change to address github action check.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Restored to :ref: from :doc:

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Updates tutorial index with latest changes on master.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-05-12 12:59:45 -07:00
bktan8 5481c7707f Update Redis tutorial (#1161)
Closes #1126

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-05-11 16:32:55 -07:00
bktan8 c7a87aa1ea Update WordPress tutorial (#1154)
Closes #1138

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-05-11 09:45:13 -07:00
puneetse f50e5f5057 Update MeRS page for V2 release (#1163)
Updates the MeRS page with information about the V2 release,  examples,  information on adding AOM support, and updates to new Intel Stacks locations.
2020-05-08 09:23:53 -07:00
Kevin Putnam 3fe2853c02 Escaped local host link, so it isn't turned into active link. (#1162)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-05-07 13:29:07 -07:00
bktan8 3ad6b68275 Update SMB server tutorial (#1156)
Closes #1128

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-05-07 13:27:03 -07:00
Kristal Dale b3d262ffe6 Performance doc (#1149)
* Performance doc

New doc providing an outline of the approach and tactics used by CL
for performance optimizations.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Edits and clarification based on feedback.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* - Fix typo
- Update Overview formatting for readability

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* - Replace 'hardware' with 'Intel architecture' for consistency with
About page.
- Added required TM&B disclaimer.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2020-05-06 17:47:42 -07:00
bktan8 0a15dd90b6 Simple HPC tutorial (#1121)
Closes #1080

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-05-05 11:47:01 -07:00
Kevin Putnam c42a0fe16c Add tri-weekly linkcheck (#1151)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-05-05 11:30:04 -07:00
puneetse f16502291c Update list of display managers (#1152) 2020-05-05 11:14:51 -07:00
bktan8 e2283f9705 Fix "Import Clear Linux Image and Launch Instance on AWS" issues (#1150)
Closes #1146

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-05-04 09:56:55 -07:00
michael vincerra 6a9522c627 Remove older figure 3 screenshot, inapplicable to Gen 1 Hyper-V. (#1148)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-05-01 15:03:14 -07:00
Kevin Putnam a6204a18cb Adds manpages to reference section of Clear Linux docs (#1110)
* Build manpages with "make man".

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Adds "make man" to github workflows.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Remove shell script dependency.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Change git URLs to https.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Moved git clone to Makefile.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Fixed typo.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Adding pandoc install.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Moved to Makefile.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* First commit toward programmatic creation of manpages.rst

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Multiple updates:

1. man-pages.rst now generated by script.
2. Updated Makefile and make.bat with "man" and "clean-man" recipes.
3. Fixed typo in conf.py.
4. Many improvements to manpages.py

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Updated readme for man pages and added man-pages.rst

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-05-01 12:23:21 -07:00
michael vincerra acb0f8e2db Align Hyper-V docs to align w change from hyper.vhdx to azure-hyperv.vhd. (#1145)
- Remove images azure-docker, azure-machine-learning, and hyperv.
- Closes #1141
- Revises from Hyper-V Gen 2 to Gen 1, with relative changes to settings.
- Replaces figure 3 because Gen 1 settings are different from Gen 2
- Revises image type to remove previous default `hyperv.vhdx`,
  a Gen 2 image -- no longer supported.
- Respond to reviewer feedback; fix typos.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-04-29 17:04:08 -07:00
puneetse 9687374e2a Revise kubernetes documentation (#1030)
Revisions to the order of concepts and consolidating commands to make the document more readable.
2020-04-24 16:16:29 -07:00
Kristal Dale f028d48096 Update copyright to be consistent with clearlinux.org. (#1140)
Updated copyright string in conf.py to be consistent with copyright used on clearlinux.org

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2020-04-24 16:12:06 -07:00
Beth Dean 1e08802399 Update DLRS guide with correct V6 link (#1137) 2020-04-21 16:37:36 -07:00
Beth Dean 9f5605dfff Update DLRS guide for v6 release (#1123)
* Update DLRS guide for v6 release

* Update versions for release

* update image name to sysstacks/... and change model path.

* Update for oneDNN and update links

* Update Docker version

* Update for branding and clarity
2020-04-21 11:40:37 -07:00
Lucius Hu 16ecd84b56 nvidia.rst: Added a section on slow boot times (#1130)
This closes https://github.com/clearlinux/clear-linux-documentation/issues/1101
2020-04-21 09:53:32 -07:00
michael vincerra edd1bc10ff Update bare-metal-install* to use swapfile instead of swap partition (#1124)
* Update bare-metal-install* to use swapfile instead of swap partition

* Scope covers  -server and -desktop versions of clr-installer
* Align with clr-installer release PR-705:
* https://github.com/clearlinux/clr-installer/pull/705
* Respond to reviewer feedback
* Closes #1131

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Remove blank line.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-04-20 13:06:19 -07:00
bktan8 df2078fab1 Minor updates to swupd 3rd-party (#1129)
Closes #1096

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-04-20 11:31:30 -07:00
Beth Dean 817b1f55ce - Add HPCRS guide to Stacks guides. (#1120)
- Correct URLs and formatting
- Add warning about image choice
- Corrects syntax, formatting errors for proper sequence of steps
- in ResNet50 workload section.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-04-20 10:59:30 -07:00
bktan8 ee83925330 Update fix broken installation (#1127)
Closes #1106

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-04-17 17:03:11 -07:00
michael vincerra a3b015717b Provide overview of CL architecture, including rationale. (#1109)
* Closes #1102
* Creates rationale for architectural design decisions
* Creates component list table and reorganizes content coherently.
* Applies organizational edits, line edits for consistency of voice.
* Respond to reviewer feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-04-14 13:37:30 -07:00
Beth Dean 7a6e9ae4ab Update png in DLRS guide (#1115) 2020-04-14 10:12:41 -07:00
Rahul 2f1b250cf8 update transformers section (#1112)
* update transformers section

Adding distilbert example, and the user does not need to install tensorflow or pytorch, but upgrade transformers library.

* Correct Sphinx syntax errors in code-blocks.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Co-authored-by: Michael Vincerra <michael.vincerra@intel.com>
2020-04-10 17:14:01 -07:00
bktan8 ef7fa72d94 Capture kernel boot messages in journal. (#1114)
Closes #1113

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-04-10 15:52:19 -07:00
Beth Dean 572467cef9 Update DLRS tutorial with instructions for using Transformers (#1111)
* Update DLRS tutorial with instructions for using Transformers

* Update source/guides/stacks/dlrs.rst

Co-Authored-By: michael vincerra <37549381+mvincerx@users.noreply.github.com>

* Add browser instructions for Notebook

Co-authored-by: michael vincerra <37549381+mvincerx@users.noreply.github.com>
2020-04-10 11:02:29 -07:00
michael vincerra d0748f3734 Align bare-metal-install-server and -desktop docs with clr-installer release 2.4.3. (#1104)
- "Only advertise the latest LTS kernel as an alternative to the Native kernel."
- clr-installer 2.4.3: https://github.com/clearlinux/clr-installer/releases/tag/2.4.3
- Revise bare-metal-install-server-30.png to support above.
- Revise bare-metal-install-desktop-21.png to support above.
- Closes #1100
- Revise Fig 21 to align with kernel selection in clr-installer release 2.4.3.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-04-03 10:09:36 -07:00
michael vincerra 537f7014cb Add caution admonition to introduce option to skip-validation-size in sys-reqs. (#1105)
* Add caution admonition to introduce option to skip-validation-size.
- Aligns minimum system requirements with:
- https://github.com/clearlinux/clr-installer/releases/tag/2.4.3
- Closes #1103.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Respond to reviewer feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-04-03 10:09:02 -07:00
michael vincerra 2ffff6fa9e Adds swupd-3rd-party option; removes instruction on Docker. (#1050)
- Use of Docker with mixer is now deprecated.
- Recreates grid table as list-table for future maintenance.
- Adds new section, Bundle definition files, for illustration
- Revises builder.conf in References, removing docker path.
- Updates mixer builder.conf to VERSION 1.2.
- Fix typo in filepath for LOCAL_RPM_DIR in builder.conf.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-03-30 17:02:59 -07:00
puneetse 154beef96e Fix version of OpenVINO and branding on Media Reference Stack (#1095)
* Fix OpenVINO version branding

MeRS uses the open source OpenVINO not the Intel® Distribution of OpenVINO™ toolkit

* Fix line length warnings

* Fix OpenVINO trademark branding

Fix OpenVINO trademark branding and add required acknowledgement
2020-03-26 13:10:27 -07:00
michael vincerra 40559931b6 Replace Fig. 32 to update embedded URL for swupd on docs.01.org. (#1097)
Closes #1038.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-03-25 14:37:25 -07:00
bktan8 c740464e73 Minor updates to the Stateless doc. (#1094)
Closes #1089

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-03-25 09:15:32 -07:00
puneetse 6c1d61b9d2 Add path to kernel source headers (#1092)
Add the path to kernel source headers in kernel module documentation for reference.
2020-03-24 11:25:42 -07:00
bktan8 1e048709b1 Remove CBM "update" after "set-timeout" (#1091)
Closes #1090

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-03-24 10:47:08 -07:00
Kevin Putnam cdb5531bcc Fixed broken links: (#1087)
Added escape character so they aren't turned into links:
guides/clear/mixer.rst:1127:
   [broken] http:/
guides/clear/swupd-3rd-party.rst:61:
   [broken] http:/

Pointed to containers and bundles that still exist:
guides/maintenance/developer-workstation.rst:58:
   [broken] https://clearlinux.org/software/docker/machine-learning/
guides/maintenance/developer-workstation.rst:187:
   [broken] https://clearlinux.org/software/bundle/web-server-basic
guides/maintenance/developer-workstation.rst:193:
   [broken] https://clearlinux.org/software/bundle/database-basic

Unable to fix - this document doesn't appear to exist. Recommend removing reference.
guides/stacks/dbrs.rst:41:
   [broken] https://clearlinux.org/news-blogs/database-reference-stack-dbrs-v2-now-available

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-03-20 11:20:23 -07:00
Beth Dean cb1e5c3942 Fix broken link (#1088) 2020-03-20 11:19:52 -07:00
bktan8 9e17ed2172 Update nginx setting for iPXE doc (#1086)
Closes #1085

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-03-20 08:46:19 -07:00
bktan8 2417f133c6 Create, Install, and Manage 3rd-party Bundles (#1075)
Closes #528

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-03-19 17:43:25 -07:00
Beth Dean 57929c7af8 Add memcached instructions for v2.0 (#1081)
* Add memcached instructions for v2.0

* Fix broken link, update Optane branding

* Add link to release announcement
2020-03-19 14:23:54 -07:00
bktan8 c5db9bbaa7 Update unattended installation doc and deprecate ister doc. (#1079)
Closes #1052

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-03-18 19:18:02 -07:00
bktan8 f15f84ba81 Import Clear AWS image, create AMI, and launch. (#1072)
Closes #890

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-03-10 16:39:49 -07:00
odwdinc 3b467b9682 Added fix for swupd bundle-add Error (#1067)
Signed-off-by: Anthony Pray anthony.s.pray@intel.com
When using the docker image you may see error
"Failed to install x of x"
ruining  "swupd clean" will fix the problems.
2020-03-10 11:25:22 -07:00
Lucius Hu de72a05153 nvidia.rst: Remove chmod +x on installer (#1070)
With `sudo sh NVIDIA-Linux-x86_64-<VERSION>.run`, we don't need to change its permission.

This commit makes it a bit more convenient for users.
2020-03-10 11:23:06 -07:00
Beth Dean 9e94e80ef8 Update instructions for X11 forwarding and SFTP (#1066)
* Update instructions for X11 forwarding and SFTP, closes #1027

* Clean up instruction steps for consistency
2020-03-10 11:11:50 -07:00
Lucius Hu 11736014d7 nvidia.rst: Correct the path for desktop files (#1069)
Desktop files should be created under `$HOME/.local/share/applications` instead of `$HOME/.local/share`,
at least on my system only the former one works.

This commit fixed the path for both installation and uninstallation.
2020-03-10 09:50:53 -07:00
Lucius Hu 2e5ca06c35 nvidia.rst: Add a section to restore ld.so.conf (#1068)
During installation, `ld.so.conf` was modified to include `/etc/ld.so.conf.d`, under which
a file `nvidia.conf` was created so that `ld` looks for shared library installed by NVIDIA driver.

This commit adds information on removing `nvidia.conf` file.
Users could optionally remove the line `include /etc/ld.so.conf.d/*.conf` that we added to
`/etc/ld.so.conf`.
2020-03-10 09:40:18 -07:00
Eric Adams 5bc7d20547 Adds hugepages config guide to explain defaults and config settings (#1061)
* Adds hugepages config guide to explain defaults and config settings

Closes #1005

Signed-off-by: Adams, Eric <eric.adams@intel.com>

* Made revisions per feedback from reviewer.

Signed-off-by: Adams, Eric <eric.adams@intel.com>
2020-03-06 15:26:02 -08:00
Chadwick Ferguson 311f86d55c Makes driver find application profiles (#1064)
* Makes driver find application profiles

muchas importante

* Update nvidia.rst

* Update nvidia.rst

* Update nvidia.rst
2020-03-06 14:59:39 -08:00
puneetse 0d4a550731 Add container images to get-started page (#1051)
Add a page under get-started section for Clear Linux OS container images
2020-03-06 14:57:09 -08:00
puneetse f1c1786936 Update FAQ (#1062)
Add 3 questions and revise top-down readability
2020-03-06 14:47:52 -08:00
michael vincerra e179118e1c Correct filenames (#1060)
its the small things that matter, 2 missing hyphens; fixing them turned my symlinks from red to green.  I only hope these are the correct names!
2020-03-05 08:39:33 -08:00
puneetse 44d07ab728 Update kata doc after default runtime change (#1054)
After Clear Linux version 31390 kata containers is no longer the default runtime for docker.
2020-03-03 14:32:22 -08:00
puneetse 63ac1a54be Add mkdir command for /etc/kernel (#1053) 2020-02-28 18:06:38 -08:00
michael vincerra e39fd30704 Adds tick marks for for File System descriptors, Default partition schema (#1057)
- Match exatcly syntax in bare-metal-install-desktop
- Improve UI legibility in HTML

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-02-28 18:05:02 -08:00
Mark Horn d67b9beac9 Note support for f2fs for clr-installer (#1056)
Support for f2fs file system type was enabled in the clr-installer
release 2.4.1.
https://github.com/clearlinux/clr-installer/pull/654

Signed-off-by: Mark D Horn <mark.d.horn@intel.com>
2020-02-28 17:42:17 -08:00
Beth Dean 990966b5b4 Add Horovod and OpenMPI section, closes #1041 (#1055)
* Add Horovod and OpenMPI section, closes #1041

* changing pygment lexar to console to fix build issue

* Remove single quotation mark inside code-block to correct build error.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Co-authored-by: michael vincerra <37549381+mvincerx@users.noreply.github.com>
2020-02-28 17:33:47 -08:00
Kevin Putnam 76e377278f Sets max width of content container to 1100 pixels and adjusts a few other settins to fit in the new arrangement. (#1046)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-02-26 14:07:47 -08:00
Kevin Putnam c44548a55a GitHub Actions Support (#1043)
* Adding GitHub workflow for checking PRs.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Added carriage return to end of document.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Adds build on push to master deploying to developmentHTML branch.
Adds build on push to publish deploying to latestHTML branch.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Uncomment publish URL.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Renamed Travis CI/CD file to avoid running it.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-02-26 13:48:09 -08:00
Kevin Putnam ce716eff61 Update to CPU performance guide. (#1037)
* Changed .. code:: to .. code-block:: to match project standards.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Updates to power and performance for readability and consistency with project reST standards.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Further updates to CPU performance guide with BIOS snapshot to show what DPTF setting might look like.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Addressing editorial feedback.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Added disclaimer for Intel Turbo Boost Technology.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-02-24 13:56:08 -08:00
michael vincerra 851a41de88 Revise steps for clarity and dist UI components, bootable-usb. (#1035)
* Revise steps for clarity and dist UI components.
- Resize all images for uniformity
- Revise from balenaEtcher to Etcher per USPTO trademark

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Add intro and revise wording where applicable.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Resizes image to be slightly larger.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Resizes Figure 2 for uniformity and makes minor edits.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Add Advanced Linux CLI section per group discussion.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Responds to user feedback applies editorial changes.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Corrects `lsblk` command labels to reflect output; adds ! for Flash complete.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-02-21 14:15:17 -08:00
michael vincerra 4d62a23039 Revises telemetry figure to correct URL; reorders steps. (#1040)
* Revises telemetry figure to correct URL; reorders steps.
- Reorders Assign Hostname to match oreder of menus in UI
- Corrects typos and grammatically unclear sentences.
- Renames figures as a result of reordering sections, above.
- Closes #1039.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Recaptures Fig 31, Swupd Mirror menu:
- Adds "allow installation over insecure connections..." checkbox

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-02-20 15:43:15 -08:00
eeeple bba463cb49 Update NVIDIA tutorial to recommend LTS kernel (#1034)
* Added recommendation to run LTS kernel for proprietary NVIDIA drivers (see https://github.com/clearlinux/distribution/issues/1725)

* Updated wording following puneete comment

* Updated wording following puneete comment
2020-02-20 12:55:08 -08:00
Kevin Putnam 72a6b7f212 Updates based on native Chinese speaker review. (#1036)
* Updates based on native Chinese speaker review.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Updates based on feedback.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-02-20 12:51:15 -08:00
odwdinc 4151fb20d7 Updated underlins
Signed-off-by: Anthony Pray anthony.s.pray@intel.com
2020-02-19 13:37:11 -08:00
odwdinc 8d9fe19c89 Update ImageTemplit
Signed-off-by: Anthony Pray anthony.s.pray@intel.com
2020-02-19 13:37:11 -08:00
odwdinc 29a77b8ba7 Updated format
Signed-off-by: Anthony Pray anthony.s.pray@intel.com
2020-02-19 13:37:11 -08:00
odwdinc ca40794a49 Images to update USB install instrusctions
Signed-off-by: Anthony Pray <anthony.s.pray@intel.com>
2020-02-19 13:37:11 -08:00
odwdinc f84ed4bdc9 Using balenaEtcher to create a bootable USB drive
Signed-off-by: Anthony Pray <anthony.s.pray@intel.com>
Need to get the images in to the doc? .. figure:: /_figures/bootable-usb/ ???
Find a way to do tabs for ejecting the usb drive  form each os, Windows, OSX, Linux
2020-02-19 13:37:11 -08:00
Kevin Putnam f9d2bbdb25 Convert Qing Cloud to English. (#1031)
* Replaced Chinese text with English. First pass.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Translated Qing Cloud deployment page to English.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Attempting fix for broken build caused by GitPython==2.1.11

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-02-18 12:54:42 -08:00
puneetse 3957464189 Add OpenFaaS tutorial (#1023) 2020-02-12 09:54:15 -08:00
Christoph 96217f6179 update to current settings (#1024)
The current CUDA Toolkit is v10.2 and now supports gcc8. I was able to install it only when the --samples option was removed. This is advice from https://community.clearlinux.org/t/cuda-toolkit-installation-error/1699
2020-02-11 11:34:57 -08:00
Adeel Mujahid 83b12c65fd Fix typo: s/bundle <search term>/search <term>/ (#1025) 2020-02-07 12:44:25 -08:00
bktan8 c95c1ffd70 Dual-boot win - add link to server install as another option. (#1022)
Closes #1008

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-02-06 13:56:48 -08:00
puneetse b2ecf5f144 Add a workarounds section (#1016)
Add a section for known workarounds to NVIDIA driver issues
2020-02-05 17:02:52 -08:00
Eric Adams 855153c10e Updated time.rst (#1013)
* Updated time.rst

When I tried this I had an error when I tried to set ntp to true that polkit was missing. Adding that bundle allowed the step to complete.

* Update time.rst 

Removed adding the polkit and instead added sudo to the timecatectl set-ntp command.
2020-02-05 13:52:09 -08:00
bktan8 77d7631e37 Update mixer build image to use clr-installer. (#1015)
* Update mixer build image to use clr-installer.

Closes #1006

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>

* Reverts Example 7 to recent master, omitting Tutorials header, etc.
- Reason: Separate branches not sync'ed based on upstream master

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Adds line in Example 4 to assure Example 2 is known prereq.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Simplify sentence.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Co-authored-by: michael vincerra <37549381+mvincerx@users.noreply.github.com>
2020-02-05 10:59:47 -08:00
bktan8 bef08ba148 Fix missing backslash for Windows path in vmw-player (#1020)
Closes #1017

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-02-05 10:22:55 -08:00
bktan8 07a1a9372f Update Clear on VMware Workstation player. (#1010)
Closes #988

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-02-03 12:29:29 -08:00
Kristal Dale 1dc3d59bc4 Minor edit to mixer guide for clarity (#1007)
In Example 7:
- Remove 'tutorial' subsection as it was not clear that it was an example of the
advanced example of manual format bump.
- Roll existing tutorial content under 'advanced' as it is the advanced example.
- Result is a basic and advance example for Example 7: execute format bump

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2020-01-31 12:49:19 -08:00
Kevin Putnam d0e71c8f5a 1. Fixes link to http://try.redis.io in redis tutorial. (#1012)
2. Fixes link to pmem-csi readme in DBRS stack guide.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-01-31 10:30:36 -08:00
michael vincerra 2327247a29 Add min. required disk space for bare-metal-install-desktop and bare-metal-install-server (#1004)
* Adds min. required disk space for live-server and -desktop install.

Closes #1001

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Removes cruft.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-01-27 09:10:27 -08:00
bktan8 c0981002a6 Update lsblk commands to make it easier to identify devices. (#1000)
Closes #984

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-01-23 14:59:29 -08:00
xiaoww 6627f3105a Qing cloud (#971)
* Added pngs for QingCloud

* Added QingCloud

* Update qingcloud.rst

* Update qingcloud.rst

* Update QingCloud-19.png

* applied the changes

Applied the changes based on Linjia's comments.

Names and picture have been modified accordingly.

* changed figure numbers

* changed figures number

* Create QingCloud-13.png

* 1. Fixed 2nd level section headers.
2. Changed title to include English.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

Co-authored-by: Kevin Putnam <kevin.putnam@intel.com>
2020-01-17 11:59:49 -08:00
bktan8 52ea187067 Clear Linux on Proxmox hypervisor. (#996)
Closes #938 

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-01-16 15:42:36 -08:00
Kristal Dale 10165b31ba Correct capitalization of DKMS to make standard with rest of doc. (#990)
Remove extra use of :abbr: (per contribe guide).

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2020-01-14 10:20:18 -08:00
Kristal Dale f481cbeaca New VMware Workstation tutorial (#924)
* New VMware Workstation tutorial

Add new VMware Workstation Pro tutorial.

Closes #462

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Update and rename vmware_workstation.rst to vmware-workstation.rst

* Editorial revisions

- Editorial review/fixes
- Separate commands into distinct steps
- Add clarifying text

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Minor grammar corrections.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Revisions based on feedback.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Co-authored-by: puneetse <22071208+puneetse@users.noreply.github.com>
2020-01-14 10:19:08 -08:00
Beth Dean ff5f2e41c7 Add inference and multinode guide page for DLRS stack (#877)
Closes #876 

* Add inference and multinode guide page for DLRS stack

* Add images for Locust, add section on autoscaling & comms

* update Seldon autoscaling, move INGRESS_DDRSS section

* Move INGRESS_ADDRESS to benchmarking section, changes for readabiity, reduce ToC to 1

* remove gitlab URL

* Move INGRESS_ADDRESS section and reword introduction
2020-01-13 10:49:27 -08:00
michael vincerra 637ebdc2ba Revise dd command to clarify and avoid misinterpretation in bootable-usb. (#982)
* Revise `dd` command, under Linux, to clarify and avoid misinterpretation.

- Closes #968

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Apply same changes re device name from linux to macOS. Add note.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-01-10 14:43:59 -08:00
bktan8 1b8fe35939 Alternative - install Windows after Clear Linux (#981)
Closes #967 

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2020-01-10 14:36:39 -08:00
puneetse ce3a6c3321 Add document for Broadcom drivers (#980) 2020-01-10 14:25:15 -08:00
Kevin Putnam 10d167b543 Fixes link that was hardcoded to point to clearlinux.org/documentation ... (#986)
Now uses :ref: to same page.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-01-10 12:25:18 -08:00
Kevin Putnam 2020f5b1a6 Adds IRC channel to link to freenode.net. (#983)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-01-09 11:38:40 -08:00
michael vincerra c913639121 Prepends mixer build commands with sudo for successful execution. (#979)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2020-01-07 14:27:32 -08:00
Kevin Putnam fb989f6291 Adds support for drop shadows on figures by adding appropriate rst-class before figure: (#977)
.. rst-class:: dropshadow

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-01-07 14:05:35 -08:00
Tonny Tzeng 8e32449d47 doc: refresh the Clear Linux OS on GCP guide (#976)
Update the Clear Linux OS on Google Cloud Platform guide with:

- Screenshots for the new Storage bucket creation.
- Remove the black dot in the username limitation warning.

Signed-off-by: Tonny Tzeng <tonny.tzeng@intel.com>
2020-01-07 09:32:02 -08:00
Kevin Putnam 97cc3cfbbd Update landing page (#975)
* 1. Updated landing page to emulate look and feel of docs page on clearlinux.org
2. Added Trademarks, Cookies, and Privacy Terms links to footer with some css formatting
3. Added some CSS to pre-emptively remove added formatting to definition list entries in sphinx/rtd theme in version 2 and above

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Added start/end for footer bullet list support

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* 1. Hid toctree to reduce duplication.
2. Changed IRC link to match what is currently on the clearlinux.org site.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-01-06 15:50:59 -08:00
guowangy df0063ef02 cpu-performance.rst: add thermal configuration section (#961)
* cpu-performance.rst: add thermal configuration section

* Apply suggestions from code review

Co-Authored-By: michael vincerra <37549381+mvincerx@users.noreply.github.com>
Co-Authored-By: puneetse <22071208+puneetse@users.noreply.github.com>

* remove workaround part and add BIOS requirement

* ensure acpi tools is installed

* Apply suggestions from code review

Co-Authored-By: michael vincerra <37549381+mvincerx@users.noreply.github.com>

* format fixup

* Apply suggestions from code review

Co-authored-by: michael vincerra <37549381+mvincerx@users.noreply.github.com>
Co-authored-by: puneetse <22071208+puneetse@users.noreply.github.com>
2019-12-31 11:58:38 -08:00
puneetse 41ca0a41b9 Update note on wireless in live-server getting started (#966)
* Add reference to configuring wifi guide

Add reference to configuring wifi guide and place the note according the required order of operations

* Fix line too long RST warning.
2019-12-27 10:38:35 -08:00
Beth Dean 056119551c Update readme URL and remove redundant Seldon section (#965)
LGTM
2019-12-20 16:26:00 -08:00
Kevin Putnam 5071a60b34 Fixed two broken links found in weekly check. (#964)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-12-20 11:18:16 -08:00
Kevin Putnam 4e16119846 Fixed two broken links found in weekly check. (#963)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-12-20 11:15:26 -08:00
bktan8 81ea8a4e54 Add how to boot Clear via GRUB. (#909)
Add dual-boot-linux link to the multi-boot doc.
Closes #908 
Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2019-12-19 11:22:18 -08:00
Kevin Putnam f975d1dc00 Update to wifi guide to include wpa_supplicant. (#939)
* Update to wifi guide to include wpa_supplicant.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Addressed reviewer feedback.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Missed one piece of feedback.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Small changes based on testing on Clear Linux to verify the current solution.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Caught a couple small things.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Update wifi.rst

Add more context and update commands to be as executable as possible.

* Fixed a typo and a couple of formatting problems.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-12-18 14:24:37 -08:00
Beth Dean e90885986f Update for DLRS V5 release (#962) 2019-12-17 21:20:01 -08:00
bktan8 7b21fb9159 Update increase-virtual-disk-size doc. (#958)
Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2019-12-16 14:46:23 -08:00
bktan8 b753e49df3 Minor fixes to DigitalOcean doc. (#959)
Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2019-12-16 09:27:24 -08:00
bktan8 edbb9286e5 Deploy Clear to DigitalOcean guide. (#952)
Closes #886 
Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2019-12-13 14:20:18 -08:00
DougTW 1b15019f03 vnc.rst: corrected figure numbering to be sequential (#944)
* vnc.rst: corrected figure numbering to be sequential, starting with Figure 5.

Signed-off-by: Doug Martin <doug.martin@intel.com>

* Fixed incorrectly numbered reference to a figure.

Signed-off-by: Doug Martin <doug.martin@intel.com>
2019-12-13 09:43:18 -08:00
extremepayne f9d976de41 Windows command sha512 -> SHA512 (#956)
* Windows command sha512 -> SHA512

The command fails (on my computer) unless the hash algorithm is passed as uppercase.
As per: https://answers.microsoft.com/en-us/windows/forum/all/certutil-hashfile-sha1-failed/1a9f31fa-bdf5-4c63-8e72-91608606ba14

* trigger CI
2019-12-13 09:38:08 -08:00
michael vincerra cdaa36e279 Add improved role descriptions and bundles to developer-workstation (#947)
* Add bundle function and desc to developer-workstation.
- Closes #764

* Add more bundles relevant to each role.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Add `ltp` to kernel developer; revise AI Dev to AI/ML Engineer.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revise bundles listed for kernel developer and add maker dev.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Removes Embedded Systems profile due to few relevant bundles.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Remove game developer per review from @ahkok.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Adds containers-virt to Computer Vis. Engineer; and reference note.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-12-12 10:42:43 -08:00
michael vincerra e2e1a2896c Replace stacks-tensorflow-mkl with stacks-dlrs-mkl per @DnPls. (#955)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-12-11 11:21:01 -08:00
DougTW 0a8674c530 parallels.rst: Fixes Figure caption indent Closes #896 (#942)
* Fixes Figure caption indent

Signed-off-by: Doug Martin <doug.martin@intel.com>

* parallels.rst: fixed alignment
- Removed tabs and replaced with spaces

Signed-off-by: Doug Martin <doug.martin@intel.com>
2019-12-09 11:29:53 -08:00
michael vincerra 7a4e6c6d1c Combine two VMWare guides into one: vmw-player. (#950)
* Combine VMWare guides into one, separate image types with tabs in vmw-player.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Re-arrange all figures into _figures dir and manage file dependencies.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Fix indentation error in tabs preventing successful build.
- Reorganize vmw-player-preconf figures.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Replace Figure 11; move Detach the |CL| installer ISO to Desktop tab.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Reorg figures and order of ops per forked flow, reviewer feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-12-09 10:16:36 -08:00
michael vincerra 410768be7e Simplify section "Boot a live desktop image to fix..." in fix-broken-install (#951)
* Simplify section Boot a live desktop image to fix...
- Remove include per request from @bktan8
- Make concise the Prereq's

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Fix spacing syntax.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Clarify swupd scope re /var dir. Revise wording in Prereqs.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-12-05 13:33:39 -08:00
mns6070 389887026e Updated to mount the /boot partition (#946)
* Update fix-broken-install.rst
* Updates to lsblk command Ln 52 and wording on Ln 56.
2019-12-04 13:29:36 -08:00
DougTW 0aa9fad0ec dpdk.rst: Fixes Figure caption indent (see pr 896) (#945)
- This PR doesn't close pr 896 because there are multiple files to be fixed. Last PR will close pr 896.

Signed-off-by: Doug Martin <doug.martin@intel.com>
2019-12-02 23:47:14 +01:00
DougTW 96b4c58aa7 Fixes Figure caption indent (#941)
Signed-off-by: Doug Martin <doug.martin@intel.com>
2019-12-02 15:33:03 -06:00
DougTW d539c6feff dlrs.rst: Fixes Figure caption indent (see pr 896) (#943)
-This pr doesn't close pr 896 because multiple files need to be edited. Last PR will close pr 896.

Signed-off-by: Doug Martin <doug.martin@intel.com>
2019-12-02 15:30:19 -06:00
bktan8 6e3e1d9135 Troubleshooting tip on how to erase LVM partitions (#937)
* Troubleshooting tip on how to erase LVM partitions
to baremetal installation guides.

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>

* Update source/get-started/bare-metal-install-server.rst
2019-11-22 13:41:09 -08:00
michael vincerra f8207916a3 Resolve rendering error in README. (#935)
* Resolve rendering error in README.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Removes hashes for steps.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revise header level.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-11-22 10:57:14 -08:00
Kevin Putnam c98dfdad9c Fixes reference URLS that were being automatically turned into active links that don't go anywhere. (#934)
Simple fix - escape the URL by adding "\".

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-11-22 10:55:18 -08:00
michael vincerra 912bb57255 Add virtualenv option for contributors in README. (#927)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revise Makefile to enable make venv target and add instructions.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revises README.md and root-level Makefile target `make venv`.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revise venv target; revise README to simplify activation/deactivation.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revise syntax to emph markdown rendering.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Fix formatting errors and make consistent ref to platforms.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-11-21 16:40:49 -08:00
bktan8 8ca656b901 iPXE updated to use clr-installer. (#932)
ister and icis deprecated.

See also: https://github.com/clearlinux/clr-bundles/issues/171
Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2019-11-21 15:39:14 -08:00
Kevin Putnam 112ec79c56 Added support for sphinx-tabs and created an example on the Stacks DB reference stack guide. (#928)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-11-21 15:05:26 -08:00
michael vincerra 9264ae8b73 Correct external GitHub link; correct syntax of internal link to building custom Docker image. (#931)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-11-20 14:02:13 -08:00
puneetse dbf84a7bb9 Add guide for Media Reference Stack (#929)
* Add guide for Media Reference Stack

* Correct errors in syntax and docstring refs for successful build.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Corrects docstring ref title from `tutorial-proxy` to `proxy`
- Resolves build error detected by Travis

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-11-20 11:38:42 -08:00
michael vincerra a39c15e550 Remove empty spaces and check syntax based on prev failures. (#930)
* Remove empty spaces and check syntax based on prev failures.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Removes 👍 to isolate problem.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-11-19 21:00:25 -08:00
michael vincerra 74fd2fab55 Revise bullet to clarify offline install option, bare-metal-install-desktop (#925)
* Revise bullet to clarify offline install option, bare-metal-install-desktop.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Modify wording per reviewer feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-11-18 14:45:55 -08:00
michael vincerra c9134c7283 Create greetings.yml (#922)
Create a greetings message to show users who submit their first Issue or first PR to the repo.
2019-11-16 16:14:49 -08:00
Mary Camp 2258c90604 Fixed nesting issue. (#895)
* Fixed nesting issue.
* Fixes #888 
Editorial changes for grammar and formatting.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Moved Background section, made minor text edits

Signed-off-by: MCamp859 <maryx.camp@intel.com>
2019-11-15 15:34:46 -08:00
Kevin Putnam 3ec50a2cf8 Added 4 links to whitelist as they consistently report as failing but manual checks show them working. (#921)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-11-15 11:35:39 -08:00
Beth Dean dd6d5aeed2 Update URL for kfctl_k8s_istio.yaml (#920)
* Update URL for kfctl_k8s_istio.yaml

* Update URL to pull raw file for config ENV variable
2019-11-14 12:00:28 -08:00
Kevin Putnam d4cb55239f Restore Tl telem (#794) (#916)
* Tl telem (#794)

* update telemetry opt-in requirement

Signed-off-by: Tom Leavitt <30448839+tpleavitt@users.noreply.github.com>

* update telemetry docs for opt-in changes

Signed-off-by: Tom Leavitt <thomas.p.leavitt@intel.com>

* Update telemetry guide

Signed-off-by: Tom Leavitt <thomas.p.leavitt@intel.com>

* telemetry typo and bundle name update

Signed-off-by: Tom Leavitt <thomas.p.leavitt@intel.com>

* Spelling correction line 186

Signed-off-by: DougTW <doug.martin@intel.com>

* Formatting revisions:
-Removed EOL spaces
- broke lines longer than 78 characters
- re-wrapped text as needed

Signed-off-by: DougTW <doug.martin@intel.com>

* Minor editorial changes to telemetrics.rst

Signed-off-by: DougTW <doug.martin@intel.com>

* Fixes based on feedback.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-11-13 11:20:38 -08:00
Marcos Simental 7f61f94836 guides/clear/stateless: specify /usr/local as user owned (#912)
besides /var, /etc, /opt and /home, users are allowed to make
local installations in /usr/local without getting swupd
operations to remove such content.

be excplicit about /usr/local in the stateless guide.

Relates to https://github.com/clearlinux/distribution/issues/1475

Signed-off-by: Simental Magana, Marcos <marcos.simental.magana@intel.com>
2019-11-13 09:37:32 -08:00
Kevin Putnam 5a66e0effe Add support for multiple column displays and cards (#906)
* Adds support for multiple columns in reStructuredText. Required for landing page redesign.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Catching the branch up to master.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Fixing line endings in tcs_theme.js.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-11-13 08:52:28 -08:00
bktan8 69f7314da2 Added bash console directive for the clr-boot-manager commands. (#914)
Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2019-11-13 08:51:34 -08:00
bktan8 b3dc735a6c Doc. on how to enable systemd boot menu (#911)
* Doc. to enable systemd-boot menu.

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>

* removing dual-boot-linux and multi-boot from this commit

* Update source/guides/maintenance/enable-systemd-boot-menu.rst
2019-11-12 06:09:59 +00:00
Beth Dean a1c4bf38dc Update URL for DARS repository (#893)
* Update URL for DARS repository

* Update path in command to build Docker image

* update path for dockerfile build instructions
2019-11-11 18:09:45 +00:00
David Shade 0351271a7e Update dbrs.rst (#903)
modify the Optane DCPMM configuration section to add additional clarity
2019-11-07 16:39:15 -08:00
David Shade 63cd737447 Update dbrs.rst (#902)
update to hardware configuration to remove references to DCPMM codenames
2019-11-07 16:32:03 -08:00
bktan8 23bbd6ba73 Update VNC doc. (#900)
* Update dual-boot-win with better systemd-boot screenshot.

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>

* Revised VNC doc.
Minor tweaks.

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>

* Correct minor formatting indentation error.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-11-06 21:47:55 -08:00
michael vincerra c99e596c79 Removes 1 empty space to assure proper render in dual-boot-linux. (#899)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-11-05 18:26:02 -08:00
bktan8 5eebaea1f6 Update dual-boot-win with better systemd-boot screenshot. (#898)
Signed-off-by: Bun K Tan <bun.k.tan@intel.com>
2019-11-05 18:07:20 -08:00
michael vincerra d5dcf8a7a0 Add dual-boot-linux for CL with other grub-based linux distros. (#884)
* Adds dual-boot tut for CL with other grub-based linux distros.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Change lowercase grub to uppercase in intro.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revise indentation levels of substeps; add new Fig. 12.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Fix trailing space in command.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Create additional indented ordered lists for partition config.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-11-05 17:59:08 -08:00
michael vincerra 32e1b94030 Correct obsolete URL for contribution guidelines. (#897)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-11-05 16:33:38 -08:00
Mary Camp d744224c8e Editorial changes for grammar and formatting. (#892)
* Editorial changes for grammar and formatting.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Added reviewer feedback. Standardized captions.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Fixes nested auto-enumerated list.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-11-01 16:42:21 -07:00
Kevin Putnam 4df2dfdc15 Fixes a problem where nested collapsible sections do not expand correctly. (#887)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-11-01 09:15:05 -07:00
Kevin Putnam 58cba207fa Add Wi-Fi guide (#882)
* First commit.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* update

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Added content for CLI and TUI.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* * Removes unused .png files
* Addresses feedback:
  1. Changed title to leave room for updates include wpa_supplicant.
  2. Minor editorial updates.
  3. Added Other resources section including links to nmcli examples and documentation.
  4. Added note recommending using the TUI if concerned with having password in bash history.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Adds contextual link to bare metal desktop installer in first paragraph.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-10-31 09:35:19 -07:00
R Primus 9095e06aad https://github.com/clearlinux/clear-linux-documentation/issues/857: F… (#885)
* https://github.com/clearlinux/clear-linux-documentation/issues/857: Fix assorted typos

* Update for changes made since initial cloning of repository

* Fix case of word
2019-10-28 16:32:46 -07:00
Kevin Putnam 992a703fbe Fixes a problem caused by there being two ways of indicating reStructuredText code blocks: (#883)
* rst
* rest

Now both are handled gracefully.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-10-28 09:25:57 -07:00
Tom Leavitt fab1ad6f85 Add virt-manager getting started guide (#880)
* Add virt-manager getting started guide

Signed-off-by: Tom Leavitt <thomas.p.leavitt@intel.com>

* Update virt-manager.rst

Signed-off-by: Tom Leavitt <thomas.p.leavitt@intel.com>

* fix link

Signed-off-by: Tom Leavitt <thomas.p.leavitt@intel.com>

* Fix missing downloads link

Signed-off-by: Tom Leavitt <thomas.p.leavitt@intel.com>

* Minor editorial changes for virt-manager

Signed-off-by: Tom Leavitt <thomas.p.leavitt@intel.com>

* Add header back into virt-manager

Signed-off-by: Tom Leavitt <thomas.p.leavitt@intel.com>

* Applies minor edits for transitions and continuity.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-10-25 18:31:05 -07:00
Beth Dean b3ca8be1a5 Clean up DLRS release section (#879)
* Clean up DLRS release section

* added a space after a link.
2019-10-25 09:02:28 -07:00
mns6070 7e74e7b8ca Update nvidia-cuda.rst (#878)
The installation path is set to /opt so the path to test nvcc needs to be updated.
2019-10-25 08:53:52 -07:00
michael vincerra 20af82abd8 Move Manage User to Required options; secure root in bare-metal-install-server (#874)
* Move Manage User to Required options; secure root in bare-metal-install-server.

- Align with clr-installer merged PR: https://github.com/clearlinux/clr-installer/pull/576
- Replace Figures 18-21 to reflect TUI with Admin selected by default
- Renumber all figures after 18 and reassign
- Add note to Manage User re requirement to assign Admin to proceed.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* test new machine settings.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-10-23 19:35:05 -07:00
Mary Camp 1b24b3629f Editorial changes in Hyper-v guide for grammar and formatting. (#871)
* Editorial changes for grammar and formatting.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Closes #774 

* Added reviewer feedback.

Signed-off-by: MCamp859 <maryx.camp@intel.com>
2019-10-18 09:20:13 -07:00
Beth Dean 211e5c1bdd Add tutorial for PHP install & config (#869)
* Add tutorial for PHP install & config

* Add php-fpm configuration detail to php tutorial

* Change bundle name to httpd

* Remove httpd references from php tutorial

* Fix typos, change instructions to active verbs
2019-10-17 14:04:53 -07:00
Tom Leavitt 718e480d71 Update PXE tutorial to add client requirements (#873)
* Update PXE tutorial to add client requirements

Signed-off-by: Tom Leavitt <thomas.p.leavitt@intel.com>

* Additional changes to PXE tutorial

Move client requirements to the top of the prerequisite section
2019-10-17 13:17:15 -07:00
Beth Dean 46a25b42e7 Add examples for Hadoop and Kubernetes (#863)
* Add examples for Hadoop and Kubernetes

* Edits to new content in DARS for readability
2019-10-17 12:11:55 -07:00
michael vincerra 9b13de39be Update compatible version to CL-31130; replace bundles to install in dpdk (#854)
* Update compatible version to CL-31130; replace pkgs:
- Replace network-basic-dev w/ dpdk, devepkg-dpdk
- Revise instances of linuxapp to linux and other commands

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Resolve hyperlink error and preface to install bundles.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Re-add network-basic-dev to Prereqs for bundles in dpdk.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-10-16 08:47:38 -07:00
puneetse 72cca8f019 Update NVIDIA drivers documentation (#850)
* Simpplify headings and download instructions

* Add note about NVIDIA Optimus systems

* Add step to symlink nvidia-settings.desktop

* Add section on brightness control
2019-10-15 17:26:49 -07:00
Beth Dean 2102b71d83 Add kubectl section for basic use case verification (#867) 2019-10-15 17:09:50 -07:00
Kristal Dale 0fcb703eeb Remove AES requirement from Sys Req doc (#859)
Remove AES requirement from the recommended minimum system requirements.
AES has been removed as a hard requirement for installation.

Closes #840

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-10-15 15:37:29 -07:00
BirokratskaZila deb72b741c Update index.rst (#865)
Removed white trailing space and optimized the grammar.
2019-10-15 12:17:29 -07:00
michael vincerra 1688e2241a Revert "Tl telem (#794)" (#861)
This reverts commit 1bc2804b1b.
2019-10-14 12:33:16 -07:00
puneetse a1822e21e8 Update modify container images document (#855)
* Consolidate and update examples

* Bump to 31110

* Be explicit with all docker build parameter names
2019-10-14 11:49:00 -07:00
Kevin Putnam 3fa6558b07 Adds labels for code blocks used in Clear Linux docs (#852)
* Added support for labeling code blocks. Currently supported code blocks:

* yaml
* bash
* console
* reStructuredText
* Python
* PowerShell

Handling added for re-aligning code blocks with line numbers with labels.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Adds the following code block handlers:

* Diff
* C
* json
* spec
* Perl
* PHP
* xml

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-10-11 09:48:33 -07:00
Mary Camp c811324028 Upleveled Contribution guidelines, edited text. (#848)
* Upleveled Contribution guidelines, edited text.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Simplify doc title and sub-bullets under Contrib. guidelines per standup, 10/10/19.
Closed GH-828.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-10-10 18:16:23 -07:00
Tom Leavitt 1bc2804b1b Tl telem (#794)
* update telemetry opt-in requirement

Signed-off-by: Tom Leavitt <30448839+tpleavitt@users.noreply.github.com>

* update telemetry docs for opt-in changes

Signed-off-by: Tom Leavitt <thomas.p.leavitt@intel.com>

* Update telemetry guide

Signed-off-by: Tom Leavitt <thomas.p.leavitt@intel.com>

* telemetry typo and bundle name update

Signed-off-by: Tom Leavitt <thomas.p.leavitt@intel.com>

* Spelling correction line 186

Signed-off-by: DougTW <doug.martin@intel.com>

* Formatting revisions:
-Removed EOL spaces
- broke lines longer than 78 characters
- re-wrapped text as needed

Signed-off-by: DougTW <doug.martin@intel.com>

* Minor editorial changes to telemetrics.rst

Signed-off-by: DougTW <doug.martin@intel.com>
2019-10-10 13:14:48 -07:00
Beth Dean a3f72d407a Remove -version flag from os-install command (#853)
* Remove -version flag from os-install command

* Remove weird whitespace
2019-10-09 14:23:39 -07:00
michael vincerra 59c745abfd Revise bare-metal-install-desktop and -server to allow offline installation. (#851)
- -desktop: Removes Fig. 4; renumbers all subsequent Figures
- -desktop: Revises header to Select Additional Bundles and add note on network
- -server: Adds similar preface as above in Select Additional Bundles
- -server: Adds missing `_` in MOUNT point, Fig. 15.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-10-09 12:50:28 -07:00
Tom Leavitt 2387065e74 typo fix for :command: directive (#849)
Removed the space between the :command: and the text
2019-10-08 14:17:02 -07:00
bktan8 73e5ba9f6f Remove reference to "decompress" in bare metal installer docs. (#847)
- In Preliminary steps, remove penultimate step on verify.
- Verify integrity of image is already included in `bootable-usb`
- If `bootable-usb` is referenced in installation docs, `verify` is implied
- Edits `..-install-server` to make Prelim steps consistent with `..-install-server`

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-10-07 19:48:32 -07:00
Kristal Dale 265469c584 Correct example commands in autoproxy guide (#838)
* Correct example commands in autoproxy guide

- Fix example commands that were split into two snippets (should be one)
- Spelling corrections and minor edits for readability

Fixes #795

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Minor edits to improve clarity with
 output samples.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Add sudo to commands that require it.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-10-07 15:50:32 -07:00
Kevin Putnam 3bbc77a187 Removes Previous/Next buttons on each page of docs. (#846)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-10-07 11:45:04 -07:00
Kristal Dale 6e7c909fef Update 400 http error pages (#844)
- Update paths to search and image to be absolute URLs
- Correct typo in CSS

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-10-07 09:34:54 -07:00
michael vincerra b2e82fe887 Revises scale of figures for better UI XP in dual-boot-win. (#845)
Resizes Fig. 2 for consistency.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-10-07 09:33:34 -07:00
michael vincerra eb5c874627 Adds CL with Windows OS in new dual-boot tutorial & multi-boot index. (#820)
- Adds more details, explanation to Method 1; adds 2 figures.
- Update to using Windows 10 OS throughout
- Add Fig. 3
- Update source/tutorials/multi-boot/multi-boot.rst
- Incorporate Advanced section -- in progress.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-10-04 18:05:35 -07:00
bktan8 cace98df58 Updated bootable USB Linux per https://github.com/clearlinux/clear-li… (#842)
* Updated bootable USB Linux per https://github.com/clearlinux/clear-linux-documentation/issues/796.
Also minor updated the macOS and Windows as well.

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>

* Applies editorial corrections only.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-10-04 17:38:26 -07:00
Kevin Putnam 29d9bd2233 Fixed broken link to dev mailing list. (#843)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-10-04 15:03:45 -07:00
puneetse 7030b996e9 Add a new document for firewall options (#639) 2019-10-04 11:22:49 -07:00
Kevin Putnam 0df6c38203 * Adds ability to create code blocks with prepended "$" that won't be copied (wip). (#837)
* Fixes behavior and appearance of permalinks in collapsible sections.
* Fixes links to collapsible sections so that header is now target.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-10-04 11:12:11 -07:00
Mary Camp fbfe5f43c6 New doc: create custom application container image (#775)
- Add CLI steps to contextualize diff output.
- Add Sphinx roles for clarity of command flags.
- Apply edits for clarity of sequence and prior to output diffs.

<michael.vincerra@intel.com>
2019-10-04 10:46:53 -07:00
Kristal Dale d4529b126b Add custom 404 and 403 pages. (#841)
- Added static html pages for 404 and 403 server responses.
- Added conf.py setting html_extra_path to copy static _errors folder
  with static 404/403 files into build output

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-10-04 09:38:41 -07:00
puneetse 2f0a056995 Add document on firmware (#824)
Adds a new document on firmware laoding and a reference to it from the stateless document.
2019-10-03 07:36:40 -07:00
michael vincerra 8c588b9ac2 Apply wording corrections to to bootable-usb. (#839)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-10-02 18:19:50 -07:00
Sergey Ponomarev 36c8cf81da bootable-usb.rst small improvement (#833)
* Added a note to keep label as `CLR_ISO`

* UDB drive size requirements: make them lower
2019-10-02 18:04:08 -07:00
michael vincerra 6cc03629a3 Remove title case for sample application and fix typo, OpenVINO. (#836)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-10-02 16:03:05 -07:00
michael vincerra a4b24d7f86 Adds OpenVINO tutorial with image classification app and benchmark app. (#830)
- Add example of automobile in Run image classification.
2019-10-02 14:42:47 -07:00
Kevin Putnam d671e584aa Adds youTube video tutorial for autospec to guide page. (#835)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-10-02 13:40:06 -07:00
DougTW fc972821c1 bootable-usb.rst: Editorial changes (#832)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-09-30 22:33:43 +02:00
michael vincerra 7861c356db Add Example 5 for updating an existing package in autospec. (#827)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-27 23:46:32 +02:00
Beth Dean 4707f1d3e4 Add useage examples to DARS guide (#823)
* Add useage examples to DARS guide

* Add detail on docker commands, reference custom-app-container doc

* Back out reference to custom-app-containers.
2019-09-26 22:41:32 +02:00
Kristal Dale 1f82cf1dab Move Parallels tutorial to Get Started (#826)
- Moved tutorial to Get Started virtual install section
- Updated title and intro to be consistent with other get started guides
- Updated reference to 'tutorial' to be 'guide'

Closes #776

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-09-24 16:52:48 -07:00
Beth Dean 6cd5f65b17 Update K8S tutorial for clarity (#825) 2019-09-24 16:01:53 -07:00
claudex d0de8ee64a Replace "sudo echo >" with "echo | sudo tee" (#821)
"sudo echo > " will not work as the current shell will make the redirection and it doen't have the root privileges
2019-09-24 09:52:37 -07:00
Beth Dean 1806ec04dd Add link to benchmark results to DBRS (#819) 2019-09-23 13:46:34 -07:00
Beth Dean 8cf25310af Add link to terms of use (#817)
* Add link to terms of use

* Adds missing * in header below Running DBRS with Cassandra.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-23 11:54:46 -07:00
Beth Dean fa708972f4 Create DBRS guide (#805)
* Create DBRS guide

* guides/stacks/dbrs.rst

* Add new config parameters for K8S section; clean up whitespace.

* Correct link format to Docker image

* Update links and edit for clarity

* Remove duplicate link

* Applies trademarks and simplifies intro para.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-23 08:48:05 -07:00
michael vincerra da2334e3ab In top Makefile, adds venv target to use virtualenv: (#741)
- Contributors may run `make venv` and install requirements.txt without modifying host OS
- Innermost `requirements.txt`, 2 dependencies, moved to uppermost requirements.txt
- Adds `venv` to .gitignore in case contributors/developer forget to remove.
- Reverts source/conf.py to original.
- Replaces python command with python3 in innermost _python/Makefile

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-22 21:06:08 -07:00
grouch0 8c0ad119e7 Update vmw-player.rst (#815)
Text references ESXi instead of Workstation Player though that is the topic.
2019-09-22 20:45:58 -07:00
Daniela Plascencia c04bbed8cb guides/dlrs.rst: updates Kubeflow sections on DLRS guide (#808)
* Removes "Kubeflow multi-node benchmarks" section as the steps there
  reference deprecated methods/code
* Updates TF Benchmarks branch 1.12 --> 1.13 on "TensorFlow single and
  multi-node benchmarks" section

Signed-off-by: Daniela Plascencia <daniela.plascencia@linux.intel.com>
2019-09-20 18:01:49 -07:00
DougTW c1c4e6793f kata migration.rst: Editorial changes (#810)
* Editorial changes for kata-migratios

Signed-off-by: DougTW <doug.martin@intel.com>

* Editorial changes to kata_migration.rst

Signed-off-by: DougTW <doug.martin@intel.com>
2019-09-20 17:48:52 -07:00
michael vincerra 87930e2f2b Adds Example 6 and 7 to show how to remove a bundle and do a format bump. (#770)
- Subdivides prev Example 3 into two:
  - Create an update for the mix
  - Build an image
- Adds subsection Format Bump to explain its purpose and swupd protocols
- Adds Figure 1 and new _figures/mixer dir to illustrate Format Bump
- Modifies some commands to clarify intent, purpose
- Closes #507 

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-20 17:37:22 -07:00
DougTW f3ffba44a1 proxy.rst: Editorial changes (#803)
* Editorial changes to proxy.rst

Signed-off-by: DougTW <doug.martin@intel.com>

* Fixes minor formatting errors.:)

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-20 16:34:17 -07:00
DougTW 0fa7d2bc64 redis.rst: Editorial changes (#797)
* Editorial changes to redis.rst

Signed-off-by: DougTW <doug.martin@intel.com>

* Editorial changes to redis.rts
- fixed space between heading and text

Signed-off-by: DougTW <doug.martin@intel.com>

* Fixes formatting errors for successful build in CI. Simplifies intro.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-20 16:33:56 -07:00
DougTW 5549a0a186 Editorial changes to smb-desktop.rst (#807)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-09-20 16:07:15 -07:00
DougTW 2ec68b4ab1 apache-spark.rst: Editorial and organizational changes (#798)
* Editorial and organizational changes to apache-spark.rst

Signed-off-by: DougTW <doug.martin@intel.com>

* fixed indent alignment changes requested by mvincerx

Signed-off-by: DougTW <doug.martin@intel.com>
2019-09-20 15:50:36 -07:00
michael vincerra 22e1af3d7e Corrects SIMD extensions from 4.1 to 4.2. (#813)
- Closes #809

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-20 15:10:21 -07:00
michael vincerra a2de1ee7ba Removes encryption option in notes, screenshots in bare-metal-install-server (#814)
* Removes encryption option in notes, screenshots in bare-metal-install-server.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Adds notes on use of _F for formatting option.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-20 14:50:31 -07:00
Kevin Putnam 5a041baa1c Updated readme to reflect recent changes and latest doc BKMs. (#737)
* Updated readme to reflect recent changes and latest doc BKMs.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Fixes typo in subheader, Cleaning up.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-19 18:30:26 -07:00
DougTW 6ac6b4812b Editorial changes to smb.rst (#806)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-09-19 08:47:31 -07:00
michael vincerra 565560ee7b Replace Figures 8, 11, new menu name, Advanced Installation, in bare-metal-live-desktop (#802)
* Replace Figures 8, 11 for new menu name: Advanced Installation
- Change from Advanced Disk Config -> Advanced Installation
- Revise word choice in above section for clarity

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Replaces Figure 8 to default with warning.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-17 17:39:53 -07:00
Michael Vincerra 699c4e60a9 Modify to create new development branch with output to developmentHTML
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-17 14:50:46 -07:00
michael vincerra 03943a1774 Adds Advanced Disk Partitioning section with gparted. (#742)
- Add 6 new screenshots to show usding gparted for partitioning
- Add new screenshot for Fig. 8, for updated Select Inst. Media
- Reorder, rename Figures 11-25 to accomodate inclusion of new section

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-17 10:55:44 -07:00
michael vincerra 21ae1da040 bare-metal-install-server: Adds new section on Advanced Installation with cgdisk (#732)
* Adds new section on Advanced Installation with cgdisk.
- Adds new figures 08-16; renumbers subsequent figures
- Makes minor editorial corrections throughout

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Removes note indicating multiple swap partitions possible.
- Per discussion with @mdhorn.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-16 16:30:35 -07:00
DougTW cd0ec7217c apache-hadoop.rst: Editorial changes (#788)
* Editorial changes to apache-hadoop.rst

Signed-off-by: DougTW <doug.martin@intel.com>

* Content organization changes
- Simplified Prerequisites
- Moved sentence out of Prerequisites into Description

Signed-off-by: DougTW <doug.martin@intel.com>
2019-09-16 16:01:40 -07:00
DougTW 72762f1399 Editorial revisions to fmv.rst (#789)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-09-16 15:34:40 -07:00
puneetse bc8907acb0 Update kvm.rst (#784)
- Add tables in place of long lists
- Add emphasize-lines in codeblock
- Add commands for refreshing OVMF files
2019-09-16 10:19:40 -07:00
Beth Dean ee38997188 Fix incorrect image name; update link to benchmark (#791)
Signed-off-by: Beth Dean <beth.e.dean@intel.com>
Closes #767 
Closes #727
2019-09-16 09:24:33 -07:00
DougTW 973cd6a98b Editorial changes to yubikey-u2f.rst (#785)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-09-13 15:54:13 -07:00
DougTW d865735824 azure.rst: Editorial changes (#779)
* Editorial changes to azure.rst

Signed-off-by: DougTW <doug.martin@intel.com>

* Added contents directive to asure.rst

Signed-off-by: DougTW <doug.martin@intel.com>

* Requested revisions to azure.rst
- Reworded introduction paragraph (per mvincerx)
- Removed redundant section references (per mvincerx)
- Reworded Azure portal access paragraph (per mvincerx)
- Removed extraneous "Once complete" from line 302-303 (per mvincerx)

Signed-off-by: DougTW <doug.martin@intel.com>
2019-09-13 15:48:54 -07:00
Kevin Putnam d42d3ab438 Merge pull request #787 from intelkevinputnam/kp-deploy-from-publish
Deploy/Publish from publish branch
2019-09-13 10:47:52 -07:00
Kevin Putnam 69ec80848d Merge pull request #786 from intelkevinputnam/kp-repair-failing-links
Fixes several links that were failing
2019-09-13 10:39:32 -07:00
Kevin Putnam d2717ac3eb Docs will now deploy from publish branch. Master will now be staging to preview changes before going live.
Publishing currently requires 1 manual step:

1. merge/pull master into publish

Previewing on staging requires 1 manual step:

1. hit staging publish URL

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-09-13 10:28:05 -07:00
Kevin Putnam 49efe4f7bc Fixes several links that were failing
* Added one link to whitelist (nvidia downloads)
* Added "/" to download images link
* Updated to swupd update link

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-09-13 10:14:05 -07:00
michael vincerra 79daa13b75 Moves tutorials/dlrs to guides/stacks/dlrs. (#782)
* Moves tutorials/dlrs to guides/stacks/dlrs.
- Revises relative paths of figures
- Adds missing captions for figures 3,4,5

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Closes #752

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-12 09:24:10 -07:00
DougTW f226df0738 Editorial changes to K8s-bp.rst (#781)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-09-11 17:13:40 -07:00
Kristal Dale e5678ec3e5 Merge pull request #777 from krisdale/kd-update-ga-tracking
Updated GA tracking snippet:
2019-09-11 11:47:58 -07:00
DougTW f73fe76cbb Editorial changes to flatpak.rst (#778)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-09-10 16:21:20 -07:00
Kristal Dale 02c4daa41c Updated GA tracking snippet:
- Update to use regex to match hostname for cross domain tracking
- Update to set useAnchor to true
- Update to use https when adding analytics.js

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-09-10 13:52:41 -07:00
Kevin Putnam 040a1b41ce Merge pull request #755 from intelkevinputnam/kp-clr-theme-improvement
UI improvements
2019-09-10 13:29:36 -07:00
m-svo 3537e7e8a6 fixed typo (#763)
Ubuntu 19.04 is non-LTS
2019-09-09 18:01:29 -07:00
michael vincerra 580b2166ec Applies line-edits to clarify macOS commands and process desc. (#743)
- Closes #730

Signed-off-by: Michael Vincerra
<michael.vincerra@intel.com>
2019-09-09 18:00:45 -07:00
puneetse a19948e235 Update clr-boot-manager commands (#740)
Update clr-boot-manager commands to call update before setting kernel and optinally increase the timeout.
2019-09-09 17:56:48 -07:00
puneetse 17e70abdf2 Rewrite Hyper-V document with images (#729) 2019-09-09 17:53:12 -07:00
puneetse bb874bec89 Move guides inside networking section (#726)
* Move static IP document to networking section

* Move customer container document  outside of networking section

* Move NTP document to networking section
2019-09-09 17:12:22 -07:00
Kevin Putnam a20dee18a7 Will now pull chinese content from https://github.com/clearlinux/clear-linux-documentation-zh-CN.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-09-09 16:03:05 -07:00
Kevin Putnam 6902e5319b Merge pull request #773 from intelkevinputnam/kp-add-chinese-language-picker
Added 简体中文 (Simplified Chinese) to language picker.
2019-09-09 14:46:17 -07:00
Kevin Putnam 6d763205d2 Added 简体中文 (Simplified Chinese) to language picker.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-09-09 14:30:50 -07:00
Kevin Putnam 8b19b4b151 Removed compression of zh_CN build.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-09-09 14:15:10 -07:00
Kevin Putnam 1873b3f69e Fixed 2nd typo
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-09-09 14:00:05 -07:00
Kevin Putnam ca25cc647d Fixed typo
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-09-09 13:52:03 -07:00
Kevin Putnam cf59c3486e Merge pull request #772 from intelkevinputnam/kp-deploy-tagged-zh-CN_release_only
Deploy simplified Chinese from tagged release only
2019-09-09 13:43:20 -07:00
Kevin Putnam cc56d56ee9 * Master is now deploying only the latest tagged release of simplified Chinese into /source/_build/html/zh_CN.
* Both Chinese and English are built for error checking purposes only (parallel dirs /source/_build/html and /source/_build/zh_CN).
* Next stage will be to move building of simplified Chinese to https://github.com/clearlinux/clear-linux-documentation-zh-CN only and use latest release from that repo.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-09-09 13:36:27 -07:00
Kevin Putnam 10d1185f9e Merge pull request #750 from intelkevinputnam/kp-add-tagged-release
Stage 1 of back end support for keeping Chinese language content static in rolling release
2019-09-09 13:04:50 -07:00
Kevin Putnam 637f193c3a Merge pull request #771 from terencex-tsang/master
ZHCN Updates from last check
2019-09-06 18:15:42 -07:00
terencex-tsang 34cb3a92de Merge branch 'master' into master 2019-09-06 17:12:14 -07:00
ttsangx 92f2e56bf3 ZHCN Updates from last check 2019-09-06 16:59:09 -07:00
Kevin Putnam 8495797b22 Merge pull request #769 from intelkevinputnam/kp-zh-CN-fix-quick-update-fix-link
Changed link in English docs to enable localized version of link in Chinese language
2019-09-06 12:10:31 -07:00
Kevin Putnam 91df7411ad 1. Changed link to inline and updated in .po for virtualbox-cl-installer
2. Fixed out of date .po files affected by sphinx-intl update required to update link above.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-09-06 12:04:36 -07:00
Kevin Putnam c4f13e3cd6 Merge pull request #768 from terencex-tsang/master
ZHCN Final linguistic fixes
2019-09-06 11:23:46 -07:00
ttsangx 5568654afd ZHCN Final linguistic fixes 2019-09-06 11:02:06 -07:00
Kevin Putnam 1de7a6bfbb Merge pull request #766 from terencex-tsang/master
ZHCN finalizing linguistic fixes
2019-09-05 15:29:04 -07:00
ttsangx 9668814f85 ZHCN finalizing linguistic fixes 2019-09-05 12:24:10 -07:00
Kevin Putnam d673b707b7 Merge pull request #765 from terencex-tsang/master
ZHCN linguistic and link fixes
2019-09-05 07:55:33 -07:00
ttsangx 4fb7f97575 Additional link updates with translations 2019-09-04 17:25:49 -07:00
ttsangx 28f1567213 Asterisk fix 2019-09-04 16:31:34 -07:00
ttsangx 2d70f0ea10 Target po fixes 2019-09-04 16:29:16 -07:00
ttsangx 6cc1688051 ZHCN Linguistic and reference link fixes 2019-09-04 16:15:42 -07:00
Kevin Putnam c631035913 Merge pull request #762 from terencex-tsang/master
ZHCN Linguistic fixing
2019-09-03 18:28:30 -07:00
ttsangx 8b7d2f01b0 Github build validation fix 2019-09-03 17:39:45 -07:00
ttsangx 9ec3816256 ZHCN Linguistic fixing 2019-09-03 17:32:30 -07:00
terencex-tsang 81956eab54 Merge pull request #3 from clearlinux/master
Pull request to merge latest master with fork
2019-09-03 17:27:00 -07:00
michael vincerra 12a9c29a5d Adds missing space in conditional statement in _python/template.html (#761)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-03 10:53:36 -07:00
Mary Camp 3b59eef4a5 Updated Flatpak tutorial with Filezilla examples. (#753)
* Updated Flatpak tutorial with Filezilla examples.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Fixed refs to flatpak in FAQ doc

Closes #481

Signed-off-by: MCamp859 <maryx.camp@intel.com>
2019-08-30 17:51:17 -07:00
Kevin Putnam 7a9c102925 Restores old DRLS content for translation team QA. (#760)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-30 10:52:27 -07:00
michael vincerra 8830c289e9 Add label link to dlrs2 for stacks/guides (#759)
* add label link to dlrs2

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Fix.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-08-30 10:14:58 -07:00
michael vincerra 7e83487235 Adds back dlrs.rst in guides/stacks/ to avoid redirect issues. (#758)
* Replaces dlrs.rst in guides/stacks to avoid redirect issues.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Corrects typo on % for image at 50.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Corrects .. figure:: ref relative path from inside guides/stacks/dlrs

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Corrects relative path in figure 5.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revises label to avoid buld error.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-08-30 10:07:17 -07:00
Kevin Putnam a6d8af9b4e Merge pull request #756 from intelkevinputnam/kp-fix-telemetrics-link
Fix to telemetrics to support Chinese language translation
2019-08-29 17:36:56 -07:00
Kevin Putnam 62e82d3cc5 Had to update .po files.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-29 17:32:59 -07:00
Kevin Putnam b1e039e870 A small change.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-29 17:16:21 -07:00
Kevin Putnam 1605650039 Fixed a warning that was occurring due to a link reference in the English version of the docs. Changed to inline.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-29 17:13:46 -07:00
Kevin Putnam e0eacf0f30 Merge pull request #754 from terencex-tsang/master
ZHCN Linguistic bug fixing
2019-08-29 16:53:51 -07:00
ttsangx 7c6b8e941d ZHCN Build check final fixes stateless.po and telemetrics.po 2019-08-29 16:37:50 -07:00
ttsangx fd2060292b ZHCN Linguistic bug fixes (git fix) 2019-08-29 16:19:40 -07:00
Kevin Putnam 6041602913 UI improvements:
* Changed underline of search box to white from black.
* Added white border to differentiate clearlinux.org nav elements from docs. Limitations:
   * Current solution fails to work 100% in responsive mode.
   * Degradation is graceful.
   * Better fix requires deeper change to the theme.
   * Pending update pulling RTD theme into the project will allow this.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

Changes to be committed:
	modified:   source/_themes/otc_tcs_sphinx_theme/layout.html
	modified:   source/_themes/otc_tcs_sphinx_theme/static/tcs_theme.css
2019-08-29 16:17:02 -07:00
ttsangx 8e66dad187 ZHCN Linguistic bug fixing 2019-08-29 15:56:02 -07:00
michael vincerra 4925650c45 Add code to show status and assign status color-code for available bundles. (#748)
* Add code to show status and assign color-coding to available bundles.
- Add regex PATTERN4 to capture bundle status values
- Add code to process capture groups in for loop
- Rename bundler() to main() to follow Python convention
- Add conditional blocks to filter tags based on below status indicators
- Add css classes for active-status, wip-status, and pending-delete-status
- Closes #747

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Programs "Deprecated" status for such bundles; color-codes it in css.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Adds #ce2029 color for "Deprecated" status to css; reorders css classes.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revises HTML relative link in template.html to tcs_theme.css.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-08-29 13:50:30 -07:00
Beth Dean 17f4c7fab4 Add examples to support DLRS v4 release (#738)
* Add examples to support DLRS v4 release

* Add AIXPRT and PyTorch training examples to DLRS guide

* adds necessary white space before code block

* updates openvino examples

* adds links to referenced scripts

* Move dlrs into tutorials for immediate publication

The dlrs guide and images are moving -- the images into the source/_figures directory, and the dlrs file into tutorials, so they can be immediately published. This change enables partners working with DLRS v4 to continue development.  When possible the dlrs.rst file will be returned to the guides section, and further edits added then.

Signed-off-by: Beth Dean <beth.e.dean@intel.com>
2019-08-29 11:51:12 -07:00
Kristal Dale 5a0144e6ee New tutorial to run CL in Parallels (#749)
This PR replaces PR 605 (including feedback/edits)

- New tutorial with screen shots
- Updated to reflect reorg of docs
- Updated title to reflect updated tutorial nameing convention
- Included feedback on previous PR (that this PR replaces)

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-08-29 11:13:38 -07:00
Kevin Putnam a3e6c8821b Merge pull request #751 from terencex-tsang/master
ZHCN Translation updates
2019-08-28 15:54:29 -07:00
ttsangx 2eac3e7560 ZHCN Fixes 2019-08-28 15:42:49 -07:00
ttsangx 7c97d15551 ZHCN Translation updates 2019-08-28 15:33:36 -07:00
Kevin Putnam a7005f8f34 Part of staged move to making language content static between tagged language releases.
* creates a release consisting of a zipped archive of the html for Chinese language

Stage 2 will build language content but only deploy from the zipped archive.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-28 14:18:00 -07:00
Kevin Putnam bed3874cf3 Restores permalinks for all headers. (#746)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-27 13:16:32 -07:00
Kevin Putnam ec919565e5 Merge pull request #744 from terencex-tsang/master
ZHCN additional translation updates
2019-08-27 08:49:34 -07:00
ttsangx 6e1aab0f20 Git merge fixes 2019-08-26 14:09:21 -07:00
ttsangx 180f1b23fa ZHCN additional translation updates 2019-08-26 13:39:33 -07:00
terencex-tsang 9e1426cc0f Merge pull request #2 from clearlinux/master
Updating from latest Master
2019-08-26 13:30:50 -07:00
puneetse ae915a02fa Add FAQ about vscode (#739)
* Add FAQ about vscode

* Editorial changes.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-26 09:40:16 -07:00
Kevin Putnam 084d7b3468 Added a magnifying glass icon to the search field and changed placeholder text. (#734)
* Adding magnifying glass to search field.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Moved magnifying glass to the left and shifted text to right in search field.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Embedded image in css to avoid sticky path issues.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Reverting to relative path to .css

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-23 20:46:35 +02:00
Kevin Putnam 1b4264113d Added explanatory comments to the script (#735)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-22 18:45:43 +02:00
Kevin Putnam 85b19cbf8e Merge pull request #736 from terencex-tsang/master
Adding translation updates for ZHCN documentation
2019-08-21 16:10:34 -07:00
ttsangx aeae61fbbb RST check reference fixes 2019-08-21 15:38:32 -07:00
ttsangx 40f5bfee74 Adding translations for ZHCN updates 2019-08-21 15:22:15 -07:00
terencex-tsang 340d5ebce5 Merge pull request #1 from clearlinux/master
Merging with latest master
2019-08-21 15:13:00 -07:00
Kevin Putnam 5d27002511 Change to ignore artifacts from creating bundle list content. (#733)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-21 14:19:15 -07:00
michael vincerra d2396a6b4f Bundle lister update (#725)
* Revises to simplify and refine code:
- Removes regex PATTERN4 and 5
- Revises PATTERN3 to exclude comments on custom additions
- Removes pundler() because no longer a clr-bundles directory

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Removes cruft code.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Edit for rebase.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Removes decode() for string in extractor().

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Applies .bundledesc css to <p> tag on includes().

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Modifies html tags in template and styles.css.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-08-14 10:17:20 -07:00
michael vincerra 4c26471624 Update issue templates 2019-08-13 17:15:43 -07:00
michael vincerra 3a6a753a60 Update issue templates 2019-08-13 17:14:40 -07:00
Kevin Putnam 40e05ce150 * Changed Clear Linux Project to all uppercase. (#717)
* Removed link at left of header that went to clearlinux.org
* Added "home" button on right side of header that goes to clearlinux.org

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-12 14:29:43 -07:00
Kevin Putnam 5a87ad722e Fixed CSS problem where a bullet list inside of an admonition was being overlapped by the admonition text. (#718)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-12 11:15:43 -07:00
Kristal Dale 2f0f133386 Merge pull request #722 from krisdale/kd-po-reconcile-org-content
Kd po reconcile org content
2019-08-12 11:01:13 -07:00
Kristal Dale 08438fb919 Minor updates to .po after update in source (bootable usb)
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-08-09 17:29:48 -07:00
Kristal Dale 54aa3297df Refreshed .po files with latest organization and content.
Resolved a handfull of errors in translated content (syntax).

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-08-09 17:21:36 -07:00
Kristal Dale 22f164cb4d Initial commit for .po file reconcile
- remove locale de
- re org zh_CN content to match .rst structure/org

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-08-09 17:21:34 -07:00
Kristal Dale 21f2cd5e6f Merge pull request #721 from krisdale/kd-transl-fix2
Minor edit to bootable-usb to support translations.
2019-08-09 17:20:06 -07:00
Kevin Putnam e04a5b85af Linkcheck takes a while and only needs to happen on deployment, so added to before_deploy. (#720)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-09 17:17:35 -07:00
Kristal Dale c372e8179f Minor edit to bootable-usb to support translations.
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-08-09 17:14:04 -07:00
puneetse 1054aff322 Update kernel-development codeblocks (#716)
Change RPM spec file codeblocks to use the spec pygments formatting, add line numbers, and emphasize important lines.
2019-08-09 15:37:21 -07:00
Kevin Putnam af2324df0e Added trademark disclaimer at the bottom of each page. (#719)
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-09 13:08:23 -07:00
Mary Camp 388228aa6b Edited conf.py to fix copyright statement. (#712)
Signed-off-by: MCamp859 <maryx.camp@intel.com>
2019-08-09 09:55:13 -07:00
puneetse 806748336a Clean up get-started section (#714)
* Clean up get-started section

Renames titles of get-started documents to be concise and consistent. Moves GCE from VM to cloud.

* Replaces include with ref to download-verify-decompress.
- Resolves duplication of Figure 1.
- Declutters guide.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revises header for brevity.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Adds missing URL to correspond to in-text reference to image repo.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-08-09 08:46:07 -07:00
michael vincerra 3b70eb23d5 Corrects swupd search command. (#715)
- Removes `bundle-add`
- Removes [-b] flag; deprecated

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-08-08 20:11:24 -07:00
Kristal Dale a23056d78d Merge pull request #710 from krisdale/kd-remove-redundant-content
Remove redundant content + associated clean up
2019-08-08 15:16:55 -07:00
Kristal Dale 3a18501f30 Minor revisions on wording and spacing.
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-08-08 13:46:02 -07:00
Kevin Putnam badddca2e4 Turned on linkcheck in Travis. (#708)
* Turned on linkcheck in Travis.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Added print lines to parse-link-check.py to improve Travis log output.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-08 09:40:26 -07:00
michael vincerra 3f2ff7321a Applies default css for tables to available bundles. (#711)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-08-07 18:49:13 -07:00
Kristal Dale a8aa87ec9d Remove redundant content + associated clean up
- Remove concepts (content migrated to Clear guides)
- Remove reference for bundle commands (quick ref in swupd guide)
- Moved bundle about page to Clear guide
- Updated links to concepts page, to instead link to the associated guide

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-08-07 16:54:15 -07:00
Kristal Dale 2898310fae Merge pull request #706 from krisdale/kd-transl-fix1
Minor grammatical updates requested in support of upcoming translated content.
2019-08-06 17:25:38 -07:00
Kristal Dale bc2bd3537c Minor grammatical updates requested in support of upcoming translated content.
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-08-06 17:17:57 -07:00
Kristal Dale fbcf9a8b8f Merge pull request #705 from krisdale/kd-minor-migration-text-revisions
Minor revisions as part of transition to new location
2019-08-06 16:06:23 -07:00
Kristal Dale 3c3a1c3757 Minor revisions as part of transition to new location
-Edits to about page (per request)
-Edits to landing page (per request)
-Moved bootable usb out of containing folder (unnecessary)
-Update conf future version name

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-08-06 16:01:05 -07:00
Kevin Putnam 6e701d229e Merge pull request #703 from mvincerx/mv-python-requirements
Upgrades to Jinja2 2.10.1, dependency for bundle_lister.py.
2019-08-06 15:04:56 -07:00
Michael Vincerra 5d716ab1ba Upgrades to Jinja2 2.10.1, dependency for bundle_lister.py.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-08-06 14:19:09 -07:00
Kevin Putnam c12262ebe1 Merge pull request #702 from intelkevinputnam/master
Merge of rtd-theme branch into master
2019-08-06 13:53:21 -07:00
Kevin Putnam 3c339a3ed6 Changed .travis.yml to deploy from master rather than rtd-theme branch.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-06 13:39:16 -07:00
Kevin Putnam ab64d449b3 Merge pull request #701 from intelkevinputnam/rtd-theme
Merge of some content from master and update of Bare Metal Installer URLs
2019-08-06 13:15:09 -07:00
Kevin Putnam e67a9d0c7b Fixed include broken by moving bare metal install docs.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-06 12:23:51 -07:00
Kevin Putnam c1b36ed13b Merge branch 'rtd-theme' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-08-06 12:12:03 -07:00
Kevin Putnam a74cc40fd5 Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-08-06 12:10:59 -07:00
Kevin Putnam c6cf74e087 Fixed URLs for intall docs.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-06 12:10:22 -07:00
Kristal Dale aca6e933bf Merge pull request #700 from krisdale/rtd-theme
Update "Use Cases" to be "Use case tutorials"
2019-08-06 12:05:39 -07:00
Kristal Dale fc2f2ee872 Update "Use Cases" to be "Use case tutorials"
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-08-06 12:00:29 -07:00
Kevin Putnam 9a52aa4866 Merge pull request #695 from intelkevinputnam/rtd-theme
Tutorial rework per issue #688
2019-08-06 11:27:29 -07:00
Kristal Dale 78fb10d4d9 Merge pull request #699 from krisdale/rtd-theme
GA edits for spaces
2019-08-05 16:12:58 -07:00
michael vincerra a8c71632e2 Reorder so EUFI config in VM appears before running clr-installer. (#697)
- Closes #680

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revises header as Install open-vm-tools and intro for context.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-08-05 16:06:09 -07:00
Kristal Dale 564c1de03e GA edits for spaces
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-08-05 16:04:16 -07:00
Kristal Dale 117359b38c Merge pull request #698 from krisdale/rtd-theme
Correction to GA snippet
2019-08-05 15:46:07 -07:00
Kristal Dale 63317e9d43 Correction to GA snippet
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-08-05 15:37:59 -07:00
Kevin Putnam 18497257c8 Added sitemap to gitlab requirements.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-05 15:26:02 -07:00
Kevin Putnam 2fe134912c Added requirement for Sphinx 1.8.0 for gitlab.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-05 15:23:41 -07:00
Kevin Putnam bff6f34e06 Moved images to subdirectories in _figures for easier management.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-05 15:22:28 -07:00
Kevin Putnam 4240513f90 A few more changes to fix alphabetical order in tutorials.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-05 14:53:10 -07:00
Kristal Dale 0c90ae98b7 Merge pull request #696 from krisdale/rtd-theme
Added updated GA tracking snippet (cross-domain) and enabled canonical tag in config.
2019-08-05 14:41:10 -07:00
Kristal Dale ae818da5d8 Added canonical tag configuration to config file.
Added GA tracking snippet (cross-domain) to layout template.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-08-05 14:28:00 -07:00
Kevin Putnam dda2e0a3bb Improved tutorials organization based on feedback. Added favicon to the project.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-05 14:04:16 -07:00
Kristal Dale 8ed9b2ddfb Merge branch 'rtd-theme' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-08-05 13:34:43 -07:00
Kevin Putnam a3afa314d1 Reworked tutorial section and moved cloud install content to get started section.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-05 13:16:05 -07:00
Kevin Putnam 4129d8a584 Merge branch 'rtd-theme' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-08-05 12:03:51 -07:00
Kevin Putnam 759dd0b01a Removed specific references to Chinese and L19.01 in version picker.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-05 12:02:52 -07:00
Kevin Putnam 82a8d7aaa5 Merge branch 'development' of github.com:clearlinux/clear-linux-documentation into development 2019-08-05 11:38:34 -07:00
Kevin Putnam 1df1cd7aec Merge branch 'rtd-theme' into development 2019-08-05 11:35:07 -07:00
Kristal Dale a55b3bf9fd Merge pull request #693 from terencex-tsang/rtd-theme-l10n
ZHCN Translation updates
2019-08-05 10:58:11 -07:00
Kevin Putnam 7773245d4a Merge branch 'rtd-theme' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-08-05 09:45:57 -07:00
Kevin Putnam 346bcedd83 Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-08-05 09:44:29 -07:00
ttsangx 85a24f7e42 Inconsistent reference checks fixes 2019-08-02 17:40:22 -07:00
Kristal Dale 120591233d Merge pull request #694 from krisdale/development
About page edits
2019-08-02 17:10:18 -07:00
ttsangx ceb242d095 Github checks fixes 2019-08-02 17:03:14 -07:00
Kristal Dale 352cfc5614 Revisions to new about page. Added section link to guides index, for
reference from about page.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-08-02 16:43:17 -07:00
ttsangx 6cf3c3eb35 More translation updates for Guides and linguistic fixes for other sections 2019-08-02 16:40:18 -07:00
Kevin Putnam 0860c695cc Merge pull request #685 from krisdale/rtd-theme
Add requirement and config for sphinx-sitemap
2019-08-02 16:38:30 -07:00
michael vincerra 075cb99837 Adds cloud-native-setup in related topics; corrects link. (#691)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Adds sentence ref to cloud-native-setup in Desc.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-08-02 16:24:36 -07:00
Kristal Dale 55e1eacc1b Merge pull request #692 from krisdale/development
Update landing page text for clarity per request.
2019-08-02 15:42:23 -07:00
Kristal Dale c8d0ba28f0 Update landing page text for clarity per request.
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-08-02 15:34:53 -07:00
Kristal Dale 62a845e73a Merge branch 'rtd-theme' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-08-02 14:06:57 -07:00
DougTW 25819fccd9 machine-learning.rst: minor editorial changes (#674)
* Incremental commit 1: minor editorial revisons.

Signed-off-by: DougTW <doug.martin@intel.com>

* machine-learning.rst: Minor editorial changes.

Signed-off-by: DougTW <doug.martin@intel.com>

* Applies :command: directive for bundles and capitalizes Figures.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-08-02 13:23:03 -07:00
Kevin Putnam ef133322bd Merge branch 'rtd-theme' into development
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-01 16:57:12 -07:00
Kevin Putnam b1a8266c35 Merge branch 'rtd-theme' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-08-01 15:59:22 -07:00
Kevin Putnam e16ffe2f9b Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-08-01 15:59:06 -07:00
Mary Camp c9fbbdc4de Changes per Issue 664: moved topic, edited text (#677)
Signed-off-by: MCamp859 <maryx.camp@intel.com>
2019-08-01 11:12:45 -07:00
Kristal Dale c24e785a6b Add requirement and config for sphinx-sitemap
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-07-31 16:42:09 -07:00
Kevin Putnam 78d86d4428 Merge pull request #683 from terencex-tsang/rtd-theme-l10n
Linguistic fixes for Get Started documentation
2019-07-31 16:38:08 -07:00
Kevin Putnam bca539523d Fixed toctree error.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-31 14:30:00 -07:00
DougTW 21bf11a7dc Minor editorial and trademark changes: (#681)
* Capitalization of Figure references
* Word choices
* Trademark notation for Amazon Web Services

Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-31 14:27:55 -07:00
Kevin Putnam d9f3ac31ad Changed reference and tutorial landing pages to index to improve URLs.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-31 14:26:17 -07:00
Kevin Putnam 1a0d6ff7ee Renamed landing page for clear linux tooling.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-31 14:06:59 -07:00
Kevin Putnam ef4c06cd61 Changed landing pages names from dir name to index to improve URLs.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-31 13:57:58 -07:00
Kevin Putnam 91898e45b0 Merge branch 'rtd-theme' into development 2019-07-31 13:43:44 -07:00
ttsangx fa7e7f5ef3 Updates to spacing 2019-07-31 12:34:08 -07:00
ttsangx 08bca6db10 Linguistic fixes for Get Started documentation 2019-07-31 12:25:17 -07:00
Kevin Putnam 3a3c8e0854 Merge branch 'rtd-theme' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-07-31 11:25:00 -07:00
Kevin Putnam a542c66b40 Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-07-31 11:24:20 -07:00
DougTW 270850a51e Minor editorial revisions. (#678)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-31 10:42:50 -07:00
Kevin Putnam aa0f12673d First draft of about page.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-30 16:56:29 -07:00
Kristal Dale 612b95344b Merge pull request #676 from terencex-tsang/rtd-theme-l10n
Translation updates for Tooling section
2019-07-30 14:02:36 -07:00
ttsangx 48e9c206a5 Fixed spacing issues detected 2019-07-30 13:16:23 -07:00
Kevin Putnam 2d4254721f Merge branch 'rtd-theme' into development 2019-07-30 12:04:42 -07:00
Kevin Putnam 2b161b0ac3 Moved content to new tutorial location.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-30 12:02:03 -07:00
Kevin Putnam a629e92459 Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-07-30 11:22:03 -07:00
ttsangx ede9062664 Translation updates for Tooling section 2019-07-29 18:04:34 -07:00
DougTW 3d7e832023 Minor editorial revisions. (#675)
* Added TOC after opening sentence
* Added Description heading
* Moved remaining description under Description

Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-29 17:40:57 -07:00
puneetse 143449c77c Update cpu-performance.rst (#673)
Combine systemctl enable and start commands with a single  systemctl enable --now command.
2019-07-29 16:17:57 -07:00
puneetse f9ae43dbc6 Add document on installing NVIDIA CUDA Toolkit (#611)
* Add new tutorial for installing NVIDIA CUDA

Add new tutorial for installing the NVIDIA CUDA toolkit.

* Update nvidia-cuda title
2019-07-29 16:11:52 -07:00
Kevin Putnam 14179cf8ca Fixed include error in kernel-development.rst and added development branch rule to .travis.yml.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-29 14:15:33 -07:00
Kevin Putnam ac7d52e512 Create about page and move Clear Linux specific content to guides/clear.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-29 12:51:04 -07:00
Kevin Putnam 23f595c4d6 Fixed typo on top level landing page.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-29 10:42:59 -07:00
Kevin Putnam 563f4e598f print output of hitting publish url to log
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-29 09:33:56 -07:00
Kevin Putnam 15c5bb355e moved resource-limits.rst to new location.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-26 16:01:04 -07:00
Kevin Putnam 369271ed81 Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-07-26 15:58:28 -07:00
Kevin Putnam b8d2f88a67 Changed sphinx requirement to 1.8. Added error on warning to htmlall make rule.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-26 15:52:17 -07:00
DougTW 88977e0bef Minor editorial and formatting changes. (#668)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-26 14:38:44 -07:00
puneetse 2ce50349a0 Add document on resource limits (#662)
* Update from upstream (#15)

* Add section for kubectl to dlrs tutorial (#550)

* Add section for kubectl to dlrs tutorial

* Editorial clean up to Kubectl section.

* Minor grammatical edits: missing punctuation and line length clean up.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Dm autospec guide editorial (#565)

* Edited for syntax, spelling, trademarking, and branding.

Signed-off-by: douglasm <doug.martin@intel.com>

* Made editorial revisions, e.g., grammar and spelling.

Signed-off-by: douglasm <doug.martin@intel.com>

* changed one phrase to use active voice present tense. Reset autoproxy.rst.

Signed-off-by: douglasm <doug.martin@intel.com>

* Add document on debug system (#561)

* Add stateless concept document (#564)

* Changed ister.rst for trademarks, branding, and editorial issues. (#573)

* Minor editorial revision to test multiple commits on one file.

Signed-off-by: douglasm <doug.martin@intel.com>

* Minor editorial revisions completes my revisions to this file.

Signed-off-by: douglasm <doug.martin@intel.com>

* Add a FAQ page (#547)

* Add a new FAQ document

* Clerical changes to faq doc

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Add note about AUTOINSTALL=yes in dkms.conf (#575)

* Add link for launcher.py and note MKL HW reqs for DLRS tutorial. (#570)

* Add link for launcher.py and note MKL HW reqs for DLRS tutorial.

* Reword note about MKL, change from note to warning.  Closes #560, Closes #559

* Add note specifying Kubeflow v0.4 when using launcher.py
* Closes #559 , Closes #560

* Update assign static IP doc to have NM instructions (#574)

* minor editorial changes; edits complete. (#580)

Signed-off-by: DougTW <doug.martin@intel.com>

* Update NVIDIA documentation to isolate install even further (#586)

* Add updating section to NVIDIA  doc

* Isolate NVIDIA files under /opt and /etc even more

Adds more parameters to avoid nvidia-installer placing files under /usr and have applications use alternative paths.

* Explicitly add warning about libGL.so conflict

Add a warning about the well-know libGL conflict between mesa and NVIDIA packages.

* Update nvidia.rst

* Add a step restart NetworkManager in static IP doc (#584)

* Update assign static IP doc to have NM instructions

* Add step to restart NetworkManager

* Adds note to clarify BIOS behavior if installing on multiple partitions. (#582)

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Rewording revisions.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Incorporates reviewer feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Editorial change.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Fix minor syntax on nvidia.rst (#594)

* Minor editorial changes to swupd-guide.rst. (#591)

Signed-off-by: DougTW <doug.martin@intel.com>

* q

* Retested QEMU-KVM doc. against latest Clear and 3rd-party distros.
Updated doc. to reflect any changes.

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>

* Added reviewer comments.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Add link to terms of use in the dlrs tutorial (#596)

* Added FAQ to sitemap and shortened FAQ title text to "FAQ." (#600)

Closes #599 
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* mixer.rst: editorial changes (#585)

* Editorial, spelling, and formatting changes only.

Signed-off-by: DougTW <doug.martin@intel.com>

* Fixed indentation error on mixer.rst

Signed-off-by: DougTW <doug.martin@intel.com>

* Add a note about running stack on other Linux distros (#598)

* Add a note about running stack on other Linux distros

* Add unistall instructions

* Replaces telemetry figure with clr-installer 2.0.8 version, live-desktop. (#597)

* Update telemetry figure per Engineering to reflect clr-installer 2.0.8.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revise instruction to match new GUI.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revise wording of step to match new GUI.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Replaces telemetry figure per Engineering for clr-installer 2.0.8. (#595)

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revises Figure 16, telemetry, to remove installer version.
- Closes #590 to address non-UEFI USB entry in BIOS during install

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Closes #590.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* NVIDIA; Trademark, branding, and editorial changes (#601)

* Minor editorial and trademark/branding changes.

Signed-off-by: DougTW <doug.martin@intel.com>

* Fixed file directive. Made grammatical change suggested by puneetse.

Signed-off-by: DougTW <doug.martin@intel.com>

* Fixed heading markup requested by mvincerx.

Signed-off-by: DougTW <doug.martin@intel.com>

* Corrects Step 4 command to verify integrity. (#602)

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Add section on settign a static machine id. (#606)

- Closes #558.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revises bare-metal-install-desktop fig 3 to clarify installer icon. (#603)

* Revises bare-metal-install-desktop to clarify installer icon.
- Closes #577

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revisions to "Launch the installer" text.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Update system requirements documentation (#589)

Update to include installer requirements section calling out higher needs for live desktop installer.

Over all revision of document and formatting.

* Fix error in sequence of figures, live-desktop. (#613)

- repetition of Fig 3. and Fig. 4

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Fixed cross-ref in bare-metal-install-server.rst to autoproxy (#617)

Signed-off-by: DougTW <doug.martin@intel.com>

* Fixed cross-ref and made minor formatting and editorial changes. (#619)

Signed-off-by: DougTW <doug.martin@intel.com>

* Get Started section link clean up (#618)

* Link clean up

Basic link clean up in advance of translation of content.
- Removed unused links
- Updated links defined as named refs to use simple text e.g. name of linked content
instead of narrative text.
- Minor text edits to accomodate minor changes to name ref links.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Fix typo from first commit.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Tooling link clean up (#620)

Basic link clean up in advance of translation of content.

- Removed unused links
- Updated links defined as named refs to use simple text e.g. name of linked content
instead of narrative text.
- Minor text edits to accomodate minor changes to name ref links.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* New guide: how to install using config file (#568)

* New guide: how to install using config file

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* New guide: how to install using config file.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Added line numbers, minor text edits

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Incorporated review feedback.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Adding more feedback.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* More text changes per reviewer feedback.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Add reviewer feedback.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Completed more text edits.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Adding latest feedback.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Update fmv.rst (#616)

* Update fmv.rst

Fix FFT typo in section header

* Update fmv.rst

Updates explaining that FFTW is an FFT library

* Add link for terms of use.  Closes #622 (#623)

* Corrected trademarks use on system-requirements (#624)

Closes #610 
Signed-off-by: DougTW <doug.martin@intel.com>

* Maintenance Guides: Basic link clean up in advance of translation of content (#625)

* Basic link clean up in advance of translation of content

- Remove unused links
- Updated links  defined as named refs to use simple text e.g. name of linked content
instead of narrative text
- Minor edits to accomodate minor changes to name of ref links

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Update links according to feedback on PR.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Update link according to feedback on PR.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Maintenance Guides: Basic link clean up in advance of translation of content (#625) (#609)

* Basic link clean up in advance of translation of content

- Remove unused links
- Updated links  defined as named refs to use simple text e.g. name of linked content
instead of narrative text
- Minor edits to accomodate minor changes to name of ref links

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Update links according to feedback on PR.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Update link according to feedback on PR.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Adds new figures for live-desktop, checking prerequisites, kernel options.

- Ref: https://github.com/clearlinux/clr-installer/issues/406
- Ref: https://github.com/clearlinux/clr-installer/issues/384

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Re-orders all figures; adds new section, advanced config as placeholder.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Re-scopes PR to include only checking prereqs, kernel update, and software update.
- Three new screenshots/figures

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Adds edits to bare-metal-install-desktop.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revise wording for Proxy configuration per new Network Manager.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Cleans up in-text reference to reordered figures.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Squash commit fake.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Get Started cleanup for translation (#630)

* Basic clean up and standardization of intro in preparation for translation.

- Simplify sentences.
- Remove idiomatic phrases.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Additional minor edits to simplify sentence/word choice for translation.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Removed section "Kernel Container" from compatible-kernels.rst as
Clear Containers are now deprecated and bundle no longer exists.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Clean up of syntax around gui elements in preparation for translation. (#636)

- Items clearly referring to an element in a GUI (e.g. buttons, menus,
areas in GUI/screen) updated to use :guilabel: or :menuselection: as
apprpriate.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* kernel-modules: revised link to mixer.rst and minor editorial changes (#629)

* revised link to mixer.rst and minor editorial changes

Signed-off-by: DougTW <doug.martin@intel.com>

* Restore change by @DougTW

* Telemetry guide: made editorial, formatting, and spelling revisions. (#615)

* Editorial revisions to telem-guide.rst.

Signed-off-by: DougTW <doug.martin@intel.com>

* Telem-guide: completed sphinx formatting revisions requested by mvincerx

Signed-off-by: DougTW <doug.martin@intel.com>

* Final edits to headers and removing spaces.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Docker.rst. Removed broken link and corrected trademark errors. (#627)

* Removed broken link and corrected trademark errors.

Signed-off-by: DougTW <doug.martin@intel.com>

* Resolve build error due to missing char on header.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Fixed broken link in kernel-modules-dkms.rst. (#632)

- Resolved merge conflicts.

Signed-off-by: DougTW <doug.martin@intel.com>

Clean-up and testing to resolve conflicts.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Fixed broken link to stateless.rst. Made minor editorial and trademark/branding revisions. (#633)

Signed-off-by: DougTW <doug.martin@intel.com>

* Revised link to stateless.rst, formatting, and trademarks. (#634)

Signed-off-by: DougTW <doug.martin@intel.com>

* Revised link to stateless.rst and added trademarks. (#635)

Signed-off-by: DougTW <doug.martin@intel.com>

* Text edits in prep for xlation. (#640)

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Add documentation on resource limits

* Revise Table 1 to clarify labels, filesystem, and default verbiage. (#647)

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Merged download, verify, and decompress instructions (#645)

* Merged Linux, Mac, Windows instructions for download, verify, decompress CL image.
- closes #631

Signed-off-by: DougTW <doug.martin@intel.com>

* Added TOC, revised hierarchy of steps and headings.

Signed-off-by: DougTW <doug.martin@intel.com>

* Revised heading hierarchy...again...

Signed-off-by: DougTW <doug.martin@intel.com>

* Simplified headings to improve TOC and translation effort.

Signed-off-by: DougTW <doug.martin@intel.com>

* Added ref to Clear Linux OS image types file.

Signed-off-by: DougTW <doug.martin@intel.com>

* Resets starting point for include; rewrites intro; fixes errors.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Update VMWare installation guide (#626)

* Update VMWare installation guide

Cleanup to respond to review.

Refresh VMware Player images and refactor UEFI section

Clean up installer download instructions.

Add note regarding open-vm-tools

Adds note re downloaded latest version, possibly different commands.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revise sentence 2 for copyright usage.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Resolves conflicts. Aha!

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revise Table 1 to clarify labels, filesystem, and default verbiage. (#646)

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* New guide: how to query upstream CL repo (#637)

Signed-off-by: MCamp859 <maryx.camp@intel.com>

Added feeback and TOC sections.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

Revise formatting for conformity to Sphinx syntax.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Edits to code-block console output for alignment.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Moves stacks from tutorials to guides. (#644)

- Modifies guides.rst to add stacks subdir
- Replaces all internal refernces in docs from tutorials to guides
- Cleans up cruft left from merge conflict on kernel-modules-dkms.rst

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Closes #579

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revise for rebase updates.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Initial commit for maintenance guides clean up (preparation for translation) (#648)

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Initial commit of cleanup for translations (maintenance guides)

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Clean up in preparation for translations

- Standardize page formatting (use of intro sentence, TOC tree, etc)
- Simplify intro sentences, remove idioms, etc
- Standardize use of roles (remove use of `` and * for emphasis on special words or options)
- Misc clean up (opportunistic)

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Update per requested changes on PR.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Edits per requested changes on PR from @mvincerx

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Initial commit for translation clean up (network and telemetry guides) (#650)

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Clean up in preparation for translations …

- Standardize page formatting (use of intro sentence, TOC tree, etc)
- Simplify intro sentences, remove idioms, etc
- Standardize use of roles (remove use of `` and * for emphasis on special words or options)
- Misc clean up (opportunistic)

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Updates per requested changes on PR.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Minor revision to use :file: for directories referenced in deploy-at-scale.rst

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Minor clean-up on network-related files.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* vmw-player.rst: replaced links to download-verify-decompress. (#653)

* Replaced include with ref.

Signed-off-by: DougTW <doug.martin@intel.com>

* Reworded paragraph and linking text.

Signed-off-by: DougTW <doug.martin@intel.com>

* Reworded paragraph and linking text (#655)

Signed-off-by: DougTW <doug.martin@intel.com>

* Replaced include with ref. (#656)

* Reworded paragraph and linking text.

Signed-off-by: DougTW <doug.martin@intel.com>

* Clean up of last 2 tooling pages in preparation for translations (#651)

* Clean up in preparation for translations

- Standardize use of roles (remove use of `` and * for emphasis on special words or options)
- Misc clean up (opportunistic)
- Move pages to tooling in prep for final organization

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Fixes code-block errors; minor verbiage clean up.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Minor clean up in preparation for translation. (#652)

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Updated note re Software store.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Adds link to download, verify, etc.; revise desktop intro for accuracy.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Minor editorial revisions. (#657)

* Checked trademark/branding

Signed-off-by: DougTW <doug.martin@intel.com>

* mixer: Adds bullet list in format bump; adds Example 3 for editors. (#659)

* Adds bullet list in format bump; adds Example 3 for editors.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revise Editors example per reviewer feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revise to integrate form Ex. 4 into Ex. 2.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Integrates how to edit bundle editors in Ex. 2 and Ex. 3.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Respond to feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Stacks guide cleanup for translation (#660)

* Initial commit for stacks guides cleanup (prep for translation)

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Basic clean up in preparation for translation
- Links/wording of links
- Simplify intro/overview

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Escaped local URLs that were being turned into links.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* docs: Missing spaces after '.'s (#658)

A `grep '\.[A-Z]'` showed up a few places where there was a space
missing after a full stop.
Initiall spotted reading the 'stateless' guide.
A similar grep for missing spaces after commas turned up nothing.

Signed-off-by: Graham Whaley <graham.whaley@intel.com>

* Minor formatting changes to swupd-guide.rst (#666)

Fixes #665

Signed-off-by: DougTW <doug.martin@intel.com>

Fixed indents of Output.

Signed-off-by: DougTW <doug.martin@intel.com>

Removed trailing space.

Signed-off-by: DougTW <doug.martin@intel.com>

* Update resource-limits.rst

Expand out commands into codeblocks as requested in review.
2019-07-26 14:32:59 -07:00
Kevin Putnam 998834a6d0 Merge pull request #669 from terencex-tsang/rtd-theme-l10n
Fixed issue with missing spaces after inline markup
2019-07-26 14:21:00 -07:00
DougTW 5a54484080 Minor formatting changes to swupd-guide.rst (#666)
Fixes #665

Signed-off-by: DougTW <doug.martin@intel.com>

Fixed indents of Output.

Signed-off-by: DougTW <doug.martin@intel.com>

Removed trailing space.

Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-26 12:21:38 -07:00
ttsangx 67d92173f2 Fixed issue with missing spaces after inline markup 2019-07-26 11:25:52 -07:00
Kevin Putnam fabf2ad1db Added ping of publish URL and temp usage of collapsing sitenav nodes.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-25 16:08:59 -07:00
Kristal Dale 91637d6480 Merge pull request #667 from terencex-tsang/rtd-theme-l10n
First batch of translations.
2019-07-25 15:40:21 -07:00
ttsangx c46b5479e5 Added translations for initial batch of Get Started and updated content 2019-07-25 14:18:52 -07:00
Kevin Putnam 8f958b598a Added /latest to top level URL for versions and languages switcher to reflect current hierarchy.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-25 12:12:37 -07:00
Kevin Putnam 6144c129f1 Removed unecessary langauges and LTS versions. Added .mo files to .gitignore.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-24 15:24:16 -07:00
Kevin Putnam 81f0bd5989 Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-07-24 11:12:09 -07:00
Kevin Putnam 5eea10305c Merge pull request #663 from intelkevinputnam/kp-fix-bulkprovision
Escaped local URLs that were being turned into links.
2019-07-24 11:11:48 -07:00
Kevin Putnam 34711e6266 Added items to white list.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-24 11:11:21 -07:00
Graham Whaley 3b29da1296 docs: Missing spaces after '.'s (#658)
A `grep '\.[A-Z]'` showed up a few places where there was a space
missing after a full stop.
Initiall spotted reading the 'stateless' guide.
A similar grep for missing spaces after commas turned up nothing.

Signed-off-by: Graham Whaley <graham.whaley@intel.com>
2019-07-23 14:13:07 -07:00
Kevin Putnam f5dc0bf2e7 Escaped local URLs that were being turned into links.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-23 13:46:08 -07:00
Kevin Putnam 01cb09e442 Updated Makefile and Travis build instructions to deploy Chinese and to latestHTML branch.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-23 12:44:18 -07:00
Kevin Putnam ca6c769fee Merge branch 'rtd-theme' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-07-23 09:40:14 -07:00
Kevin Putnam 83fea39d7c Removed German build as gitlab complained about too many artifacts.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-22 14:17:14 -07:00
Kevin Putnam e36c86ed7e Small change to theme and added build of Chinese language version.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-22 14:10:10 -07:00
Kristal Dale 11b3063363 Merge pull request #661 from krisdale/rtd-theme
Updated .po files for translation.
2019-07-22 13:44:42 -07:00
Kristal Dale 50a4b83318 Updated .po files for translation.
Includes updated/refreshed guides (maintenance, network, tooling, stacks)
and remaining Get Started pages:
- Clean up and standardization of intro
- Clean up of links
- Standardization of layout

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-07-22 13:13:22 -07:00
Kevin Putnam a71d9e1f5f Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-07-22 12:09:39 -07:00
Kristal Dale 68cc5899ad Stacks guide cleanup for translation (#660)
* Initial commit for stacks guides cleanup (prep for translation)

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Basic clean up in preparation for translation
- Links/wording of links
- Simplify intro/overview

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-07-22 12:07:39 -07:00
michael vincerra 9cad7aa2dd mixer: Adds bullet list in format bump; adds Example 3 for editors. (#659)
* Adds bullet list in format bump; adds Example 3 for editors.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revise Editors example per reviewer feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revise to integrate form Ex. 4 into Ex. 2.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Integrates how to edit bundle editors in Ex. 2 and Ex. 3.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Respond to feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-22 11:59:02 -07:00
Kevin Putnam 26299677c1 Merge branch 'rtd-theme' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-07-22 11:58:17 -07:00
Kevin Putnam 69378a5408 Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-22 11:53:11 -07:00
DougTW 2cf769511e Minor editorial revisions. (#657)
* Checked trademark/branding

Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-22 10:20:17 -07:00
Kristal Dale 5ba7b9e356 Minor clean up in preparation for translation. (#652)
Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Updated note re Software store.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Adds link to download, verify, etc.; revise desktop intro for accuracy.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-20 21:39:44 -07:00
Kristal Dale b2566c9be0 Clean up of last 2 tooling pages in preparation for translations (#651)
* Clean up in preparation for translations

- Standardize use of roles (remove use of `` and * for emphasis on special words or options)
- Misc clean up (opportunistic)
- Move pages to tooling in prep for final organization

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Fixes code-block errors; minor verbiage clean up.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-20 20:27:25 -07:00
DougTW 551ab83221 Replaced include with ref. (#656)
* Reworded paragraph and linking text.

Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-20 19:57:54 -07:00
DougTW 2a6a91d68b Reworded paragraph and linking text (#655)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-20 19:52:45 -07:00
DougTW e39019c016 Replaced include with ref. (#654)
* Reworded paragraph and linking text.

Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-20 19:49:22 -07:00
DougTW 61620b4b6a vmw-player.rst: replaced links to download-verify-decompress. (#653)
* Replaced include with ref.

Signed-off-by: DougTW <doug.martin@intel.com>

* Reworded paragraph and linking text.

Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-19 18:41:06 -07:00
Kristal Dale 687aa3abcc Initial commit for translation clean up (network and telemetry guides) (#650)
Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Clean up in preparation for translations …

- Standardize page formatting (use of intro sentence, TOC tree, etc)
- Simplify intro sentences, remove idioms, etc
- Standardize use of roles (remove use of `` and * for emphasis on special words or options)
- Misc clean up (opportunistic)

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Updates per requested changes on PR.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Minor revision to use :file: for directories referenced in deploy-at-scale.rst

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Minor clean-up on network-related files.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-19 18:40:27 -07:00
Kristal Dale b9e5806856 Initial commit for maintenance guides clean up (preparation for translation) (#648)
Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Initial commit of cleanup for translations (maintenance guides)

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Clean up in preparation for translations

- Standardize page formatting (use of intro sentence, TOC tree, etc)
- Simplify intro sentences, remove idioms, etc
- Standardize use of roles (remove use of `` and * for emphasis on special words or options)
- Misc clean up (opportunistic)

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Update per requested changes on PR.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Edits per requested changes on PR from @mvincerx

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-07-19 18:15:45 -07:00
michael vincerra 5ab6383d6d Moves stacks from tutorials to guides. (#644)
- Modifies guides.rst to add stacks subdir
- Replaces all internal refernces in docs from tutorials to guides
- Cleans up cruft left from merge conflict on kernel-modules-dkms.rst

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Closes #579

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revise for rebase updates.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-19 15:02:22 -07:00
Mary Camp 67907a111d New guide: how to query upstream CL repo (#637)
Signed-off-by: MCamp859 <maryx.camp@intel.com>

Added feeback and TOC sections.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

Revise formatting for conformity to Sphinx syntax.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Edits to code-block console output for alignment.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-19 14:50:34 -07:00
michael vincerra bfa5831d8a Revise Table 1 to clarify labels, filesystem, and default verbiage. (#646)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-19 14:00:44 -07:00
Beth Dean 55afe3a126 Update VMWare installation guide (#626)
* Update VMWare installation guide

Cleanup to respond to review.

Refresh VMware Player images and refactor UEFI section

Clean up installer download instructions.

Add note regarding open-vm-tools

Adds note re downloaded latest version, possibly different commands.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revise sentence 2 for copyright usage.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Resolves conflicts. Aha!

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-19 13:53:35 -07:00
Kevin Putnam 33fb4ca67d Merge pull request #649 from intelkevinputnam/rtd-theme
Merge of latest content into rtd-theme
2019-07-19 10:27:15 -07:00
Kevin Putnam 965c26870d Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-19 10:19:51 -07:00
DougTW d9a53a1266 Merged download, verify, and decompress instructions (#645)
* Merged Linux, Mac, Windows instructions for download, verify, decompress CL image.
- closes #631

Signed-off-by: DougTW <doug.martin@intel.com>

* Added TOC, revised hierarchy of steps and headings.

Signed-off-by: DougTW <doug.martin@intel.com>

* Revised heading hierarchy...again...

Signed-off-by: DougTW <doug.martin@intel.com>

* Simplified headings to improve TOC and translation effort.

Signed-off-by: DougTW <doug.martin@intel.com>

* Added ref to Clear Linux OS image types file.

Signed-off-by: DougTW <doug.martin@intel.com>

* Resets starting point for include; rewrites intro; fixes errors.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-18 17:37:56 -07:00
michael vincerra 2860bccbf0 Revise Table 1 to clarify labels, filesystem, and default verbiage. (#647)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-18 16:24:48 -07:00
Kevin Putnam 76d47aa32b Merge pull request #643 from intelkevinputnam/rtd-theme
Removed deprecated Kernel Containers from list of compatible containers
2019-07-18 11:34:12 -07:00
Kevin Putnam 5c2d268188 Merge branch 'rtd-theme' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-07-18 11:26:20 -07:00
Kevin Putnam 1f9b05f54a Merge pull request #641 from krisdale/rtd-theme
Update tooling landing page with how-to-clear training
2019-07-18 11:25:58 -07:00
Kevin Putnam 34ea6681cb Removed kernel containers from list of compatible kernels
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-18 11:20:50 -07:00
Kristal Dale a5ca3d3744 Update tooling landing page to include reference to and summary of
the how-to-clear training. Remove how-to-clear overview in preference
of the overview on tooling page.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-07-17 17:23:40 -07:00
Mary Camp cac1634962 Text edits in prep for xlation. (#640)
Signed-off-by: MCamp859 <maryx.camp@intel.com>
2019-07-17 15:54:04 -07:00
DougTW c91bd2357e Revised link to stateless.rst and added trademarks. (#635)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-17 15:47:35 -07:00
DougTW 1abe189da3 Revised link to stateless.rst, formatting, and trademarks. (#634)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-17 15:42:20 -07:00
DougTW 59c0f13160 Fixed broken link to stateless.rst. Made minor editorial and trademark/branding revisions. (#633)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-17 15:38:32 -07:00
Kristal Dale fedf4fd743 Merge pull request #638 from krisdale/rtd-theme
Update .po files with latest edits for Get Started section.
2019-07-17 11:33:32 -07:00
DougTW 6c2edca52b Fixed broken link in kernel-modules-dkms.rst. (#632)
- Resolved merge conflicts.

Signed-off-by: DougTW <doug.martin@intel.com>

Clean-up and testing to resolve conflicts.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-17 11:27:41 -07:00
Kristal Dale 1ddf720e80 Update .po files with latest edits for Get Started section.
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-07-17 11:27:19 -07:00
Kevin Putnam 3e1e8291bd copmleted move of old stuff
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-17 11:12:24 -07:00
DougTW 5bd551fda5 Docker.rst. Removed broken link and corrected trademark errors. (#627)
* Removed broken link and corrected trademark errors.

Signed-off-by: DougTW <doug.martin@intel.com>

* Resolve build error due to missing char on header.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-17 10:45:26 -07:00
DougTW 5835e70a19 Telemetry guide: made editorial, formatting, and spelling revisions. (#615)
* Editorial revisions to telem-guide.rst.

Signed-off-by: DougTW <doug.martin@intel.com>

* Telem-guide: completed sphinx formatting revisions requested by mvincerx

Signed-off-by: DougTW <doug.martin@intel.com>

* Final edits to headers and removing spaces.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-17 10:36:35 -07:00
Kevin Putnam 5744070a85 Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-17 10:15:27 -07:00
DougTW 07f61f81f6 kernel-modules: revised link to mixer.rst and minor editorial changes (#629)
* revised link to mixer.rst and minor editorial changes

Signed-off-by: DougTW <doug.martin@intel.com>

* Restore change by @DougTW
2019-07-17 10:00:53 -07:00
Kristal Dale ec9e3caf5a Clean up of syntax around gui elements in preparation for translation. (#636)
- Items clearly referring to an element in a GUI (e.g. buttons, menus,
areas in GUI/screen) updated to use :guilabel: or :menuselection: as
apprpriate.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-07-16 19:34:38 -07:00
Kristal Dale b7288202cf Get Started cleanup for translation (#630)
* Basic clean up and standardization of intro in preparation for translation.

- Simplify sentences.
- Remove idiomatic phrases.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Additional minor edits to simplify sentence/word choice for translation.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Removed section "Kernel Container" from compatible-kernels.rst as
Clear Containers are now deprecated and bundle no longer exists.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-07-16 19:25:46 -07:00
michael vincerra 676fc1fb37 Maintenance Guides: Basic link clean up in advance of translation of content (#625) (#609)
* Basic link clean up in advance of translation of content

- Remove unused links
- Updated links  defined as named refs to use simple text e.g. name of linked content
instead of narrative text
- Minor edits to accomodate minor changes to name of ref links

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Update links according to feedback on PR.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Update link according to feedback on PR.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

Adds new figures for live-desktop, checking prerequisites, kernel options.

- Ref: https://github.com/clearlinux/clr-installer/issues/406
- Ref: https://github.com/clearlinux/clr-installer/issues/384

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Re-orders all figures; adds new section, advanced config as placeholder.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Re-scopes PR to include only checking prereqs, kernel update, and software update.
- Three new screenshots/figures

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Adds edits to bare-metal-install-desktop.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revise wording for Proxy configuration per new Network Manager.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Cleans up in-text reference to reordered figures.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Squash commit fake.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-16 16:10:53 -07:00
Kristal Dale 4f32e1995f Maintenance Guides: Basic link clean up in advance of translation of content (#625)
* Basic link clean up in advance of translation of content

- Remove unused links
- Updated links  defined as named refs to use simple text e.g. name of linked content
instead of narrative text
- Minor edits to accomodate minor changes to name of ref links

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Update links according to feedback on PR.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Update link according to feedback on PR.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-07-16 15:23:16 -07:00
Kevin Putnam 43aa98bac1 Trying out new name for tooling section
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-16 12:57:37 -07:00
DougTW 95d8252c8e Corrected trademarks use on system-requirements (#624)
Closes #610 
Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-15 16:09:52 -07:00
Beth Dean ddf04eb8c8 Add link for terms of use. Closes #622 (#623) 2019-07-15 16:06:06 -07:00
Kevin Putnam 2d29565e3a Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-15 15:13:48 -07:00
pixelgeek 744d99d23b Update fmv.rst (#616)
* Update fmv.rst

Fix FFT typo in section header

* Update fmv.rst

Updates explaining that FFTW is an FFT library
2019-07-15 11:53:09 -07:00
Mary Camp ecb9593c3d New guide: how to install using config file (#568)
* New guide: how to install using config file

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* New guide: how to install using config file.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Added line numbers, minor text edits

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Incorporated review feedback.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Adding more feedback.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* More text changes per reviewer feedback.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Add reviewer feedback.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Completed more text edits.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Adding latest feedback.

Signed-off-by: MCamp859 <maryx.camp@intel.com>
2019-07-15 09:57:43 -07:00
Kristal Dale af63cd4105 Tooling link clean up (#620)
Basic link clean up in advance of translation of content.

- Removed unused links
- Updated links defined as named refs to use simple text e.g. name of linked content
instead of narrative text.
- Minor text edits to accomodate minor changes to name ref links.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-07-15 09:13:25 -07:00
Kevin Putnam 6f2cfb1883 Missed English language first time around
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-15 08:15:47 -07:00
Kevin Putnam 289df47754 Quick fix to get languages and lts directories to work properly on intel gitlab instance.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-15 08:11:18 -07:00
Kristal Dale e5338e5f0a Get Started section link clean up (#618)
* Link clean up

Basic link clean up in advance of translation of content.
- Removed unused links
- Updated links defined as named refs to use simple text e.g. name of linked content
instead of narrative text.
- Minor text edits to accomodate minor changes to name ref links.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>

* Fix typo from first commit.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-07-12 17:20:24 -07:00
DougTW 31e872669e Fixed cross-ref and made minor formatting and editorial changes. (#619)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-12 14:57:58 -07:00
Kevin Putnam 4a45517456 update to gitlab ci build directions for preview purposes
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-12 13:46:44 -07:00
Kevin Putnam e3329bc2ca Added german language support and build for travis
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-12 13:36:15 -07:00
Kevin Putnam 86afb6b21b Added sphinx international requirement
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-12 13:24:13 -07:00
Kevin Putnam 31b519e901 Merge pull request #612 from krisdale/rtd-theme
Initial commit for localization files
2019-07-12 13:14:48 -07:00
Kristal Dale 269f409f6c Remove conflicting line from requirements.txt
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-07-12 13:05:00 -07:00
Kristal Dale 337bff934b Revisions to Initial commit
- Revised organization for .pot and .po files
- Added required plugin for Sphinx (sphinx-intl)
- Added sample German .po files for testing

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-07-12 12:54:50 -07:00
DougTW beab785600 Fixed cross-ref in bare-metal-install-server.rst to autoproxy (#617)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-12 12:44:07 -07:00
michael vincerra 9b47a4a599 Fix error in sequence of figures, live-desktop. (#613)
- repetition of Fig 3. and Fig. 4

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-11 17:14:43 -07:00
Kristal Dale 015470e7d6 Initial commit for localization files
- new localization directory includes all .pot and .po files used in transaltions
- updated config to include sphinx-intl settings

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-07-11 15:45:32 -07:00
Kevin Putnam bd0a8e6a93 fixed broken path in python script
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-11 15:30:04 -07:00
Kevin Putnam a10198259f fixed yml syntax error
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-11 15:27:09 -07:00
Kevin Putnam 8afc8bed1e Modified jinja2 version as 2.11.dev0 was not available
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-11 15:23:28 -07:00
Kevin Putnam 25fc109318 fixed typo
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-11 15:20:10 -07:00
Kevin Putnam 36758ad647 Added requirements for py Makefile role
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-11 15:14:37 -07:00
Kevin Putnam ba9fd8f0a7 Added auto bundle update and turned off linkcheck for now.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-11 15:07:38 -07:00
Kevin Putnam 2502b13637 Added linkcheck to top level Makefile
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-11 14:57:23 -07:00
Kevin Putnam e169996687 First test of linkcheck make directive
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-11 14:46:41 -07:00
Kevin Putnam 67c4c6f8cf Hopefully fixed build artifact path
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-11 14:28:45 -07:00
Kevin Putnam 9931ae0937 Updated sphinx version in requirements and added deploy instructions to .travis.yml
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-11 14:23:52 -07:00
Kevin Putnam d93fa81e2e 1st commit for travis support.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-11 14:03:28 -07:00
Kevin Putnam 24e812f707 Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-07-11 12:34:00 -07:00
Kevin Putnam f89f43e06f Fixed path for calling linkcheck in Makefile
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-11 12:26:34 -07:00
puneetse db5b8e0737 Update system requirements documentation (#589)
Update to include installer requirements section calling out higher needs for live desktop installer.

Over all revision of document and formatting.
2019-07-11 12:04:07 -07:00
Kevin Putnam 77552f4a9f renamed support directories by adding leading "_" to differentiate from content.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-11 11:36:11 -07:00
michael vincerra d9b97cda29 Revises bare-metal-install-desktop fig 3 to clarify installer icon. (#603)
* Revises bare-metal-install-desktop to clarify installer icon.
- Closes #577

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revisions to "Launch the installer" text.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-10 17:54:27 -07:00
Kevin Putnam 87488cf303 Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-07-10 15:31:29 -07:00
Kevin Putnam 1b0da2f72f Merge pull request #608 from intelkevinputnam/rtd-theme
Updates including language, LTS support, and theme.
2019-07-10 15:24:29 -07:00
Kevin Putnam 9f55410a12 Merge pull request #607 from clearlinux/revert-604-rtd-theme
Revert "Merge of latest changes into RTD theme to enable multi-language support"
2019-07-10 15:21:47 -07:00
Kevin Putnam db98a4f65e Merge branch 'kp-theme-changes' into rtd-theme 2019-07-10 15:05:10 -07:00
Kevin Putnam 5687653508 Fixed problem with version and language paths.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-10 14:10:27 -07:00
michael vincerra 70a9988c6b Add section on settign a static machine id. (#606)
- Closes #558.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-10 09:04:17 -07:00
Kevin Putnam 167b3bf4c3 Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-07-09 15:06:15 -07:00
Kevin Putnam 633f3d0194 in progress rtd theme improvements
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-09 15:05:31 -07:00
Mary Camp f4f2e2bec7 Corrects Step 4 command to verify integrity. (#602)
Signed-off-by: MCamp859 <maryx.camp@intel.com>
2019-07-09 09:59:47 -07:00
DougTW 6290be9041 NVIDIA; Trademark, branding, and editorial changes (#601)
* Minor editorial and trademark/branding changes.

Signed-off-by: DougTW <doug.martin@intel.com>

* Fixed file directive. Made grammatical change suggested by puneetse.

Signed-off-by: DougTW <doug.martin@intel.com>

* Fixed heading markup requested by mvincerx.

Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-09 09:25:32 -07:00
michael vincerra 55f70475cf Replaces telemetry figure per Engineering for clr-installer 2.0.8. (#595)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revises Figure 16, telemetry, to remove installer version.
- Closes #590 to address non-UEFI USB entry in BIOS during install

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Closes #590.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-09 09:22:05 -07:00
michael vincerra 0f0eb17809 Replaces telemetry figure with clr-installer 2.0.8 version, live-desktop. (#597)
* Update telemetry figure per Engineering to reflect clr-installer 2.0.8.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revise instruction to match new GUI.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Revise wording of step to match new GUI.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-08 17:30:10 -07:00
Beth Dean fe2194355a Add a note about running stack on other Linux distros (#598)
* Add a note about running stack on other Linux distros

* Add unistall instructions
2019-07-08 15:07:44 -07:00
DougTW 000a3d60df mixer.rst: editorial changes (#585)
* Editorial, spelling, and formatting changes only.

Signed-off-by: DougTW <doug.martin@intel.com>

* Fixed indentation error on mixer.rst

Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-08 12:58:30 -07:00
Kevin Putnam 1b82905947 Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-08 12:25:57 -07:00
Kevin Putnam d6c7796382 Added FAQ to sitemap and shortened FAQ title text to "FAQ." (#600)
Closes #599 
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-08 11:58:36 -07:00
Beth Dean 09f3f68649 Add link to terms of use in the dlrs tutorial (#596) 2019-07-03 20:00:09 -05:00
bktan8 264001c830 q
* Retested QEMU-KVM doc. against latest Clear and 3rd-party distros.
Updated doc. to reflect any changes.

Signed-off-by: Bun K Tan <bun.k.tan@intel.com>

* Added reviewer comments.

Signed-off-by: MCamp859 <maryx.camp@intel.com>
2019-07-03 14:13:50 -05:00
DougTW 66778cc38b Minor editorial changes to swupd-guide.rst. (#591)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-03 13:27:36 -05:00
puneetse 1769d6eff4 Fix minor syntax on nvidia.rst (#594) 2019-07-02 17:03:28 -07:00
michael vincerra b44b744a0a Adds note to clarify BIOS behavior if installing on multiple partitions. (#582)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Rewording revisions.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Incorporates reviewer feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Editorial change.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-07-02 15:46:11 -07:00
puneetse 1e29bd2f8f Add a step restart NetworkManager in static IP doc (#584)
* Update assign static IP doc to have NM instructions

* Add step to restart NetworkManager
2019-07-02 15:11:35 -07:00
puneetse 4f86b06936 Update NVIDIA documentation to isolate install even further (#586)
* Add updating section to NVIDIA  doc

* Isolate NVIDIA files under /opt and /etc even more

Adds more parameters to avoid nvidia-installer placing files under /usr and have applications use alternative paths.

* Explicitly add warning about libGL.so conflict

Add a warning about the well-know libGL conflict between mesa and NVIDIA packages.

* Update nvidia.rst
2019-07-02 14:59:46 -07:00
DougTW ea7263c429 minor editorial changes; edits complete. (#580)
Signed-off-by: DougTW <doug.martin@intel.com>
2019-07-02 12:11:33 -07:00
Kevin Putnam 95602108b1 Simplified tooling label from clear-linux-tooling.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-02 10:59:25 -07:00
Kevin Putnam 21b94251e5 Moved new content to new structure. Added FAQ back into top level index.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-02 10:47:42 -07:00
Kevin Putnam 88c7dc1264 Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-02 10:38:18 -07:00
puneetse a829786be6 Update assign static IP doc to have NM instructions (#574) 2019-07-01 08:55:35 -07:00
Beth Dean 45ce94d4df Add link for launcher.py and note MKL HW reqs for DLRS tutorial. (#570)
* Add link for launcher.py and note MKL HW reqs for DLRS tutorial.

* Reword note about MKL, change from note to warning.  Closes #560, Closes #559

* Add note specifying Kubeflow v0.4 when using launcher.py
* Closes #559 , Closes #560
2019-06-28 10:46:25 -07:00
puneetse 0070d49b94 Add note about AUTOINSTALL=yes in dkms.conf (#575) 2019-06-28 09:15:12 -07:00
puneetse a7fe4595d3 Add a FAQ page (#547)
* Add a new FAQ document

* Clerical changes to faq doc

Signed-off-by: MCamp859 <maryx.camp@intel.com>
2019-06-28 09:05:29 -07:00
DougTW e489014707 Changed ister.rst for trademarks, branding, and editorial issues. (#573)
* Minor editorial revision to test multiple commits on one file.

Signed-off-by: douglasm <doug.martin@intel.com>

* Minor editorial revisions completes my revisions to this file.

Signed-off-by: douglasm <doug.martin@intel.com>
2019-06-27 13:55:55 -07:00
puneetse 3df0f684d3 Add stateless concept document (#564) 2019-06-26 17:31:16 -07:00
puneetse ab72289223 Add document on debug system (#561) 2019-06-26 17:25:44 -07:00
DougTW 122da5da45 Dm autospec guide editorial (#565)
* Edited for syntax, spelling, trademarking, and branding.

Signed-off-by: douglasm <doug.martin@intel.com>

* Made editorial revisions, e.g., grammar and spelling.

Signed-off-by: douglasm <doug.martin@intel.com>

* changed one phrase to use active voice present tense. Reset autoproxy.rst.

Signed-off-by: douglasm <doug.martin@intel.com>
2019-06-26 15:31:23 -07:00
Beth Dean 18794a66ed Add section for kubectl to dlrs tutorial (#550)
* Add section for kubectl to dlrs tutorial

* Editorial clean up to Kubectl section.

* Minor grammatical edits: missing punctuation and line length clean up.

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-06-24 11:41:52 -07:00
puneetse 3c1cfd9056 Add document on CPU power and performance (#542)
* Add document on CPU power and performance

* Minor revisions for:
- grammar
- wording/spelling
- formatting

Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-06-20 11:38:28 -07:00
Tom Leavitt 815c250bab Update telemetry about (#549)
* Update telemetry about

Remove link to the features/telemetry, it no longer exists

* Update next steps

Update next steps section

* add backticks

cut and paste zapped the backticks, restore them
2019-06-18 11:08:41 -07:00
George T Kramer e3538c68a5 Remove non-production image types (#555)
container-host-kvm.img is considered developmental and should not be
shown in documentation.  Want to keep list of image types in
documentation oriented toward production.

Signed-off-by: George T Kramer <george.t.kramer@intel.com>
2019-06-18 10:35:49 -07:00
Tom Leavitt be3c7f00d1 Update KVM download script (#551)
update the grep string to isolate and download the -kvm.img file
2019-06-17 14:28:44 -07:00
Kevin Putnam cff315e9c6 Update image types to match current offerings. (#548)
* * updated image types to match current offerings
* fixed broken link in ister.rst - now pointing at image-types.rst

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Updates based on peer review.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Removed deprecated cloud image.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-06-17 12:24:41 -07:00
Kevin Putnam 645c05a10f KP add proxy tutorial (#514)
* First commit of proxy tutorial

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* First commit of new proxy tutorial content.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Added additional content and some todo items.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Removed todo list.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Added requested proxy variables.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Updates based on peer review.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Fixed typo.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-06-17 12:23:28 -07:00
Mary Camp d03e0b88bd TCS edits in Creating CL VM on Google Cloud Platform doc (#534)
* Signed-off-by: MCamp859 <maryx.camp@intel.com>
TCS review of GCE guide

* Incorporated feedback.

Signed-off-by: MCamp859 <maryx.camp@intel.com>
2019-06-17 09:39:13 -07:00
Mary Camp 9b544a135e TCS review of swupd-guide (#509)
* TCS review of swupd-guide

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Incoporated feedback.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Added minor edits.

Signed-off-by: MCamp859 <maryx.camp@intel.com>

* Fixed bullets

Signed-off-by: MCamp859 <maryx.camp@intel.com>
2019-06-17 09:36:59 -07:00
Kevin Putnam 6e47f8d986 Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-06-12 15:42:45 -07:00
Beth Dean 91b4aa51e1 Add statement to clarify enable/disable default status of client (#537)
* Add statement to clarify enable/disable default status of client

* Fix duplicate -is- and embolden opt-in

* Update the telemetry concept page to reflect opt-in nature of telemetry

* Add important callout regarding enable/disable telemetry

* Reword important note to be stronger.
2019-06-11 21:33:14 -04:00
Kevin Putnam 524bb694ee Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-06-11 10:27:35 -07:00
Kevin Putnam a95c1eede9 Merge pull request #530 from mvincerx/mv-swupd-guide
@MCamp859, @castulo , @mvincerx Thanks for all the work on this PR. Merging. If you catch anything new, we can submit a new PR.
2019-06-10 18:17:42 -04:00
Kevin Putnam b302966d26 Fixed broken :command: role.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-06-10 15:13:02 -07:00
Kevin Putnam 43dbb3b9e7 * Moved kernel guides to their own section.
* Restored redis tutorial that was orphaned in now nonexistent clear-linux/guides section.
* Fixed includes broken by moving kernel guides

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-06-10 10:56:18 -07:00
Kevin Putnam b33ec1b46b Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-06-10 10:35:35 -07:00
Kevin Putnam 216db17df2 Merge pull request #535 from intelkevinputnam/kp-fix-guide-note
Created an RST note for mixin deprecation notice.
2019-06-10 12:55:30 -04:00
Kevin Putnam ac2590d4ea Created an RST note for mixin deprecation notice.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-06-10 09:53:10 -07:00
Mikko Ylinen f874f783c2 Kubernetes doc updates (#531)
* kubernetes: update CNI instructions

CRI-O now supports multiple CNI binary paths and Clear Linux by default
uses /usr/libexec/cni AND /opt/bin/cni so there's no need to give
these instructions anymore.

Signed-off-by: Mikko Ylinen <mikko.ylinen@intel.com>

* kubernetes: add RuntimeClass instructions for Kata Containers

Clarify how to enable Kata Containers via RuntimeClass (which is now
enabled by default in Clear Linux kubernetes).

Signed-off-by: Mikko Ylinen <mikko.ylinen@intel.com>
2019-06-07 12:03:00 -07:00
Michael Vincerra 5086e9180d Incorporates feedback from @castulo on revised swupd commands.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-06-07 11:14:21 -07:00
Kevin Putnam 7caea349e3 Additional proposed fixes to organization for RTD site.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-06-07 08:47:45 -07:00
Michael Vincerra 655ec84042 Revise instance where swupd repair is better option than diagnose.
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-06-06 15:42:52 -07:00
Michael Vincerra 7a00983771 Replaces swupd verify and related flag commands per @castulo.
- Closes #522
- Deprecates use of:
 `swupd verify`
 `swupd verify --fix`
 `swupd verify --install`
 `-m / --manifest`

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-06-06 15:31:47 -07:00
michael vincerra 843abc3ef7 Adds redis tutorial with systemctl service check, 2 example use cases (#525)
* Adds redis tutorial with systemctl service check; add 2 example use cases.
- Closes #519

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Refine intro and add development examples.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revise wording intro; add hyperlinks in Example 2.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Correct description of client libraries.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Correct spacing; add note to define syntax behavior.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Respond to reviewer's feedback. Revise wording. Add docker command.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Apply wording revisions for clarity.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Edit for squash.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Resolve build error to avoid duplicate ref's.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-06-06 14:26:40 -07:00
Kevin Putnam 8a07199ef0 Removed superfluous layer from documentation hiearchy and renamed master doc from clear-linux.rst to index.rst to generate a cleaner url.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-06-06 12:26:58 -07:00
Kevin Putnam ced53e8df3 Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme 2019-06-06 12:09:04 -07:00
Kevin Putnam 1d45182130 Moved a bunch of things around. Now at risk of not being able to merge with master.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-06-06 12:08:33 -07:00
Kevin Putnam 45361ba0b3 Added tooling to main intro.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-06-06 09:37:33 -07:00
Kevin Putnam 1887b87f6f A bunch of improvements and proof of concept for moving tooling to top level.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-06-06 09:29:59 -07:00
Beth Dean be8aa2c024 Add link to quantization tools for model conversion (#529) 2019-06-06 07:04:00 -07:00
michael vincerra 1d284eee71 Removes multi-boot tutorial; deferred until further technical review. (#526)
Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-06-04 09:29:20 -07:00
Tonny Tzeng f7012bc1ca google-cloud: New tutorial on creating Clear Linux VM on GCP (#505)
* google-cloud: New tutorial on creating Clear Linux VM on GCP

This tutorial documents how to create Clear Linux compute engine on Google
Cloud Platform.

Signed-off-by: Tonny Tzeng <tonny.tzeng@intel.com>
Reviewed-by: Sethi, Puneet <puneet.sethi@intel.com>
Reviewed-by: Vincerra, Michael <michael.vincerra@intel.com>

* virtualbox-cl-installer: Revise figures to match VirtualBox 6.0.8 and new live-server installer. (#502)

* Revises instruciton to match VirtualBox 6.0.8 and new live-desktop installer; -live.img deprecated.
- Incorporates LGA and Troubleshooting from virtualbox.rst
- Replaces virtualbox.rst.
- Refer also to GH-493.
- Closes #495 
- Closes #502
- Closes #498 

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Resizes figures; reassigns Troubleshooting section from virtualbox this doc.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Adds Troubleshooting section.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Removes ununsed figures, previously from virtualbox.rst.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Re-adds prev removed CAUTION in substitutions.txt

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revises guide per reviewer feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Adds note on file size if using live-desktop install--below Fig. 6.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Incorporates reviewer feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revert to use case of live-server per reviewer feedback.
- Revise all Figures
- Revise all steps

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Respond to reviewers' feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revise figures; add step for VBoxSVGA; move add desktop-autostart to post-install.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Respond to reviewer feedback re clarifying post-installation steps.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Simplify steps; define context for steps; correct values in code-block.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Replaces step with note re kernel update in LGA section.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* google-cloud: New tutorial on creating Clear Linux VM on GCP

This tutorial documents how to create Clear Linux compute engine on Google
Cloud Platform.

Signed-off-by: Tonny Tzeng <tonny.tzeng@intel.com>
Reviewed-by: Sethi, Puneet <puneet.sethi@intel.com>
Reviewed-by: Vincerra, Michael <michael.vincerra@intel.com>

* Corrects gce filename, rst syntax for proper build and rendering.
- Adds new steps to cover gaps where necessary.
- Closes #504

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-05-31 13:55:47 -07:00
michael vincerra 52e8e1ff01 virtualbox-cl-installer: Revise figures to match VirtualBox 6.0.8 and new live-server installer. (#502)
* Revises instruciton to match VirtualBox 6.0.8 and new live-desktop installer; -live.img deprecated.
- Incorporates LGA and Troubleshooting from virtualbox.rst
- Replaces virtualbox.rst.
- Refer also to GH-493.
- Closes #495 
- Closes #502
- Closes #498 

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Resizes figures; reassigns Troubleshooting section from virtualbox this doc.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Adds Troubleshooting section.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Removes ununsed figures, previously from virtualbox.rst.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Re-adds prev removed CAUTION in substitutions.txt

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revises guide per reviewer feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Adds note on file size if using live-desktop install--below Fig. 6.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Incorporates reviewer feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revert to use case of live-server per reviewer feedback.
- Revise all Figures
- Revise all steps

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Respond to reviewers' feedback.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Revise figures; add step for VBoxSVGA; move add desktop-autostart to post-install.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Respond to reviewer feedback re clarifying post-installation steps.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

Simplify steps; define context for steps; correct values in code-block.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Replaces step with note re kernel update in LGA section.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-05-31 11:10:29 -07:00
900 changed files with 60115 additions and 37762 deletions
@@ -1,6 +1,9 @@
---
name: Modify document
about: Modify a document for the Clear Linux* Project
title: ''
labels: P2
assignees: ''
---
+3
View File
@@ -1,6 +1,9 @@
---
name: New document
about: Request a new document for the Clear Linux* project
title: ''
labels: P2
assignees: ''
---
+24
View File
@@ -0,0 +1,24 @@
name: Check
on: [pull_request]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v1
- name: Install dependencies
run: |
export PATH="$HOME/.local/bin:$PATH"
sudo apt-get install -y python3-setuptools pandoc
pip3 install --user -r requirements.txt
- name: Build the docs
run: |
export PATH="$HOME/.local/bin:$PATH"
make py
make man
make htmlall
+13
View File
@@ -0,0 +1,13 @@
name: Greetings
on: [pull_request, issues]
jobs:
greeting:
runs-on: ubuntu-latest
steps:
- uses: actions/first-interaction@v1
with:
repo-token: ${{ secrets.GITHUB_TOKEN }}
issue-message: 'Welcome to Clear Linux* OS Docs. Thanks for submitting your first issue.'
pr-message: 'Welcome to Clear Linux* OS Docs. Thanks for submitting your first PR.'
+22
View File
@@ -0,0 +1,22 @@
name: Linkcheck
on:
schedule:
- cron: '0 0 * * Mon,Wed,Fri'
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v1
- name: Install dependencies
run: |
export PATH="$HOME/.local/bin:$PATH"
sudo apt-get install -y python3-setuptools
pip3 install --user -r requirements.txt
- name: CheckLinks
run: |
export PATH="$HOME/.local/bin:$PATH"
make linkcheck
+40
View File
@@ -0,0 +1,40 @@
name: CI
on:
push:
branches:
- master
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v1
- name: Install dependencies
run: |
export PATH="$HOME/.local/bin:$PATH"
sudo apt-get install -y python3-setuptools pandoc
pip3 install --user -r requirements.txt
- name: Build the docs
run: |
export PATH="$HOME/.local/bin:$PATH"
make py
make man
make htmlall
- name: Pre-deploy
run: |
wget https://github.com/clearlinux/clear-linux-documentation-zh-CN/releases/latest/download/clearlinux-docs-zh-CN.tar.gz
mkdir source/_build/html/zh_CN
tar xvzf clearlinux-docs-zh-CN.tar.gz -C source/_build/html/zh_CN
mv source/_build/html $HOME/output
- name: Deploy the docs
run: |
cd $HOME/output
git init
git config --global user.name "${GITHUB_ACTOR}"
git config --global user.email "${GITHUB_ACTOR}@github.com"
git add .
git commit -m "latest html output"
git push -f https://${GITHUB_ACTOR}:${{secrets.ACCESS_TOKEN}}@github.com/clearlinux/clear-linux-documentation.git HEAD:developmentHTML
+44
View File
@@ -0,0 +1,44 @@
name: Publish
on:
push:
branches:
- publish
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v1
- name: Install dependencies
run: |
export PATH="$HOME/.local/bin:$PATH"
sudo apt-get install -y python3-setuptools pandoc
pip3 install --user -r requirements.txt
- name: Build the docs
run: |
export PATH="$HOME/.local/bin:$PATH"
make py
make man
make htmlall
- name: Pre-deploy
run: |
wget https://github.com/clearlinux/clear-linux-documentation-zh-CN/releases/latest/download/clearlinux-docs-zh-CN.tar.gz
mkdir source/_build/html/zh_CN
tar xvzf clearlinux-docs-zh-CN.tar.gz -C source/_build/html/zh_CN
mv source/_build/html $HOME/output
- name: Deploy the docs
run: |
cd $HOME/output
git init
git config --global user.name "${GITHUB_ACTOR}"
git config --global user.email "${GITHUB_ACTOR}@github.com"
git add .
git commit -m "latest html output"
git push -f https://${GITHUB_ACTOR}:${{secrets.ACCESS_TOKEN}}@github.com/clearlinux/clear-linux-documentation.git HEAD:latestHTML
- name: Publish the docs
run: |
wget ${{secrets.PUBLISH_URL}}
cat clearlinux-latest
+20
View File
@@ -7,3 +7,23 @@ source/_build
# ignore VS code settings
.vscode/
# ignore .mo translation files
*.mo
# ignore artifacts generated by running make py
cloned_repo
bundles.html.txt
# ignore the venv, used for running make py
venv
#ignore for reDocs GUI
.tox
MANIFEST
# ignore artifacts of man page generation
source/_scripts/_python/manpages/*.rst
source/reference/manpages
source/_scripts/_python/manpages/*/
source/reference/man-pages.rst
+2 -2
View File
@@ -4,13 +4,13 @@ pages:
script:
- apk --no-cache add python3
- python3 -m ensurepip
- pip3 install sphinx==1.7.5 docutils==0.14 sphinx_rtd_theme breathe==4.9.1 sphinxcontrib-plantuml
- pip3 install sphinx==1.8.0 docutils==0.14 sphinx_rtd_theme breathe==4.9.1 sphinxcontrib-plantuml sphinx-intl==2.0.0 sphinx-sitemap==1.0.2
- apk --no-cache add make
- apk --no-cache add doxygen
- apk --no-cache add graphviz
- apk --no-cache add ttf-dejavu
- apk --no-cache add openjdk8-jre
- make html
- make htmlall
- mv source/_build/html/ public/
artifacts:
paths:
+30 -1
View File
@@ -1,16 +1,45 @@
# Makefile for Sphinx documentation
#
SHELL := /bin/bash
PY_VERSION ?= 3.6
all:
make -C source html
htmlall:
make -C source htmlall
htmlzh:
make -C source htmlzh
htmlde:
make -C source htmlde
html:
make -C source html
linkcheck:
make -C source linkcheck
py:
make -C source py
man:
make -C source man
clean-man:
make -C source clean-man
help:
@echo "Please use \`make <target>' where <target> is one of"
@echo " html to make standalone HTML files"
clean:
make -C source clean
rm -rf venv
venv:
virtualenv venv;\
source venv/bin/activate; \
pip3 install -r requirements.txt;
+146 -28
View File
@@ -10,38 +10,46 @@ documentation locally for development and testing.
Please make yourself familiar with our `contribution guidelines`_ before
submitting a contribution.
Requirements
************
Make sure you have Python and Sphinx installed. We use Python 3 and
Sphinx 1.7.5
The Sphinx documentation provides `instructions for installing Sphinx`_ on various
platforms.
Clone the documentation repository
**********************************
Once Sphinx is installed, clone the documentation repository to your
local machine.
Clone the documentation repository to your local machine.
.. code-block:: console
.. code-block:: bash
$ git clone https://github.com/clearlinux/clear-linux-documentation
git clone https://github.com/clearlinux/clear-linux-documentation
Requirements
************
Make sure you have Python 3 installed to start.
The Sphinx documentation provides `instructions for installing Sphinx`_
on various platforms.
Use pip3 to install additional Python dependencies listed in the
requirements.txt file found in the repository:
.. code-block:: bash
pip3 install -r requirements.txt
Run the build
*************
We build our documentation using Sphinx. In the source directory of your
local clear-linux-documentation repository, build the documentation by running
**make html**:
local clear-linux-documentation repository, preview changes to the
documentation by building the docs in the default language (English) by
running ``make html``:
.. code-block:: bash
make html
.. code-block:: console
$ make html
>
sphinx-build -b html -d _build/doctrees . _build/html
Running Sphinx v1.7.5
Running Sphinx v1.8.0
making output directory...
.
.
@@ -52,23 +60,133 @@ local clear-linux-documentation repository, build the documentation by running
Build finished. The HTML pages are in _build/html.
Open one of the HTML pages in a web browser to view the rendered
documentation.
Open one of the HTML pages found in ``source/_build/html`` in a web browser
to view the rendered documentation.
This build will generate several warnings as there are two other optional make commands required to build the full documentation.
1. ``make py`` to generate the bundle reference material.
2. ``make man`` to generate man page reference material.
To build the documentation exactly as seen on the website, use
``make man``, ``make py``, and ``make htmlall``. This builds both
external dependencies and all supported languages.
Use virtualenv
**************
To develop documentation in a ``virtualenv``, use the ``venv`` target.
The Clear Linux OS documentation make target ``venv`` provides a
simple development environment that ensures that you have the
latest packages and that you manage Python versions separately. Use of the
``virtualenv`` requires **Python 3.6** or higher. For Windows examples below, use Powershell as an Administrator.
The **virtual environment** uses the same version of Python that was used to **create the virtual environment**.
Verify ``pip`` is installed. A file path to pip should appear.
On Clear Linux OS and macOS\*:
.. code-block:: bash
which pip
On Windows\* 10 OS:
.. code-block:: bash
pip --version
If ``pip`` is not installed, install it.
On Clear Linux OS and macOS:
.. code-block:: bash
python3 -m pip install --user --upgrade pip
On Windows 10 OS:
.. code-block:: bash
py -m pip install --upgrade pip
.. note::
This assumes Python was already added to your Windows path.
Install virtualenv
==================
Install ``virtualenv``.
On Clear Linux OS and macOS\*:
.. code-block:: bash
python3 -m pip install --user virtualenv
On Windows 10 OS:
.. code-block:: bash
py -m pip install --user virtualenv
Create the ``virtualenv`` and install the required packages:
.. code-block:: bash
make venv
Activate the ``venv``.
.. code-block:: bash
source venv/bin/activate
Follow `Run the build`_ section to start developing documentation.
Remove the ``venv`` when finished developing.
.. code-block:: bash
deactivate
Additional help
***************
Cleaning up
===========
When testing changes in the documentation, make sure to remove the previous
build before building again by running **make clean**:
build before building again by running ``make clean``:
.. code-block:: console
.. code-block:: bash
$ make clean
>
rm -rf _build/*
make clean
This will completely remove the previous build output.
This will completely remove the previous build output, including artifacts
from the `make venv` target when done outside an active venv.
.. _Clear Linux\* OS documentation: https://clearlinux.org/documentation
Before running ``make man``, please run ``make clean-man`` to clear out any
previous attempts.
Convenience script
==================
This bash script (Linux only) includes both ``make clean`` and
``make html``. It also starts a simple Python web server that
displays a preview of the site at http://localhost:8000 on your local machine.
.. code-block:: bash
./checkwork.sh
To stop the web server simply use ``ctrl-c``.
.. _Clear Linux\* OS documentation: https://docs.01.org/clearlinux/
.. _Sphinx: http://sphinx-doc.org/
.. _reStructuredText: http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
.. _contribution guidelines: https://clearlinux.org/documentation/clear-linux/reference/collaboration
.. _contribution guidelines: https://docs.01.org/clearlinux/latest/collaboration/collaboration.html
.. _instructions for installing Sphinx: https://www.sphinx-doc.org/en/master/usage/installation.html
+14
View File
@@ -0,0 +1,14 @@
#! /bin/bash
# run with no arguments
# 1. deletes previous build output
# 2. builds default language version of docs only (English)
# 3. changes directory to html output
# 4. runs http server for local review of docs
#
# Requires python 3
make clean
make html
cd source/_build/html
python3 -m http.server
+351
View File
@@ -0,0 +1,351 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-09-06 11:29-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../FAQ/index.rst:4
msgid "FAQ"
msgstr ""
#: ../../FAQ/index.rst:6
msgid ""
"Below is a list of commonly asked questions with answers sourced from the"
" |CL-ATTR| team and `Clear Linux community forums`_."
msgstr ""
#: ../../FAQ/index.rst:13
msgid "General"
msgstr ""
#: ../../FAQ/index.rst:16
msgid "Why did you make another distro?"
msgstr ""
#: ../../FAQ/index.rst:18
msgid ""
"The |CL| team felt that performance was left on the table with Linux "
"software. |CL| takes a holistic approach to improving performance across "
"the stack. We also wanted to take more modern approaches with OS updates "
"and tooling."
msgstr ""
#: ../../FAQ/index.rst:25
msgid "Can other distros copy |CL| improvements?"
msgstr ""
#: ../../FAQ/index.rst:27
msgid "Yes, we absolutely love open source reuse and upstreaming improvements."
msgstr ""
#: ../../FAQ/index.rst:32
msgid "How often do you update?"
msgstr ""
#: ../../FAQ/index.rst:34
msgid ""
"The |CL| team puts out multiple releases a week, often releasing 2 or "
"more times a day. This rolling release approach allows |CL| to remain "
"agile to upstream changes and security patches."
msgstr ""
#: ../../FAQ/index.rst:41
msgid "Is telemetry required?"
msgstr ""
#: ../../FAQ/index.rst:43
msgid ""
"The telemetry solution provided by |CL| is entirely optional and "
"customizable. It is disabled by default. If you do choose to enable "
"telemetry, the data helps the |CL| team proactively identify and resolve "
"bugs. See the :ref:`telem-guide` guide for more information."
msgstr ""
#: ../../FAQ/index.rst:51
msgid "What is the default firewall?"
msgstr ""
#: ../../FAQ/index.rst:53
msgid ""
"|CL| packages :command:`iptables` as a bundle, however, there are no "
"default firewall rules. All network traffic is allowed by default."
msgstr ""
#: ../../FAQ/index.rst:59
msgid "Where are the files that I usually see under /etc like fstab?"
msgstr ""
#: ../../FAQ/index.rst:61
msgid ""
"|CL| has a stateless design that maintains a separation between system "
"files and user files. Default values are stored under "
":file:`/usr/share/defaults/`. Files under :file:`/etc/` are not created "
"unless you create one."
msgstr ""
#: ../../FAQ/index.rst:65
msgid ""
"A blog post explaining how this is accomplished with :file:`/etc/fstab/` "
"specifically is available here: https://clearlinux.org/news-blogs/where-"
"etcfstab-clear-linux"
msgstr ""
#: ../../FAQ/index.rst:72
msgid "Software packages"
msgstr ""
#: ../../FAQ/index.rst:75
msgid "How is software installed and updated?"
msgstr ""
#: ../../FAQ/index.rst:77
msgid ""
"|CL| provides software in the form of :ref:`bundles-guide` and updates "
"software with :ref:`swupd <swupd-guide>`."
msgstr ""
#: ../../FAQ/index.rst:80
msgid ""
":ref:`Flatpak\\* <flatpak-tutorial>` is an application virtualization "
"solution that allows more software to be available to |CL| users by "
"augmenting the software |CL| packages natively with software available "
"through Flatpak."
msgstr ""
#: ../../FAQ/index.rst:84
msgid ""
"Our goal is to have software packaged natively and made available through"
" bundles whenever possible."
msgstr ""
#: ../../FAQ/index.rst:90
msgid "Does |CL| use RPMs like other distros?"
msgstr ""
#: ../../FAQ/index.rst:92
msgid ""
"|CL| provides software in the form of :ref:`bundles-guide`. The RPM "
"format is used as an intermediary step for packaging and determining "
"software dependencies at OS build time."
msgstr ""
#: ../../FAQ/index.rst:96
msgid ""
"Individual RPMs can sometimes be manually installed on a |CL| system with"
" the right tools, but that is not the intended use case."
msgstr ""
#: ../../FAQ/index.rst:102
msgid "Can I install a software package from another OS on |CL|?"
msgstr ""
#: ../../FAQ/index.rst:104
msgid ""
"Software that is packaged in other formats for other Linux distributions "
"is not guaranteed to work on |CL| and may be impacted by |CL| updates."
msgstr ""
#: ../../FAQ/index.rst:107
msgid ""
"If the software you're seeking is open source, please submit a request to"
" add it to |CL|. Submit requests on GitHub\\* here: "
"https://github.com/clearlinux/distribution/issues"
msgstr ""
#: ../../FAQ/index.rst:114
msgid "Software availability"
msgstr ""
#: ../../FAQ/index.rst:117
msgid "What software is available on |CL|?"
msgstr ""
#: ../../FAQ/index.rst:119
msgid ""
"Available software can be found in the `Software Store`_, through the "
"GNOME\\* Software application on the desktop, or by using :ref:`swupd "
"search <swupd-quick-ref>`."
msgstr ""
#: ../../FAQ/index.rst:125
msgid "Is Google\\* Chrome\\* available?"
msgstr ""
#: ../../FAQ/index.rst:127
msgid ""
"The Google Chrome web browser is not distributed as a bundle in |CL| due "
"to copyright and licensing complexities."
msgstr ""
#: ../../FAQ/index.rst:130
msgid ""
"A discussion on manually installing and maintaining Google Chrome can be "
"found on GitHub: https://github.com/clearlinux/distribution/issues/422"
msgstr ""
#: ../../FAQ/index.rst:136
msgid "Is Microsoft\\* Visual Studio Code\\* available?"
msgstr ""
#: ../../FAQ/index.rst:138
msgid ""
"Yes. Find the CLI command for installing `VS Code`_ and other Flatpak "
"apps in the `software store`_. Installing Flatpak apps is also covered in"
" our :ref:`tutorial <flatpak-tutorial>`."
msgstr ""
#: ../../FAQ/index.rst:142
msgid ""
"The |CL| team is working on a natively packaged version of Visual Studio "
"Code for future release."
msgstr ""
#: ../../FAQ/index.rst:145
msgid ""
"Join a community forum discussion about manually installing and "
"maintaining Visual Studio Code: https://community.clearlinux.org/t/need-"
"native-support-for-vs-code-through-swupd/"
msgstr ""
#: ../../FAQ/index.rst:153
msgid "Is FFmpeg available?"
msgstr ""
#: ../../FAQ/index.rst:155
msgid ""
"`FFmpeg`_ is a multimedia software suite, which is commonly used for "
"various media encoding/decoding, streaming, and playback."
msgstr ""
#: ../../FAQ/index.rst:158
msgid ""
"|CL| does not distribute FFmpeg due to well-known licensing and legal "
"complexities (See https://www.ffmpeg.org/legal.html and "
"http://blog.pkh.me/p/13-the-ffmpeg-libav-situation.html)."
msgstr ""
#: ../../FAQ/index.rst:162
msgid ""
"Read more in the |CL| repository, including discussion of an alternative "
"hardware-based solution: "
"https://github.com/clearlinux/distribution/issues/429."
msgstr ""
#: ../../FAQ/index.rst:166
msgid ""
"While |CL| cannot distribute FFmpeg, a manual solution to build and "
"install FFmpeg under :file:`/usr/local` has been shared on the community "
"forums: https://community.clearlinux.org/t/how-to-h264-etc-support-for-"
"firefox-including-ffmpeg-install."
msgstr ""
#: ../../FAQ/index.rst:173
msgid "Is ZFS\\* available?"
msgstr ""
#: ../../FAQ/index.rst:175
msgid ""
"ZFS is not available with |CL| because of copyright and licensing "
"complexities. BTRFS is an alternative filesystem that is available in "
"|CL| natively."
msgstr ""
#: ../../FAQ/index.rst:179
msgid ""
"A user on GitHub notes that the ZFS kernel module can be compiled, built,"
" and installed manually: "
"https://github.com/clearlinux/distribution/issues/631"
msgstr ""
#: ../../FAQ/index.rst:185
msgid "Can you add a driver that I need?"
msgstr ""
#: ../../FAQ/index.rst:187
msgid ""
"If a kernel module is available as part of the Linux kernel source tree "
"but not enabled in the |CL| kernels, in many cases the |CL| team will "
"enable it upon request. Submit requests on GitHub here: "
"https://github.com/clearlinux/distribution/issues"
msgstr ""
#: ../../FAQ/index.rst:192
msgid ""
"The |CL| team does not typically add out-of-tree kernel modules as a "
"matter of practice because of the maintenance overhead. If the driver was"
" unable to be merged upstream, there is a good chance we may be unable to"
" merge it for similar reasons."
msgstr ""
#: ../../FAQ/index.rst:197
msgid ""
"Kernel modules can be individually built and installed on |CL|. See the "
":ref:`kernel modules <kernel-modules>` page for more information."
msgstr ""
#~ msgid ""
#~ "The telemetry solution provided by |CL|"
#~ " is entirely optional and customizable. "
#~ "It is disabled by default. If you"
#~ " do choose to enable telemetry, the"
#~ " data helps the |CL| team proactively"
#~ " identify and resolve bugs. See the"
#~ " :ref:`telemetry <telemetry-about>` page "
#~ "for more information."
#~ msgstr ""
#~ msgid ""
#~ "|CL| provides software in the form "
#~ "of :ref:`bundles <bundles-about>` and "
#~ "updates software with :ref:`swupd <swupd-"
#~ "about>`."
#~ msgstr ""
#~ msgid ""
#~ "|CL| provides software in the form "
#~ "of :ref:`bundles <bundles-about>`. The "
#~ "RPM format is used as an "
#~ "intermediary step for packaging and "
#~ "determining software dependencies at OS "
#~ "build time."
#~ msgstr ""
#~ msgid ""
#~ "Available software can be found in "
#~ "the `Software Store`_, through the "
#~ "GNOME\\* Software application on the "
#~ "desktop, or by using :ref:`swupd search"
#~ " <bundle-commands>`."
#~ msgstr ""
#~ msgid ""
#~ ":ref:`FlatPak\\* <flatpak>` is an application"
#~ " virtualization solution that allows more"
#~ " software to be available to |CL| "
#~ "users by augmenting the software |CL|"
#~ " packages natively with software available"
#~ " through FlatPak."
#~ msgstr ""
#~ msgid ""
#~ "Yes. Find the CLI command for "
#~ "installing `VS Code`_ and other FlatPak"
#~ " apps in the `software store`_. "
#~ "Installing FlatPak apps is also covered"
#~ " in our :ref:`tutorial <flatpak>`."
#~ msgstr ""
+149
View File
@@ -0,0 +1,149 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../about.rst:4
msgid "About"
msgstr "关于"
#: ../../about.rst:6
msgid ""
"The |CL| delivers a secure, hardware optimized OS. Its easy updates "
"ensure that software dependencies remain mutually compatible."
msgstr "|CL| 提供安全的、针对硬件优化的操作系统。它容易更新,这可确保软件依赖项保持相互兼容。"
#: ../../about.rst:9
msgid ""
"|CL| does this via custom infrastructure components and process "
"innovations."
msgstr "|CL| 通过自定义基础结构组件和流程创新实现这一点。"
#: ../../about.rst:16
msgid ""
"For detailed information on these topics, refer to the :ref:`cl-guides` "
"guides."
msgstr "有关这些主题的详细信息,请参阅 :ref:`cl-guides` 指南。"
#: ../../about.rst:20
msgid "Release Cadence"
msgstr "发行节奏"
#: ../../about.rst:22
msgid ""
"|CL| updates are based on a rolling release that can occur daily, up to a"
" few times per week. Each release has a unique version number that "
"identifies every component in the OS from kernel, to driver, to tool, to "
"GUI application. Most components are included in entities called "
"*bundles*."
msgstr "|CL| 更新基于每周最多发生几次的滚动发行。每个发行版都有唯一的版本号,用于标识操作系统中的每个组件,包括内核、驱动程序、工具和 GUI 应用程序。大部分组件都包含在称为捆绑包的实体中。"
#: ../../about.rst:28
msgid "Updates"
msgstr "更新"
#: ../../about.rst:30
msgid ""
"By default, |CL| automatically checks for updates, ensuring that the "
"latest performance and security fixes are installed as soon as they are "
"available. :ref:`swupd-guide` is the custom tool designed to manage "
"updates and bundles."
msgstr "默认情况下,|CL| 会自动检查更新,以确保尽快安装可用的最新性能修补程序和安全修补程序。:ref:`swupd-guide` 是设计用于管理更新和捆绑包的自定义工具。"
#: ../../about.rst:34
msgid ""
"|CL| is :ref:`stateless` to make sure that system components can be "
"updated without impacting user settings."
msgstr "|CL| :ref:`stateless`,以确保可以更新系统组件而不影响用户设置。"
#: ../../about.rst:39
msgid "Ease of Use"
msgstr "易用性"
#: ../../about.rst:41
msgid "|CL| makes it easier to manage a number of difficult problems."
msgstr "使用 |CL| 可以更轻松地管理许多难题。"
#: ../../about.rst:43
msgid ""
":ref:`autoproxy` makes it possible for |CL| tools to operate in some "
"proxy environments without needing to be configured."
msgstr ":ref:`autoproxy` 使 |CL| 工具无需进行配置便可在某些代理环境中运行。"
#: ../../about.rst:46
msgid ""
"Being :ref:`stateless` means that configuration settings are easier to "
"manage and remain untouched when system sofware is updated."
msgstr ":ref:`stateless` 意味着更新系统软件时,配置设置更容易管理并且保持不变。"
#: ../../about.rst:49
msgid ""
":ref:`swupd-guide` simplifies managing software and maintaining "
"compatibility."
msgstr ":ref:`swupd-guide` 简化了软件管理和兼容性维护。"
#: ../../about.rst:52
msgid "Custom Derivatives"
msgstr "自定义衍生工具"
#: ../../about.rst:54
msgid ""
"The same tools used to build the |CL| are available *in* the OS. These "
"tools can be used to create a custom distribution that continues to "
"benefit from upstream rolling releases."
msgstr "操作系统中提供了用于生成 |CL| 的相同工具。这些工具可用于创建自定义分发版,以持续从上游滚动发行获益。"
#: ../../about.rst:63
msgid ""
"Figure 1: Creating and managing a Clear Linux\\* OS version (or "
"derivative)"
msgstr "图 1:创建和管理 Clear Linux\\* 操作系统版本(或衍生工具)"
#: ../../about.rst:66
msgid "Create"
msgstr "创建"
#: ../../about.rst:68
msgid ""
"To create a custom distribution you need to understand how to use the "
":ref:`autospec` and :ref:`mixer` tools."
msgstr "要创建自定义分发版,您需要了解如何使用 :ref:`autospec` 和 :ref:`mixer` 工具。"
#: ../../about.rst:71
msgid ""
"Additional training materials are available in the `how-to-clear`_ "
"GitHub\\* project to help you get started with |CL| tools."
msgstr "`how-to-clear`_ GitHub\\* 项目中提供了其他培训材料,可帮助您开始使用 |CL| 工具。"
#: ../../about.rst:75
msgid "Deploy"
msgstr "部署"
#: ../../about.rst:77
msgid "We also provide training on how to :ref:`deploy-at-scale`."
msgstr "我们还提供有关如何 :ref:`deploy-at-scale` 的培训。"
#: ../../about.rst:80
msgid "Administrate"
msgstr "管理"
#: ../../about.rst:82
msgid ""
"|CL| provides a :ref:`telem-guide` solution for collecting useful "
"information about a deployment, as well as :ref:`debug` capabilities."
msgstr "|CL| 提供了用于收集有关部署的有用信息的 :ref:`telem-guide` 解决方案,还提供了 :ref:`debug` 功能。"
+32
View File
@@ -0,0 +1,32 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../disclaimers.rst:7
msgid "Disclaimer"
msgstr ""
#: ../../disclaimers.rst:9
msgid ""
"This documentation is a work in progress and is being provided for "
"informative purposes only. Because it is a work in progress, there are "
"parts that are either missing or will be revised as code development "
"continues."
msgstr ""
@@ -0,0 +1,20 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff
@@ -0,0 +1,247 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 17:23-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../get-started/bootable-usb.rst:4
msgid "Create a bootable USB drive"
msgstr "创建可引导 U 盘"
#: ../../get-started/bootable-usb.rst:6
msgid ""
"Follow the instructions applicable to your system to create a bootable "
"|CL-ATTR| USB drive:"
msgstr "按照适用于您的系统的说明创建可引导的 |CL-ATTR| U 盘:"
#: ../../get-started/bootable-usb.rst:9
msgid ":ref:`bootable-usb-linux`"
msgstr ":ref:`bootable-usb-linux`"
#: ../../get-started/bootable-usb.rst:10
msgid ":ref:`bootable-usb-mac`"
msgstr ":ref:`bootable-usb-mac`"
#: ../../get-started/bootable-usb.rst:11
msgid ":ref:`bootable-usb-windows`"
msgstr ":ref:`bootable-usb-windows`"
#: ../../get-started/bootable-usb.rst:14
msgid "Prerequisites"
msgstr "必备条件"
#: ../../get-started/bootable-usb.rst:16
msgid "Use an **8GB** or larger USB drive."
msgstr "使用 8 GB 或以上的 U 盘。"
#: ../../get-started/bootable-usb.rst:17
msgid ""
"Download the |CL| live boot image or interactive installer image from the"
" `Downloads`_ page."
msgstr "从 `Downloads`_ 页下载 |CL| 实时引导映像或交互式安装程序映像。"
#: ../../get-started/bootable-usb.rst:23
msgid "Create a bootable USB drive on Linux\\*"
msgstr "在 Linux\\* 上创建可引导 U 盘"
#: ../../get-started/bootable-usb.rst:25 ../../get-started/bootable-usb.rst:110
#: ../../get-started/bootable-usb.rst:169
msgid "Make sure you have completed all `Prerequisites`_."
msgstr "确保完成所有 `Prerequisites`_。"
#: ../../get-started/bootable-usb.rst:27
msgid ""
"Before burning the image onto your USB drive, :ref:`verify-linux` on "
"Linux."
msgstr "将映像烧录至 U 盘之前,在 Linux 上 :ref:`verify-linux`。"
#: ../../get-started/bootable-usb.rst:30 ../../get-started/bootable-usb.rst:115
#: ../../get-started/bootable-usb.rst:174
msgid "Burn the |CL| image onto a USB drive"
msgstr "将 |CL| 映像烧录至 U 盘"
#: ../../get-started/bootable-usb.rst:34 ../../get-started/bootable-usb.rst:119
#: ../../get-started/bootable-usb.rst:178
msgid ""
"Burning an image formats the USB drive, and will destroy all pre-existing"
" content. Back up your data before proceeding."
msgstr "烧录映像会格式化 U 盘,清除所有已经存在的内容。在继续操作前请备份数据。"
#: ../../get-started/bootable-usb.rst:37
msgid "Open a terminal emulator and get root privilege."
msgstr "打开终端模拟器,获取 root 权限。"
#: ../../get-started/bootable-usb.rst:43 ../../get-started/bootable-usb.rst:124
msgid "Go to the directory with the decompressed image."
msgstr "转到解压缩映像所在的目录。"
#: ../../get-started/bootable-usb.rst:45
msgid "Plug in the USB drive."
msgstr "插入 U 盘。"
#: ../../get-started/bootable-usb.rst:47
msgid ""
"Identify the USB drive using the :command:`lsblk` command. This shows all"
" drives attached to the system, including the primary hard disk. In the "
"example output below, there are 4 drives (`/dev/sda`, `/dev/sdb`, "
"`/dev/sdc`, and `/dev/sdd`) attached, where `/dev/sda` is primary drive. "
"The remaining are three USB drives. The output also shows the mounted "
"partitions (under the `MOUNTPOINT` column) for each drive."
msgstr "利用 :command:`lsblk` 命令识别 U 盘。此操作会显示所有连接到系统的驱动器,包括主硬盘。在下面的示例输出中,连接了 4 个驱动器(`/dev/sda`、`/dev/sdb`、`/dev/sdc` 和 `/dev/sdd`),而 `/dev/sda` 为主驱动器。其余三个是 U 盘。输出中还显示了为每个驱动器挂载的分区(在 `MOUNTPOINT` 栏)。"
#: ../../get-started/bootable-usb.rst:59
msgid "Example output:"
msgstr "结果示例:"
#: ../../get-started/bootable-usb.rst:82
msgid ""
"You must unmount a USB drive before burning an image onto it. Note that "
"some Linux distros automatically mount a USB drive when it is plugged in."
" Unmount a USB drive with the :command:`umount` command followed by the "
"device identifier/partition. For example:"
msgstr "在烧录映像之前,必须卸载 U 盘。请注意,某些 Linux 操作系统会在 U 盘插入时自动挂载 U 盘。利用 :command:`umount` 命令卸载 U 盘,命令后面为设备标识符/分区。例如:"
#: ../../get-started/bootable-usb.rst:92
msgid ""
"Burn the image onto the USB drive. The example below burns an "
"uncompressed image onto `<your USB device>`:"
msgstr "将映像烧录至 U 盘。下例将未压缩的映像烧录至 `<your USB device>`"
#: ../../get-started/bootable-usb.rst:101
msgid ""
"Not fully unmounting the USB drive before burning an image could cause "
"file system checksum errors in it. If this happens, burn the image again,"
" ensuring all the USB drive partitions are unmounted first."
msgstr "如果烧录映像前不完全卸载 U 盘,则会导致文件系统校验和错误。如果发生此情况,请再次烧录映像,确保首先卸载所有 U 盘分区。"
#: ../../get-started/bootable-usb.rst:108
msgid "Create a bootable USB drive on macOS\\*"
msgstr "在 macOS\\* 上创建可引导 U 盘"
#: ../../get-started/bootable-usb.rst:112
msgid "Before burning the image onto your USB drive, :ref:`verify-mac` on macOS."
msgstr "将映像烧录至 U 盘之前,在 macOS 上 :ref:`verify-mac`。"
#: ../../get-started/bootable-usb.rst:122
msgid "Launch the Terminal app."
msgstr "启动终端应用。"
#: ../../get-started/bootable-usb.rst:126
msgid "Plug in a USB drive and get its identifier:"
msgstr "插入 U 盘,获取盘符:"
#: ../../get-started/bootable-usb.rst:132
msgid "This will list available disks and their partitions, as shown in Figure 1."
msgstr "此操作会列出可用磁盘及其分区,如图 1 所示。"
#: ../../get-started/bootable-usb.rst:138
msgid "Figure 1: macOS - Get USB drive identifier"
msgstr "图 1macOS - 获取 U 盘盘符"
#: ../../get-started/bootable-usb.rst:140
msgid "Unmount the USB drive identified in the previous step. For example:"
msgstr "卸载上一步中识别的 U 盘。例如:"
#: ../../get-started/bootable-usb.rst:146
msgid ""
"Burn the image onto the drive using the :command:`dd` command. The "
"example below burns an uncompressed image onto `<your USB device>`:"
msgstr "利用 :command:`dd` 命令将映像烧录至驱动器。下例将未压缩的映像烧录至 `<your USB device>`"
#: ../../get-started/bootable-usb.rst:153
msgid ""
"To speed up the imaging process, add an r in front of the disk "
"identifier. For example `/dev/rdisk2`."
msgstr "为加速映像烧录过程,在盘符前面添加一个 ‘r’。例如 `/dev/rdisk2`。"
#: ../../get-started/bootable-usb.rst:156
msgid "Press :kbd:`<CTL>-T` to check imaging progress."
msgstr "按下 :kbd:`<CTL>-T` 查看映像烧录过程。"
#: ../../get-started/bootable-usb.rst:158
msgid "Eject the USB drive."
msgstr "弹出 U 盘。"
#: ../../get-started/bootable-usb.rst:167
msgid "Create a bootable USB drive on Windows\\*"
msgstr "在 Windows\\* 上创建可引导 U 盘"
#: ../../get-started/bootable-usb.rst:171
msgid ""
"Before burning the image onto your USB drive, :ref:`verify-windows` on "
"Windows."
msgstr "将映像烧录至 U 盘之前,在 Windows 上 :ref:`verify-windows`。"
#: ../../get-started/bootable-usb.rst:181
msgid ""
"Download the `Rufus`_ utility to burn the image onto a USB drive. We use "
"Rufus 3.5 here. **Only use the latest version of Rufus**."
msgstr "下载 `Rufus`_ 实用程序以便将映像烧录至 U 盘。此处使用 Rufus 3.5。仅使用最新 Rufus 版本。"
#: ../../get-started/bootable-usb.rst:184
msgid "Plug in the USB drive and open Rufus."
msgstr "插入 U 盘,打开 Rufus。"
#: ../../get-started/bootable-usb.rst:186
msgid "Under `Boot selection`, click the :guilabel:`SELECT` button."
msgstr "在 `Boot selection` 中,点击 :guilabel:`SELECT` 按钮。"
#: ../../get-started/bootable-usb.rst:188
msgid "Find and select the previously extracted |CL| image file."
msgstr "找到并选择此前解压缩的 |CL| 映像文件。"
#: ../../get-started/bootable-usb.rst:190
msgid "Click the :guilabel:`START` button. See Figure 2."
msgstr "点击 :guilabel:`START` 按钮。见图 2。"
#: ../../get-started/bootable-usb.rst:196
msgid "Figure 2: Rufus utility"
msgstr "图 2: Rufus 实用程序"
#: ../../get-started/bootable-usb.rst:198
msgid ""
"When the dialogue appears, select :guilabel:`Write in ISO image mode "
"(Recommended)`. See Figure 3."
msgstr "对话出现时,选择 :guilabel:`Write in ISO image mode (Recommended)`。见图 3。"
#: ../../get-started/bootable-usb.rst:205
msgid "Figure 3: ISOHybrid image detected"
msgstr "图 3:检测到 ISOHybrid 映像"
#: ../../get-started/bootable-usb.rst:207
msgid "Select the Windows taskbar menu for USB and select eject."
msgstr "选择 USB 的 Windows 任务栏菜单并选择“弹出”。"
#~ msgid ""
#~ "Instructions to create a |CL-ATTR| "
#~ "USB drive vary depending on your "
#~ "operating system. Follow the instructions "
#~ "applicable to your system:"
#~ msgstr ""
#~ msgid "`Download`_ the |CL| live boot image or interactive installer image."
#~ msgstr ""
#~ msgid "|CAUTION-BACKUP-USB|"
#~ msgstr "|CAUTION-BACKUP-USB|"
#~ msgid "|CAUTION-UNMOUNT-USB-PARTITIONS|"
#~ msgstr "|CAUTION-UNMOUNT-USB-PARTITIONS|"
@@ -0,0 +1,566 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-09-06 11:29-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0152\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh_Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=1; plural=0\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../get-started/cloud-install/aws-web.rst:4
msgid "|CL-ATTR| on Amazon Web Services\\*"
msgstr "Amazon Web Services\\* 上的 |CL-ATTR|"
#: ../../get-started/cloud-install/aws-web.rst:6
msgid ""
"This tutorial explains how to create and launch a |CL| :abbr:`AMI (Amazon"
" Machine Image)` instance from the :abbr:`AWS\\* (Amazon Web Services)` "
"console and complete the following tasks:"
msgstr ""
"本教程介绍如何通过 :abbr:`AWS\\* (Amazon Web Services)` 控制台创建和启动 |CL| :abbr:`AMI "
"(Amazon Machine Image)` 实例以及完成以下任务:"
#: ../../get-started/cloud-install/aws-web.rst:10
msgid "Locate and select the |CL| OS Basic AMI in the AWS Marketplace."
msgstr "在 AWS Marketplace 中找到并选择 |CL| 操作系统基本 AMI。"
#: ../../get-started/cloud-install/aws-web.rst:11
msgid ""
"Create a new public and private key pair to allow you to connect to your "
"|CL| instance securely."
msgstr "创建新的公钥和私钥对,以便可以安全地连接到 |CL| 实例。"
#: ../../get-started/cloud-install/aws-web.rst:13
msgid "Launch the new |CL| instance and connect to it."
msgstr "启动新的 |CL| 实例并连接到该实例。"
#: ../../get-started/cloud-install/aws-web.rst:14
msgid "Update your instance of |CL| using the :command:`swupd` command."
msgstr "使用 :command:`swupd` 命令更新 |CL| 实例。"
#: ../../get-started/cloud-install/aws-web.rst:15
msgid "Stop the |CL| instance."
msgstr "停止 |CL| 实例。"
#: ../../get-started/cloud-install/aws-web.rst:22
msgid "Prerequisites"
msgstr "必备条件"
#: ../../get-started/cloud-install/aws-web.rst:24
msgid "This tutorial assumes the following statements are true:"
msgstr "本教程假定以下陈述是正确的:"
#: ../../get-started/cloud-install/aws-web.rst:26
msgid ""
"You are using a linux-based system to access AWS and can run "
":command:`SSH` to access the remote |CL| AWS image."
msgstr "您使用基于 linux 的系统访问 AWS,并且可以运行 :command:`SSH` 以访问远程 |CL| AWS 映像。"
#: ../../get-started/cloud-install/aws-web.rst:28
msgid ""
"Your browser puts downloaded files in the :file:`$HOME/Downloads` "
"directory."
msgstr "您的浏览器将下载的文件放在 :file:`$HOME/Downloads` 目录中。"
#: ../../get-started/cloud-install/aws-web.rst:30
msgid ""
"You have already set up an AWS user account and logged into the AWS "
"console."
msgstr "您已设置了 AWS 用户帐户并且已登录到 AWS 控制台。"
#: ../../get-started/cloud-install/aws-web.rst:34
msgid ""
"This tutorial uses a |CL| AMI t2.micro instance that is eligible for the "
"AWS free tier. To learn more about AWS and setting up an account, visit "
"the AWS website at http://aws.amazon.com."
msgstr ""
"本教程使用有资格享受 AWS 免费套餐的 |CL| AMI t2.micro 实例。要了解有关 AWS 和设置帐户的更多信息,请访问 AWS "
"网站,网址为:http://aws.amazon.com。"
#: ../../get-started/cloud-install/aws-web.rst:39
msgid "Locate, select, and launch the |CL| Basic AMI"
msgstr "找到、选择并启动 Clear Linux OS 基本 AMI"
#: ../../get-started/cloud-install/aws-web.rst:41
msgid ""
"Start from your main AWS services console menu in your browser and select"
" the :guilabel:`EC2` text as shown in Figure 1:"
msgstr "在浏览器中从 AWS 服务控制台主菜单开始,然后选择图 1 中所示的 :guilabel:`EC2` 文本:"
#: ../../get-started/cloud-install/aws-web.rst:48
msgid "Figure 1: :guilabel:`AWS Console`"
msgstr "图 1 :guilabel:`AWS Console`"
#: ../../get-started/cloud-install/aws-web.rst:50
msgid "This selection brings up your :guilabel:`EC2 Dashboard` menu."
msgstr "选择此选项将调出 :guilabel:`EC2 Dashboard` 菜单。"
#: ../../get-started/cloud-install/aws-web.rst:52
msgid ""
"To create a new |CL| instance from the :guilabel:`EC2 Dashboard` menu, "
"select the :guilabel:`Launch Instance` button as shown in Figure 2:"
msgstr ""
"要从 :guilabel:`EC2 Dashboard` 菜单创建新的 |CL| 实例,请选择图 2 中所示的 :guilabel:`Launch"
" Instance` 按钮:"
#: ../../get-started/cloud-install/aws-web.rst:59
msgid "Figure 2: :guilabel:`EC2 Dashboard`"
msgstr "图 2 :guilabel:`EC2 Dashboard`"
#: ../../get-started/cloud-install/aws-web.rst:61
msgid ""
"This selection takes you to the :guilabel:`Step 1: Choose an Amazon "
"Machine Image (AMI)` menu."
msgstr "选择此选项将转到 :guilabel:`Step 1: Choose an Amazon Machine Image (AMI)` 菜单。"
#: ../../get-started/cloud-install/aws-web.rst:64
msgid ""
"To find the :guilabel:`Clear Linux OS Basic` AMI in the :guilabel:`Step "
"1: Choose an Amazon Machine Image (AMI)` menu, do the following:"
msgstr ""
"要在 :guilabel:`Step 1: Choose an Amazon Machine Image (AMI)` 菜单中找到 "
":guilabel:`Clear Linux OS Basic` AMI,请执行以下操作:"
#: ../../get-started/cloud-install/aws-web.rst:68
msgid ""
"In the lefthand navigation window, select the :guilabel:`AWS Marketplace`"
" menu item to bring up the search bar to :guilabel:`Search AWS "
"Marketplace Products`."
msgstr ""
"在左侧导航窗口中,选择 :guilabel:`AWS Marketplace` 菜单项以调出搜索栏并转到 :guilabel:`Search "
"AWS Marketplace Products`。"
#: ../../get-started/cloud-install/aws-web.rst:72
msgid ""
"In the search bar, type \"clear linux os\" and press the :kbd:`Enter` key"
" to search for and locate the :guilabel:`Clear Linux OS Basic` AMI."
msgstr ""
"在搜索栏中键入 \"clear linux os\" 并按 :kbd:`Enter` 键,以搜索并找到 :guilabel:`Clear "
"Linux OS Basic` AMI。"
#: ../../get-started/cloud-install/aws-web.rst:75
msgid ""
"Select the :guilabel:`Clear Linux OS Basic` AMI by clicking the "
":guilabel:`Select` button as shown in Figure 3:"
msgstr ""
"通过点击图 3 中所示的 :guilabel:`Select` 按钮,选择 :guilabel:`Clear Linux OS Basic` "
"AMI"
#: ../../get-started/cloud-install/aws-web.rst:82
msgid "Figure 3: :guilabel:`Step 1: Choose AMI`"
msgstr "图 3 :guilabel:`Step 1: Choose AMI`"
#: ../../get-started/cloud-install/aws-web.rst:84
msgid ""
"A pop-up dialog box appears showing you more information about the "
":guilabel:`Clear Linux OS Basic` AMI along with the pricing details for "
"running |CL| on different platform configurations as shown in Figure 4. "
"Select the :guilabel:`Continue` button."
msgstr ""
"此时将出现一个弹出对话框,其中显示有关 :guilabel:`Clear Linux OS Basic` AMI 的更多信息以及使用图 4 "
"中所示的不同平台配置运行 |CL| 的定价详细信息。选择 :guilabel:`Continue` 按钮。"
#: ../../get-started/cloud-install/aws-web.rst:93
msgid "Figure 4: :guilabel:`Clear Linux OS Basic`"
msgstr "图 4 :guilabel:`Clear Linux OS Basic`"
#: ../../get-started/cloud-install/aws-web.rst:95
msgid "The :guilabel:`Choose Instance Type` menu appears as shown in Figure 5."
msgstr "此时将出现图 5 中所示的 :guilabel:`Choose Instance Type` 菜单。"
#: ../../get-started/cloud-install/aws-web.rst:101
msgid "Figure 5: :guilabel:`Choose an Instance Type`"
msgstr "图 5 :guilabel:`Choose an Instance Type`"
#: ../../get-started/cloud-install/aws-web.rst:103
msgid ""
"Select the :guilabel:`t2.micro` type by clicking the box on the left side"
" of the instance and then select the :guilabel:`Review and Launch` button"
" to move to the :guilabel:`Step 7: Review the Instance Launch` menu."
msgstr ""
"通过点击实例左侧的框来选择 :guilabel:`t2.micro` 类型,然后选择 :guilabel:`Review and Launch` "
"按钮以转到 :guilabel:`Step 7: Review the Instance Launch` 菜单。"
#: ../../get-started/cloud-install/aws-web.rst:109
msgid ""
"You can configure the instance details, add additional storage, add tags,"
" and configure the security group before selecting the :guilabel:`Review "
"and Launch` button if you want to further customize this |CL| instance."
msgstr ""
"如果要进一步自定义该 |CL| 实例,您可以在选择 :guilabel:`Review and Launch` "
"按钮之前配置实例详细信息,添加其他存储,添加标记以及配置安全组。"
#: ../../get-started/cloud-install/aws-web.rst:114
msgid ""
"The :guilabel:`Step 7: Review the Instance Launch` menu, shown in Figure "
"6, allows you to :guilabel:`Cancel` the process, return to the "
":guilabel:`Previous` screen to change the configuration or "
":guilabel:`Launch` the instance defined."
msgstr ""
"图 6 中所示的 :guilabel:`Step 7: Review the Instance Launch` 菜单可用于 "
":guilabel:`Cancel` 进程,以及返回到 :guilabel:`Previous` 屏幕以更改配置,或者可用于 "
":guilabel:`Launch` 已定义的实例。"
#: ../../get-started/cloud-install/aws-web.rst:123
msgid "Figure 6: :guilabel:`Step 7: Review the Instance Launch`"
msgstr "图 6 :guilabel:`Step 7: Review the Instance Launch`"
#: ../../get-started/cloud-install/aws-web.rst:125
msgid ""
"Select the :guilabel:`Launch` button. A dialog box appears, as shown in "
"Figure 7, asking you to :guilabel:`Select an existing key pair or create "
"a new pair`."
msgstr ""
"选择 :guilabel:`Launch` 按钮。此时将出现图 7 中所示的对话框,要求您 :guilabel:`Select an "
"existing key pair or create a new pair`。"
#: ../../get-started/cloud-install/aws-web.rst:133
msgid "Figure 7: :guilabel:`Select an existing key pair or create a new pair`"
msgstr "图 7 :guilabel:`Select an existing key pair or create a new pair`"
#: ../../get-started/cloud-install/aws-web.rst:135
msgid "Select the :guilabel:`Create a new key pair` option."
msgstr "选择 :guilabel:`Create a new key pair` 选项。"
#: ../../get-started/cloud-install/aws-web.rst:137
msgid "For the :guilabel:`Key pair name` field, enter `AWSClearTestKey`."
msgstr "对于 :guilabel:`Key pair name` 字段,请输入 `AWSClearTestKey`。"
#: ../../get-started/cloud-install/aws-web.rst:139
msgid ""
"Select the :guilabel:`Download Key Pair` button to download the "
":file:`AWSClearTestKey.pem` to your browser's defined :file:`Downloads` "
"directory."
msgstr ""
"选择 :guilabel:`Download Key Pair` 按钮,以将 :file:`AWSClearTestKey.pem` "
"下载到浏览器中定义的 :file:`Downloads` 目录。"
#: ../../get-started/cloud-install/aws-web.rst:143
msgid ""
"When the file finishes downloading, select the :guilabel:`Launch "
"Instances` button to proceed to the :guilabel:`Launch Status` menu shown "
"in Figure 8."
msgstr ""
"文件下载完成后,选择 :guilabel:`Launch Instances` 按钮以转到图 8 中所示的 :guilabel:`Launch "
"Status` 菜单。"
#: ../../get-started/cloud-install/aws-web.rst:151
msgid "Figure 8: :guilabel:`Launch Status`"
msgstr "图 8 :guilabel:`Launch Status`"
#: ../../get-started/cloud-install/aws-web.rst:153
msgid ""
"Once the :guilabel:`Launch Status` page changes to what is shown in "
"Figure 9, select the :guilabel:`View Instances` button to view your "
":guilabel:`Instances` dashboard."
msgstr ""
":guilabel:`Launch Status` 页面变为图 9 中所示的页面后,选择 :guilabel:`View Instances` "
"按钮以显示 :guilabel:`Instances` 仪表板。"
#: ../../get-started/cloud-install/aws-web.rst:161
msgid "Figure 9: :guilabel:`View Instance`"
msgstr "图 9 :guilabel:`View Instance`"
#: ../../get-started/cloud-install/aws-web.rst:164
msgid "Connect to your Clear Linux OS basic instance"
msgstr "连接到 Clear Linux 操作系统基本实例"
#: ../../get-started/cloud-install/aws-web.rst:166
msgid ""
"Your :guilabel:`Instances` Dashboard is shown in Figure 10 with the new "
"|CL| OS basic instance already selected and in the running state. If "
"there are other instances available, they are also listed but not "
"selected."
msgstr ""
"图 10 中显示了 :guilabel:`Instances` 仪表板和已选择并处于运行状态的新的 |CL| "
"操作系统基本实例。同时也会显示其他可用的实例(如有),但不会选择这些实例。"
#: ../../get-started/cloud-install/aws-web.rst:174
msgid "Figure 10: :guilabel:`Instance Dashboard`"
msgstr "图 10 :guilabel:`Instance Dashboard`"
#: ../../get-started/cloud-install/aws-web.rst:176
msgid ""
"To connect to your running instance, click the :guilabel:`Connect` button"
" located at the top of your dashboard. AWS brings up the pop-up dialog "
"box shown in Figure 11 describing how to connect to your running "
"instance."
msgstr ""
"要连接到正在运行的实例,请点击位于仪表板顶部的 :guilabel:`Connect` 按钮。AWS 将调出图 11 "
"中显示的弹出对话框,该对话框说明了如何连接到正在运行的实例。"
#: ../../get-started/cloud-install/aws-web.rst:186
msgid "Figure 11: :guilabel:`Connect to Your Instance`"
msgstr "图 11 :guilabel:`Connect to Your Instance`"
#: ../../get-started/cloud-install/aws-web.rst:188
msgid ""
"Open a terminal on your system. You should be in your :file:`$HOME` "
"directory."
msgstr "在系统中打开终端。当前应该位于 :file:`$HOME` 目录中。"
#: ../../get-started/cloud-install/aws-web.rst:191
msgid ""
"Copy the previously downloaded keyfile from the :file:`Downloads` "
"directory to the current directory."
msgstr "从 :file:`Downloads` 目录将先前下载的密钥文件复制到当前目录。"
#: ../../get-started/cloud-install/aws-web.rst:198
msgid ""
"Change the attributes of the :file:`AWSClearTestKey.pem` using the "
":command:`chmod` command as instructed in the dialog box shown in Figure "
"11."
msgstr ""
"按照图 11 中显示的对话框中的说明使用 :command:`chmod` 命令更改 :file:`AWSClearTestKey.pem` "
"的属性。"
#: ../../get-started/cloud-install/aws-web.rst:206
msgid ""
"Copy the text highlighted in the :guilabel:`Example:` section that is "
"shown in :ref:`figure 11<fig-aws-web-11>`. Paste the copied text into "
"your terminal, change the text before the `@` sign to the username "
"`clear`, and press the :kbd:`Enter` key to execute the command."
msgstr ""
"复制 :ref:`图 11<fig-aws-web-11>` 中显示的 :guilabel:`Example:` "
"一节中突出显示的文本。将复制的文本粘贴到终端中,将 `@` 符号前面的文本更改为用户名 `clear`,然后按 :kbd:`Enter` "
"键以执行命令。"
#: ../../get-started/cloud-install/aws-web.rst:215
msgid ""
"A message appears on the terminal stating the authenticity of the host "
"can't be established and prompts you with the message:"
msgstr "终端中会显示一条消息,指明无法确定主机的可靠性,并提示以下消息:"
#: ../../get-started/cloud-install/aws-web.rst:224
msgid ""
"Type `yes` and press the :kbd:`Enter` key. Another warning is printed to "
"the terminal and you are now at the command prompt of your new |CL| "
"instance."
msgstr "键入 `yes` 并按 :kbd:`Enter` 键。另一条警告将输出到终端中,现在您位于新的 |CL| 实例的命令提示符中。"
#: ../../get-started/cloud-install/aws-web.rst:234
msgid "Update the |CL| instance"
msgstr "更新 |CL| 实例"
#: ../../get-started/cloud-install/aws-web.rst:236
msgid ""
"Run the :command:`sudo swupd update` command to update the operating "
"system as shown in Figure 12:"
msgstr "运行图 12 中显示的 :command:`sudo swupd update` 命令以更新操作系统:"
#: ../../get-started/cloud-install/aws-web.rst:243
msgid "Figure 12: :guilabel:`sudo swupd update`"
msgstr "图 12 :guilabel:`sudo swupd update`"
#: ../../get-started/cloud-install/aws-web.rst:245
msgid "In this example, we updated from version 18940 to 19100."
msgstr "在此示例中,我们从版本 18940 更新到版本 19100。"
#: ../../get-started/cloud-install/aws-web.rst:248
msgid "Stop the |CL| instance"
msgstr "停止 |CL| 实例"
#: ../../get-started/cloud-install/aws-web.rst:250
msgid ""
"When you are finished using your AWS |CL| instance, you must stop it "
"using the :guilabel:`Instances` dashboard to stop accruing charges. "
"Complete the following steps from the :guilabel:`Instances` dashboard to "
"stop your AWS |CL| instance from running."
msgstr ""
"完成使用 AWS |CL| 实例后,您必须使用 :guilabel:`Instances` 仪表板停止该实例以使费用停止增加。从 "
":guilabel:`Instances` 仪表板完成以下步骤以使 AWS |CL| 实例停止运行。"
#: ../../get-started/cloud-install/aws-web.rst:255
msgid "Select the :guilabel:`Actions` button to bring up a pull-down menu."
msgstr "选择 :guilabel:`Actions` 按钮以调出下拉菜单。"
#: ../../get-started/cloud-install/aws-web.rst:257
msgid "Select the :guilabel:`Instance State` menu item to expand the options."
msgstr "选择 :guilabel:`Instance State` 菜单项以展开选项。"
#: ../../get-started/cloud-install/aws-web.rst:259
msgid "Select :guilabel:`Stop` menu item to shut down the running instance."
msgstr "选择 :guilabel:`Stop` 菜单项以关闭正在运行的实例。"
#: ../../get-started/cloud-install/aws-web.rst:261
msgid "Figure 13 illustrates these steps."
msgstr "图 13 说明了这些步骤。"
#: ../../get-started/cloud-install/aws-web.rst:267
msgid "Figure 13: :guilabel:`Stop Instance`"
msgstr "图 13 :guilabel:`Stop Instance`"
#: ../../get-started/cloud-install/aws-web.rst:269
msgid ""
"A pop-up dialog box appears warning you that any ephemeral storage of "
"your instance will be lost. Select the :guilabel:`Yes, Stop` button to "
"stop your |CL| instance."
msgstr "此时将出现一个弹出对话框,警告实例的任何临时存储将丢失。选择 :guilabel:`Yes, Stop` 按钮以停止 |CL| 实例。"
#: ../../get-started/cloud-install/aws-web.rst:277
msgid "Figure 14: :guilabel:`Stop Instances`"
msgstr "图 14 :guilabel:`Stop Instances`"
#: ../../get-started/cloud-install/aws-web.rst:279
msgid ""
"Congratulations! You are up and running with |CL| on AWS. To see what you"
" can do with your |CL| instance, visit our :ref:`tutorials <tutorials>` "
"section for examples on using your |CL| system."
msgstr ""
"恭喜!您已启动并运行基于 AWS 的 |CL|。要查看可对 |CL| 实例执行的操作,请参见 :ref:`教程<tutorials>` "
"一节了解有关使用 |CL| 系统的示例。"
#~ msgid "Create and launch |CL-ATTR| from Amazon Web Services"
#~ msgstr ""
#~ msgid ""
#~ "This tutorial walks you through creating"
#~ " and launching a |CL| :abbr:`AMI "
#~ "(Amazon Machine Image)` instance from "
#~ "the :abbr:`AWS (Amazon Web Services)` "
#~ "console and complete the following "
#~ "tasks:"
#~ msgstr ""
#~ msgid ""
#~ "Start from your main AWS services "
#~ "console menu in your browser and "
#~ "select the :guilabel:`EC2` text as shown"
#~ " in figure 1:"
#~ msgstr ""
#~ msgid ""
#~ "To create a new |CL| instance from"
#~ " the :guilabel:`EC2 Dashboard` menu, select"
#~ " the :guilabel:`Launch Instance` button as"
#~ " shown in figure 2:"
#~ msgstr ""
#~ msgid ""
#~ "In the search bar, type \"clear "
#~ "linux os\" and hit the :kbd:`Enter` "
#~ "key to search for and locate the"
#~ " :guilabel:`Clear Linux OS Basic` AMI."
#~ msgstr ""
#~ msgid ""
#~ "Select the :guilabel:`Clear Linux OS "
#~ "Basic` AMI by clicking on the "
#~ ":guilabel:`Select` button as shown in "
#~ "figure 3:"
#~ msgstr ""
#~ msgid ""
#~ "A pop-up dialog box appears "
#~ "showing you more information about the"
#~ " :guilabel:`Clear Linux OS Basic` AMI "
#~ "along with the pricing details for "
#~ "running |CL| on different platform "
#~ "configurations as shown in figure 4. "
#~ "Select the :guilabel:`Continue` button."
#~ msgstr ""
#~ msgid "The :guilabel:`Choose Instance Type` menu appears as shown in figure 5."
#~ msgstr ""
#~ msgid ""
#~ "The :guilabel:`Step 7: Review the "
#~ "Instance Launch` menu, shown in figure"
#~ " 6, allows you to :guilabel:`Cancel` "
#~ "the process, return to the "
#~ ":guilabel:`Previous` screen to change the "
#~ "configuration or :guilabel:`Launch` the "
#~ "instance defined."
#~ msgstr ""
#~ msgid ""
#~ "Select the :guilabel:`Launch` button. A "
#~ "dialog box appears, as shown in "
#~ "figure 7, asking you to "
#~ ":guilabel:`Select an existing key pair "
#~ "or create a new pair`."
#~ msgstr ""
#~ msgid ""
#~ "When the file finishes downloading, "
#~ "select the :guilabel:`Launch Instances` button"
#~ " to proceed to the :guilabel:`Launch "
#~ "Status` menu shown in figure 8."
#~ msgstr ""
#~ msgid ""
#~ "Once the :guilabel:`Launch Status` page "
#~ "changes to what is shown in figure"
#~ " 9, select the :guilabel:`View Instances`"
#~ " button to view your :guilabel:`Instances`"
#~ " dashboard."
#~ msgstr ""
#~ msgid "Connect to your Clear Linux OS Basic instance"
#~ msgstr ""
#~ msgid ""
#~ "Your :guilabel:`Instances` Dashboard is shown"
#~ " in figure 10 with the new |CL|"
#~ " OS basic instance already selected "
#~ "and in the running state. If there"
#~ " are other instances available, they "
#~ "are also listed but not selected."
#~ msgstr ""
#~ msgid ""
#~ "To connect to your running instance, "
#~ "click the :guilabel:`Connect` button located"
#~ " at the top of your dashboard. "
#~ "AWS brings up the pop-up dialog"
#~ " box shown in figure 11 describing"
#~ " how to connect to your running "
#~ "instance."
#~ msgstr ""
#~ msgid ""
#~ "Change the attributes of the "
#~ ":file:`AWSClearTestKey.pem` using the "
#~ ":command:`chmod` command as instructed in "
#~ "the dialog box shown in figure 11."
#~ msgstr ""
#~ msgid ""
#~ "Type `yes` and hit the :kbd:`Enter` "
#~ "key. Another warning is printed to "
#~ "the terminal and you are now at"
#~ " the command prompt of your new "
#~ "|CL| instance."
#~ msgstr ""
#~ msgid ""
#~ "Run the :command:`sudo swupd update` "
#~ "command to update the operating system"
#~ " as shown in figure 12:"
#~ msgstr ""
#~ msgid "In this example we updated from version 18940 to 19100."
#~ msgstr ""
#~ msgid ""
#~ "When you are finished using your "
#~ "AWS |CL| instance you need to stop"
#~ " it using the :guilabel:`Instances` "
#~ "dashboard to stop accruing charges. "
#~ "Complete the following steps from the"
#~ " :guilabel:`Instances` dashboard to stop "
#~ "your AWS |CL| instance from running."
#~ msgstr ""
@@ -0,0 +1,448 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../get-started/cloud-install/azure.rst:4
msgid "|CL-ATTR| on Microsoft Azure"
msgstr "Microsoft* Azure* 上的 |CL-ATTR|"
#: ../../get-started/cloud-install/azure.rst:6
msgid ""
"|CL-ATTR| is available for you to use in the Microsoft* Azure* "
"marketplace and is offered with three different images, also known as a "
":abbr:`SKU (Stock Keeping Unit)`."
msgstr "|CL-ATTR| 在 Microsoft* Azure* Marketplace 中提供,并且具有三个不同的映像(也称为 :abbr:`SKU(库存单位)`)。"
#: ../../get-started/cloud-install/azure.rst:10
msgid ""
"|CL| Basic - This SKU consists of a bare-bones system which can be used "
"as a starting point for those wanting to explore and build out a system "
"with additional software bundles of their choosing."
msgstr "|CL| 基本 - 此 SKU 包含仅具有基本功能的系统,对于想要探索并使用所选的其他软件捆绑包构建系统的用户来说,此 SKU 可用作起点。"
#: ../../get-started/cloud-install/azure.rst:14
msgid ""
"|CL| Containers - This SKU comes with the containers-basic software "
"bundle already installed."
msgstr "|CL| 容器 - 此 SKU 附带已安装的 containers-basic 软件捆绑包。"
#: ../../get-started/cloud-install/azure.rst:17
msgid ""
"|CL| Machine-learning - This SKU comes pre-loaded with popular open "
"source tools for developing machine learning applications."
msgstr "|CL| 机器学习 - 此 SKU 预加载了用于开发机器学习应用程序的流行开源工具。"
#: ../../get-started/cloud-install/azure.rst:20
msgid ""
"You can access these images directly from your MS Azure dashboard through"
" the `Azure portal`_ or by using the MS Azure :abbr:`CLI (Command Line "
"Interface)` 2.0. If you do not already have an account set up with MS "
"Azure, you can sign up for a `MS Azure free account`_ to access the |CL| "
":abbr:`VM(Virtual Machine)` images."
msgstr "您可以直接从 Microsoft Azure 仪表板通过 `Azure 门户`_ 访问这些映像,也可以使用 Microsoft Azure :abbr:`CLI(命令行接口)` 2.0 来访问。如果您尚未设置 Microsoft Azure 帐户,您可以注册 `Microsoft Azure 免费帐户`_ 以访问 |CL| :abbr:`VM(虚拟机)` 映像。"
#: ../../get-started/cloud-install/azure.rst:26
msgid ""
"The Azure CLI offers the ability to create and manage resources in MS "
"Azure from the command line. In this tutorial you learn to:"
msgstr "Azure CLI 提供了通过命令行在 Microsoft Azure 中创建和管理资源的功能。在本教程中,您将学习:"
#: ../../get-started/cloud-install/azure.rst:29
msgid "Install the latest MS Azure CLI on your |CL| machine."
msgstr "在 |CL| 计算机上安装最新 Microsoft Azure CLI。"
#: ../../get-started/cloud-install/azure.rst:31
msgid "Log into MS Azure using the CLI 2.0 interface."
msgstr "使用 CLI 2.0 接口登录到 Microsoft Azure。"
#: ../../get-started/cloud-install/azure.rst:33
msgid "Create a MS Azure resource group."
msgstr "创建 Microsoft Azure 资源组。"
#: ../../get-started/cloud-install/azure.rst:35
msgid "Locate the |CL| images."
msgstr "找到 |CL| 映像。"
#: ../../get-started/cloud-install/azure.rst:37
msgid "Create and log into the |CL| virtual machine."
msgstr "创建 |CL| 虚拟机并登录到该虚拟机。"
#: ../../get-started/cloud-install/azure.rst:39
msgid "Stop and deallocate the |CL| VM and resources."
msgstr "停止并取消分配 |CL| 虚拟机和资源。"
#: ../../get-started/cloud-install/azure.rst:41
msgid ""
"To use the MS Azure CLI 2.0 on your |CL| system, your system must have "
"the following packages installed:"
msgstr "要在 |CL| 系统中使用 Microsoft Azure CLI 2.0,您的系统必须已安装了以下软件包:"
#: ../../get-started/cloud-install/azure.rst:44
msgid "Python 2.7 or later"
msgstr "Python 2.7 或更高版本"
#: ../../get-started/cloud-install/azure.rst:46
msgid "libffi"
msgstr "libffi"
#: ../../get-started/cloud-install/azure.rst:48
msgid "OpenSSL 1.0.2"
msgstr "OpenSSL 1.0.2"
#: ../../get-started/cloud-install/azure.rst:50
msgid ""
"You can check to see what versions you have installed on your system by "
"running the individual commands as follows:"
msgstr "您可以通过运行如下所示的各个命令来检查系统中已安装的版本:"
#: ../../get-started/cloud-install/azure.rst:78
msgid ""
"If you do not have these packages installed on your |CL| system, install "
"the sysadmin-basic software bundle using the :command:`swupd` command:"
msgstr "如果您的 |CL| 系统中尚未安装这些软件包,请使用 :command:`swupd` 命令安装 sysadmin-basic 软件捆绑包:"
#: ../../get-started/cloud-install/azure.rst:87
msgid ""
"These instructions are for installing the MS Azure CLI 2.0 tools on a "
"|CL| system. If you are installing the CLI on another platform, follow "
"the instructions in the `MS Azure Install Azure CLI tutorial`_ for your "
"specific operating system."
msgstr "这些说明与在 |CL| 系统中安装 Microsoft Azure CLI 2.0 工具相关。如果要在其他平台上安装 CLI,请遵循 `Microsoft Azure 安装 Azure CLI 教程`_ 中针对您的特定操作系统的说明。"
#: ../../get-started/cloud-install/azure.rst:93
msgid "Install MS Azure CLI 2.0 on |CL|"
msgstr "在 |CL| 中安装 Microsoft Azure CLI 2.0"
#: ../../get-started/cloud-install/azure.rst:95
msgid ""
"To install the MS Azure CLI 2.0 on |CL|, use the :command:`curl` command "
"as follows:"
msgstr "要在 |CL| 中安装 Microsoft Azure CLI 2.0,请按如下所示使用 :command:`curl` 命令:"
#: ../../get-started/cloud-install/azure.rst:102
msgid ""
"If you get an error message from :command:`curl` related to the -L "
"parameter or an error message is generated that includes the text "
"\"Object Moved\", use the full URL instead of the aka.ms redirect "
"address:"
msgstr "如果从 :command:`curl` 收到与 -L 参数相关的错误消息,或者生成了包含文本 \"Object Moved\" 的错误消息,请使用完整 URL,而不要使用 aka.ms 重定向地址:"
#: ../../get-started/cloud-install/azure.rst:110
msgid ""
"The installation script begins and prompts you several times during "
"execution for information."
msgstr "安装脚本将开始,并在执行期间多次提示您提供信息。"
#: ../../get-started/cloud-install/azure.rst:115
msgid ""
"The console output from the script displays your username instead of the "
"**[user]** variable shown on this tutorial."
msgstr "脚本的控制台输出会显示您的用户名,而非本教程中显示的 [user] 变量。"
#: ../../get-started/cloud-install/azure.rst:122
msgid ""
"Press the :kbd:`Enter` key to accept the default or you can chose another"
" directory to install the MS Azure CLI 2.0 tools into."
msgstr "按 :kbd:`Enter` 键以接受默认目录,或者也可以选择将 Microsoft Azure CLI 2.0 工具安装到其他目录。"
#: ../../get-started/cloud-install/azure.rst:129
msgid ""
"Press the :kbd:`Enter` key to accept the default or you can chose another"
" directory to install the :command:`az` executable in."
msgstr "按 :kbd:`Enter` 键以接受默认目录,或者也可以选择将 :command:`az` 可执行文件安装到其他目录。"
#: ../../get-started/cloud-install/azure.rst:132
msgid ""
"The installation downloads and builds all required tools and when "
"complete prompts you with:"
msgstr "安装过程会下载并生成所有所需的工具,并在完成后提示以下消息:"
#: ../../get-started/cloud-install/azure.rst:139
msgid "Type :kbd:`Y` and press the :kbd:`Enter` key to allow this modification."
msgstr "键入 :kbd:`Y` 并按 :kbd:`Enter` 键以允许此修改。"
#: ../../get-started/cloud-install/azure.rst:145
msgid ""
"Press the :kbd:`Enter` key to accept the default or enter the pathname to"
" your :file:`.bashrc` file. The installation completes with the final "
"output shown below:"
msgstr "按 :kbd:`Enter` 键以接受默认路径名称,或者将路径名称输入到 :file:`.bashrc` 文件中。安装过程将完成,最终输出如下所示:"
#: ../../get-started/cloud-install/azure.rst:160
msgid ""
"The installation program finishes and you must restart your shell for the"
" changes to take effect. When the installation is successful, run the "
"following command to restart your shell."
msgstr "安装程序将完成,您必须重新启动 shell 以使更改生效。如果安装成功,请运行以下命令以重新启动 shell。"
#: ../../get-started/cloud-install/azure.rst:168
msgid ""
"With the MS Azure CLI 2.0 executable successfully built and installed, "
"run the :command:`az` command."
msgstr "已成功生成并安装 Microsoft Azure CLI 2.0 可执行文件后,运行 :command:`az` 命令。"
#: ../../get-started/cloud-install/azure.rst:175
msgid "The output from the :command:`az` command is shown below:"
msgstr ":command:`az` 命令的输出如下所示:"
#: ../../get-started/cloud-install/azure.rst:254
msgid "Log into your Microsoft Azure account"
msgstr "登录到您的 Microsoft Azure 帐户"
#: ../../get-started/cloud-install/azure.rst:256
msgid ""
"With the :command:`az` command properly installed and functional, login "
"to your MS Azure account using the :command:`az login` command shown "
"below:"
msgstr ":command:`az` 命令已正确安装并且正常工作后,使用如下所示的 :command:`az login` 命令登录到您的 Microsoft Azure 帐户:"
#: ../../get-started/cloud-install/azure.rst:263
msgid "The output from this command is:"
msgstr "该命令的输出如下所示:"
#: ../../get-started/cloud-install/azure.rst:269
msgid ""
"Open your browser and enter the page `https://aka.ms/devicelogin` as "
"shown in figure 1:"
msgstr "打开浏览器并访问图 1 中显示的页面 `https://aka.ms/devicelogin`"
#: ../../get-started/cloud-install/azure.rst:276
msgid "Figure 1: :guilabel:`Microsoft Device Login`"
msgstr "图 1 :guilabel:`Microsoft Device Login`"
#: ../../get-started/cloud-install/azure.rst:278
msgid ""
"Enter the code `BQ9MG442B` to authenticate your device as shown in figure"
" 2. The code `BQ9MG442B` is a random authentication code generated for "
"each session login and will be different each time you log into MS Azure "
"using the :command:`az login` command."
msgstr "输入代码 `BQ9MG442B` 以对设备进行身份验证,如图 2 中所示。代码 `BQ9MG442B` 是为每次会话登录生成的随机身份验证代码,每次使用 :command:`az login` 命令登录到 Microsoft Azure 时生成的代码都不相同。"
#: ../../get-started/cloud-install/azure.rst:287
msgid "Figure 2: :guilabel:`Microsoft Device Login - Azure CLI`"
msgstr "图 2 :guilabel:`Microsoft Device Login - Azure CLI`"
#: ../../get-started/cloud-install/azure.rst:289
msgid ""
"Once you enter the authentication code, the website changes to a screen "
"to enter your existing Microsoft Azure credentials."
msgstr "输入身份验证代码后,网站将变为用于输入现有 Microsoft Azure 凭据的屏幕。"
#: ../../get-started/cloud-install/azure.rst:292
msgid ""
"Log in with your existing MS Azure account credentials. Once complete, "
"the browser screen changes again as shown in figure 3. The screen shows "
"you have signed into the Microsoft Cross-platform Command Line Interface "
"application on your device and you can close the window."
msgstr "使用现有 Microsoft Azure 帐户凭据登录。完成后,浏览器屏幕将再次改变,如图 3 中所示。该屏幕显示您已在设备上登录到 Microsoft 跨平台命令行接口应用程序,您可以关闭窗口。"
#: ../../get-started/cloud-install/azure.rst:301
msgid "Figure 3: :guilabel:`Microsoft Azure Cross-platform CLI`"
msgstr "图 3 :guilabel:`Microsoft Azure Cross-platform CLI`"
#: ../../get-started/cloud-install/azure.rst:303
msgid ""
"The MS Azure CLI 2.0 interface is now active using your existing MS Azure"
" account credentials."
msgstr "Microsoft Azure CLI 2.0 接口现在处于活动状态,并且正在使用现有 Microsoft Azure 帐户凭据。"
#: ../../get-started/cloud-install/azure.rst:307
msgid "Create a MS Azure resource group"
msgstr "创建 Microsoft Azure 资源组"
#: ../../get-started/cloud-install/azure.rst:309
msgid ""
"To learn more about MS Azure resource groups, visit the `Azure Resource "
"Manager overview`_ for an overview and detailed description of resources "
"within MS Azure."
msgstr "要了解有关 Microsoft Azure 资源组的更多信息,请参见 `Azure 资源管理器概述`_ 以查看 Microsoft Azure 中的资源的概述和详细说明。"
#: ../../get-started/cloud-install/azure.rst:313
msgid ""
"To create our new resource group, run the :command:`az group create ...` "
"command shown below to create a resource group named `ClearResourceGroup`"
" using the `-n` parameter and locate it in the `westus` region using the "
"`-l` parameter."
msgstr "要创建新的资源组,请运行如下所示的 :command:`az group create ...` 命令,以使用 `-n` 参数创建名为 `ClearResourceGroup` 的资源组并使用 `-l` 参数将该资源组放置在 `westus` 区域中。"
#: ../../get-started/cloud-install/azure.rst:322
msgid ""
"When the command has completed, the output from this command is similar "
"to the following:"
msgstr "命令完成后,该命令的输出如下所示:"
#: ../../get-started/cloud-install/azure.rst:339
msgid "Create and log into the |CL| virtual machine"
msgstr "创建 |CL| 虚拟机并登录到该虚拟机"
#: ../../get-started/cloud-install/azure.rst:341
msgid "For this tutorial, we are using the |CL| Basic SKU for our VM."
msgstr "在本教程中,我们对虚拟机使用 |CL| 基本 SKU。"
#: ../../get-started/cloud-install/azure.rst:343
msgid ""
"To locate the available |CL| Basic VM SKU images in the MS Azure "
"marketplace, run the :command:`az vm image ...` command:"
msgstr "要在 Microsoft Azure Marketplace 中找到可用的 |CL| 基本虚拟机 SKU 映像,请运行 :command:`az vm image ...` 命令:"
#: ../../get-started/cloud-install/azure.rst:350
msgid ""
"This command may take some time to finish. The output lists all available"
" |CL| Basic images available in the Microsoft Azure marketplace as shown "
"below:"
msgstr "完成该命令可能需要一些时间。输出列出了 Microsoft Azure Marketplace 中提供的所有可用 |CL| 基本映像,如下所示:"
#: ../../get-started/cloud-install/azure.rst:370
msgid ""
"The output list shows current offerings. New versions are added to the MS"
" Azure marketplace all the time. To reference the latest version of an "
"image, you can use the version label `latest` when specifying an image."
msgstr "输出列表显示了当前产品。新版本始终添加到 Microsoft Azure Marketplace。要引用映像的最新版本,您可以在指定映像时使用版本标签 `latest`。"
#: ../../get-started/cloud-install/azure.rst:374
msgid ""
"The information shown in the `Urn` column lists the "
"`Publisher:Offer:Sku:Version` for each image available and this is the "
"information we want to create the |CL| Basic VM. Since we are creating a "
"|CL| Basic VM, highlight the `clear-linux-project:clear-linux-os:basic:` "
"string and copy it to your clipboard. Use the label `latest` instead of "
"referencing a specific version."
msgstr "`Urn` 列中显示的信息列出了每个可用映像的 `Publisher:Offer:Sku:Version`,创建 |CL| 基本虚拟机时需要这些信息。由于我们要创建 |CL| 基本虚拟机,因此突出显示 `clear-linux-project:clear-linux-os:basic:` 字符串并将其复制到剪贴板。请使用标签 `latest`,而不要引用特定版本。"
#: ../../get-started/cloud-install/azure.rst:381
msgid ""
"Create the new |CL| Basic VM. Run the :command:`az vm create ...` command"
" using the URN `:clear-linux-project:clear-linux-os:basic:latest` that we"
" copied to the clipboard on the previous step."
msgstr "创建新的 |CL| 基本虚拟机。使用在上一步复制到剪贴板的 URN `:clear-linux-project:clear-linux-os:basic:latest` 运行 :command:`az vm create ...` 命令。"
#: ../../get-started/cloud-install/azure.rst:391
msgid ""
"If you have already defined your public/private SSH key pair and they are"
" stored in your :file:`$HOME/.ssh` directory, you do not need to include "
"the *--generate-ssh-keys* option."
msgstr "如果您已定义了 SSH 公钥/私钥对,并且它们存储在 :file:`$HOME/.ssh` 目录中,则不需要包括 --generate-ssh-keys 选项。"
#: ../../get-started/cloud-install/azure.rst:395
msgid ""
"Your output from this command will look similar to this output, where "
"[user] is your user name:"
msgstr "该命令的输出类似于以下输出,其中 [user] 是您的用户名:"
#: ../../get-started/cloud-install/azure.rst:416
msgid "Take note of the public IP address from the output."
msgstr "记下输出中的公共 IP 地址。"
#: ../../get-started/cloud-install/azure.rst:418
msgid ""
"Login into the new |CL| Basic VM, run the :command:`ssh` command with the"
" public IP address obtained from the previous step as shown:"
msgstr "登录到新的 |CL| 基本虚拟机,使用在上一步获取的公共 IP 地址运行 :command:`ssh` 命令,如下所示:"
#: ../../get-started/cloud-install/azure.rst:425
msgid ""
"You may see the following message about the authenticity of the host. If "
"this appears, type `yes` to proceed connecting to your new |CL| VM."
msgstr "您可能会看到以下有关主机可靠性的消息。如果出现此消息,请键入 `yes` 以继续连接到新的 |CL| 虚拟机。"
#: ../../get-started/cloud-install/azure.rst:437
msgid ""
"You are now logged into your new |CL| VM as [user], where [user] is your "
"user name. To check which software bundles are included with this VM "
"image, run the :command:`sudo swupd bundle-list` command inside the VM:"
msgstr "您现在已经以 [user] 身份登录到新的 |CL| 虚拟机,其中 [user] 是您的用户名。要检查该虚拟机映像包含哪些软件捆绑包,请在虚拟机中运行 :command:`sudo swupd bundle-list` 命令:"
#: ../../get-started/cloud-install/azure.rst:445
msgid "The output shown should be similar to:"
msgstr "显示的输出如下所示:"
#: ../../get-started/cloud-install/azure.rst:467
msgid ""
"When you are finished using your new |CL| VM, type :command:`exit` to "
"close the :command:`SSH` terminal and logout."
msgstr "完成使用新的 |CL| 虚拟机后,键入 :command:`exit` 以关闭 :command:`SSH` 终端并注销。"
#: ../../get-started/cloud-install/azure.rst:471
msgid "Stop and deallocate the |CL| VM and resources"
msgstr "停止并取消分配 |CL| 虚拟机和资源"
#: ../../get-started/cloud-install/azure.rst:473
msgid ""
"When you finish using your new |CL| instance, you must stop the VM and "
"deallocate the resources in your resource group. If you only stop a VM, "
"the OS image shuts down but the resources associated with it in your "
"resource group remain allocated and incurring charges. For instance, if "
"you stop and then later start the VM using the :command:`az vm start...` "
"without deallocating the resources, the IP address is retained and you "
"can access the VM using that same IP address. To release the resources "
"associated with the VM and stop incurring charges for them, you must "
"deallocate the resources as well."
msgstr "完成使用新的 |CL| 实例后,您必须停止并取消分配资源组中的虚拟机和资源。如果仅停止虚拟机,则操作系统映像将关闭,但资源组中与该虚拟机关联的资源将保持已分配并产生费用。例如,如果您停止虚拟机但未取消分配资源,然后使用 :command:`az vm start...` 启动该虚拟机,则 IP 地址会保留,并且您可以使用该 IP 地址访问虚拟机。要释放与虚拟机关联的资源并使它们停止产生费用,您还必须取消分配这些资源。"
#: ../../get-started/cloud-install/azure.rst:482
msgid ""
"At the command prompt, enter the :command:`az vm stop...` command as "
"follows:"
msgstr "在命令提示符中,输入 :command:`az vm stop...` 命令,如下所示:"
#: ../../get-started/cloud-install/azure.rst:489
msgid "This will stop the VM and then output text similar to:"
msgstr "该命令将停止虚拟机,然后输出如下所示的文本:"
#: ../../get-started/cloud-install/azure.rst:501
msgid ""
"Once the VM stops, deallocate the VM resources to stop incurring charges "
"for the |CL| instance. Enter the following command:"
msgstr "虚拟机停止后,取消分配虚拟机资源以使 |CL| 实例停止产生费用。输入以下命令:"
#: ../../get-started/cloud-install/azure.rst:508
msgid "**Congratulations!**"
msgstr "**恭喜!**"
#: ../../get-started/cloud-install/azure.rst:510
msgid ""
"You are up and running with |CL| on MS Azure using the Azure CLI 2.0 "
"command line tools."
msgstr "您已使用 Azure CLI 2.0 命令行工具启动并运行基于 Microsoft Azure 的 |CL|。"
#: ../../get-started/cloud-install/azure.rst:514
msgid "Next steps"
msgstr "后续步骤"
#: ../../get-started/cloud-install/azure.rst:516
msgid ""
"To see use cases you can fulfill with your |CL| instance, visit our "
":ref:`tutorials <tutorials>` section."
msgstr "要查看使用 |CL| 实例可实现的用例,请参见 :ref:`教程<tutorials>` 一节。"
#: ../../get-started/cloud-install/azure.rst:519
msgid ""
"For additional information visit the |CL| `Azure Partner Mini Case "
"Study`_ and the `Azure Partner Datasheet`_."
msgstr "有关其他信息,请访问 |CL| `Azure 合作伙伴小型案例研究`_ 和 `Azure 合作伙伴数据表`_。"
#: ../../get-started/cloud-install/azure.rst:522
msgid ""
"To learn more about the MS Azure CLI 2.0 tool and options that are "
"available, visit the `MS Azure documentation and tutorials`_ website."
msgstr "要了解有关 Microsoft Azure CLI 2.0 工具和可用选项的更多信息,请访问 `Microsoft Azure 文档和教程`_ 网站。"
#~ msgid "Run |CL-ATTR| using Microsoft Azure CLI 2.0"
#~ msgstr ""
@@ -0,0 +1,462 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../get-started/cloud-install/gce.rst:4
msgid "|CL-ATTR| on Google Cloud Platform\\*"
msgstr "Google Cloud Platform\\* 上的 |CL-ATTR|"
#: ../../get-started/cloud-install/gce.rst:6
msgid ""
"This page explains the steps to create a virtual machine instance of |CL-"
"ATTR| on `Google Cloud Platform`_ (:abbr:`GCP (Google Cloud Platform)`)."
msgstr "本页说明在 `Google Cloud Platform`_ (:abbr:`GCP (Google Cloud Platform)`) 上创建 |CL-ATTR| 虚拟机实例的步骤。"
#: ../../get-started/cloud-install/gce.rst:14
msgid "Prerequisites"
msgstr "必备条件"
#: ../../get-started/cloud-install/gce.rst:16
msgid "Set up a Google account and a GCP billing account."
msgstr "创建 Google 帐户和 GCP 计费帐户。"
#: ../../get-started/cloud-install/gce.rst:18
msgid ""
"Generate and install a user SSH key in the Linux PCs that will connect to"
" the VMs in GCP."
msgstr "在 Linux PC 中生成和安装用户 SSH 密钥。该 PC 将连接至 GCP 中的虚拟机。"
#: ../../get-started/cloud-install/gce.rst:22
msgid "Setup |CL| VM on GCP"
msgstr "在 GCP 上安装 |CL| 虚拟机"
#: ../../get-started/cloud-install/gce.rst:24
msgid ""
"Sign in to your Google\\* account on the `Google Cloud Console "
"<https://console.cloud.google.com/>`_:"
msgstr "在 `Google Cloud Console <https://console.cloud.google.com/>`_ 上登录 Google\\* 帐户。"
#: ../../get-started/cloud-install/gce.rst:31
msgid "Figure 1: Google sign in screen"
msgstr "图 1Google 登录页面"
#: ../../get-started/cloud-install/gce.rst:33
msgid ""
"Google Cloud Platform uses **Projects** to manage resources. Select or "
"create a new project for hosting the |CL| VM."
msgstr "Google Cloud Platform 使用项目管理资源。选择或创建新项目来托管 |CL| 虚拟机。"
#: ../../get-started/cloud-install/gce.rst:38
msgid ""
"Refer to the `Quickstart Using a Linux VM "
"<https://cloud.google.com/compute/docs/quickstart-linux>`_ guide to learn"
" about the process of creating VM instances on GCP."
msgstr "请参阅 `Quickstart Using a Linux VM <https://cloud.google.com/compute/docs/quickstart-linux>`_ 指南,了解在 GCP 上创建虚拟机实例的过程。"
#: ../../get-started/cloud-install/gce.rst:42
msgid ""
"Navigate to the latest |CL| `release folder "
"<https://download.clearlinux.org/releases/current/clear/>`_ to view the "
"currently released :abbr:`GCE (Google Compute Engine\\*)` image, and "
"download the :file:`clear-<release number>-gce.tar.gz` image archive."
msgstr "导航至最新的 |CL| `release folder <https://download.clearlinux.org/releases/current/clear/>`_,查看当前发布的 :abbr:`GCE (Google Compute Engine\\*)` 映像,下载 :file:`clear-<release number>-gce.tar.gz` 映像档案文件。"
#: ../../get-started/cloud-install/gce.rst:48
msgid ""
"You don't need to uncompress the image archive, the intact file will be "
"uploaded to the Google Cloud Storage later."
msgstr "您无需解压缩映像档案文件,完整文件稍后将上传至 Google Cloud Storage。"
#: ../../get-started/cloud-install/gce.rst:51
msgid ""
"Create a *Storage Bucket* for hosting the |CL| image source archive "
"downloaded in the previous step:"
msgstr "创建存储 Bucket 以托管上一步下载的 |CL| 映像源档案文件:"
#: ../../get-started/cloud-install/gce.rst:54
#: ../../get-started/cloud-install/gce.rst:113
#: ../../get-started/cloud-install/gce.rst:159
msgid "Click the :guilabel:`Navigation menu` icon on the upper left screen menu."
msgstr "点击左上部屏幕菜单中的 :guilabel:`Navigation menu` 图标。"
#: ../../get-started/cloud-install/gce.rst:56
msgid ""
"Select the :menuselection:`Storage` item from the sidebar on the left. "
"You will be sent to the Storage Browser tool or the Cloud Storage "
"overview page."
msgstr "从左侧边栏上选择 :menuselection:`存储` 项。此时您将前往 Storage Browser 工具或 Cloud Storage 概览页。"
#: ../../get-started/cloud-install/gce.rst:64
msgid "Figure 2: Browse Google Cloud Storage"
msgstr "图 2:浏览 Google Cloud Storage"
#: ../../get-started/cloud-install/gce.rst:67
msgid ""
"You may need to create a billing account and link to this project before "
"you create a bucket."
msgstr "创建 bucket 之前,最好需要创建一个计费帐户,将其链接至此项目。"
#: ../../get-started/cloud-install/gce.rst:74
msgid "Figure 3: Cloud Storage Browser tool"
msgstr "图 3Cloud Storage 浏览工具"
#: ../../get-started/cloud-install/gce.rst:76
msgid ""
"Click the :guilabel:`CREATE BUCKET` button to enter the bucket creation "
"tool. The bucket name must be unique because buckets in the Cloud Storage"
" share a single global namespace."
msgstr "点击 :guilabel:`CREATE BUCKET` 按钮,进入 bucket 创建工具界面。bucket 的名称必须是唯一的,因为 Cloud Storage 中的所有 bucket 共享一个全局命名空间。"
#: ../../get-started/cloud-install/gce.rst:80
msgid ""
"Leave the remaining options set to the defaults, and click the "
":guilabel:`Create` button at the bottom to create a *Bucket*."
msgstr "其余设置选项保留默认值,然后点击底部的 :guilabel:`Create` 按钮创建 *Bucket*。"
#: ../../get-started/cloud-install/gce.rst:87
msgid "Figure 4: Set bucket name"
msgstr "图 4:设置 bucket 名称"
#: ../../get-started/cloud-install/gce.rst:89
msgid ""
"Once the bucket is created, click the :guilabel:`Upload files` button on "
"the Bucket details page to upload the |CL| GCE image archive to the named"
" bucket:"
msgstr "创建 bucket 后,点击 Bucket 详细资料页上的 :guilabel:`Upload files` 按钮将 |CL| GCE 映像档案文件上传至指定的 bucket:"
#: ../../get-started/cloud-install/gce.rst:97
msgid "Figure 5: Cloud Storage bucket"
msgstr "图 5Cloud Storage bucket"
#: ../../get-started/cloud-install/gce.rst:103
msgid "Figure 6: Uploading the image source archive file"
msgstr "图 6:上传映像源档案文件"
#: ../../get-started/cloud-install/gce.rst:109
msgid "Figure 7: Importing complete"
msgstr "图 7:导入完成"
#: ../../get-started/cloud-install/gce.rst:111
msgid "Browse the Compute Engine Image library page:"
msgstr "浏览 Compute Engine 映像库页:"
#: ../../get-started/cloud-install/gce.rst:115
msgid ""
"Select the :menuselection:`Compute Engine --> Images` from the side bar "
"on the left."
msgstr "从左侧边栏选择 :menuselection:`Compute Engine --> Images`。"
#: ../../get-started/cloud-install/gce.rst:122
msgid "Figure 8: Image library"
msgstr "图 8:映像库"
#: ../../get-started/cloud-install/gce.rst:124
msgid ""
"On the Compute Engine Image library page, click the :guilabel:`[+] CREATE"
" IMAGE` menu item to create a custom image:"
msgstr "在 Compute Engine 映像库页面,点击 :guilabel:`[+] CREATE IMAGE` 菜单项创建定制映像:"
#: ../../get-started/cloud-install/gce.rst:131
msgid "Figure 9: Create image"
msgstr "图 9:创建映像"
#: ../../get-started/cloud-install/gce.rst:133
msgid ""
"In the VM image creation page, change the image source type to *Cloud "
"Storage file*."
msgstr "在虚拟机映像创建页上,将映像源类型更改为 *Cloud Storage 文件*。"
#: ../../get-started/cloud-install/gce.rst:136
msgid "Under :guilabel:`Source`, select :guilabel:`Browse`."
msgstr "在 :guilabel:`Source` 中,选择 :guilabel:`Browse`。"
#: ../../get-started/cloud-install/gce.rst:138
msgid ""
"Locate the :file:`clear-<release number>-gce.tar.gz` file, and click "
":guilabel:`Select`."
msgstr "找到 :file:`clear-<release number>-gce.tar.gz` 文件,然后点击 :guilabel:`Select`。"
#: ../../get-started/cloud-install/gce.rst:145
msgid "Figure 10: Create image using imported object"
msgstr "图 10:利用导入的对象创建映像"
#: ../../get-started/cloud-install/gce.rst:147
msgid ""
"Accept all default options, and click the :guilabel:`Create` button at "
"the bottom to import the Clear Linux GCE image to the image library."
msgstr "接受所有默认选项,然后点击底部的 :guilabel:`Create` 按钮,将 Clear Linux GCE 映像导入映像库。"
#: ../../get-started/cloud-install/gce.rst:154
msgid "Figure 11: Image is created"
msgstr "图 11:映像已创建"
#: ../../get-started/cloud-install/gce.rst:156
msgid ""
"After the |CL| image is imported, you can launch a VM instance running "
"|CL|:"
msgstr "|CL| 映像导入后,可以启动一个运行 |CL| 的虚拟机实例:"
#: ../../get-started/cloud-install/gce.rst:161
msgid ""
"Select :menuselection:`Compute Engine --> VM Instances` from the side bar"
" on the left."
msgstr "从左侧边栏选择 :menuselection:`Compute Engine --> VM instances`。"
#: ../../get-started/cloud-install/gce.rst:168
msgid "Figure 12: VM instances catalog"
msgstr "图 12:虚拟机实例目录"
#: ../../get-started/cloud-install/gce.rst:170
msgid ""
"If no VM instance was created in this project, you will be prompted to "
"create one."
msgstr "如果此项目中没有创建虚拟机实例,系统会提示您创建一个实例。"
#: ../../get-started/cloud-install/gce.rst:173
msgid ""
"Alternatively, click the :guilabel:`CREATE INSTANCE` button on the VM "
"instances page to create a VM instance."
msgstr "另外,也可以点击虚拟机实例页上的 :guilabel:`CREATE INSTANCE` 按钮创建虚拟机实例。"
#: ../../get-started/cloud-install/gce.rst:180
msgid "Figure 13: VM creation"
msgstr "图 13:创建虚拟机"
#: ../../get-started/cloud-install/gce.rst:186
msgid "Figure 14: VM instances list"
msgstr "图 14:虚拟机实例列表"
#: ../../get-started/cloud-install/gce.rst:188
msgid ""
"Under :guilabel:`Region`, choose a region based on the `Best practices "
"for Compute Engine regions selection`_."
msgstr "在 :guilabel:`Region` 中,根据 `Best practices for Compute Engine regions selection`_ 选择一个区域。"
#: ../../get-started/cloud-install/gce.rst:191
msgid "Under :guilabel:`Boot disk`, click the :guilabel:`Change` button."
msgstr "在 :guilabel:`Boot disk` 中,点击 :guilabel:`Change` 按钮。"
#: ../../get-started/cloud-install/gce.rst:197
msgid "Figure 15: Use custom image"
msgstr "图 15:使用定制映像"
#: ../../get-started/cloud-install/gce.rst:199
msgid ""
"Select the :menuselection:`Custom images` tab for using Clear Linux OS "
"GCE image."
msgstr "选择 :menuselection:`Custom images` 标签,以使用 Clear Linux OS GCE 映像。"
#: ../../get-started/cloud-install/gce.rst:205
msgid "Figure 16: Select Clear Linux boot disk to create a VM instance"
msgstr "图 16:选择 Clear Linux 引导磁盘创建虚拟机实例"
#: ../../get-started/cloud-install/gce.rst:207
msgid ""
"Scroll down to the bottom of the VM instance creation page, expand the "
":guilabel:`Management, security, disks, networking, sole tenancy` group."
msgstr "向下滚动至虚拟机实例创建页的底部,展开 :guilabel:`Management, security, disks, networking, sole tenancy` 群组。"
#: ../../get-started/cloud-install/gce.rst:215
msgid "Figure 17: Set up SSH keys"
msgstr "图 17:设置 SSH 密钥"
#: ../../get-started/cloud-install/gce.rst:218
msgid ""
"|CL| does not allow SSH login with a root account by default. As a "
"result, you must configure the VM instance with your SSH public key, so "
"that you are able to access it remotely."
msgstr "|CL| 默认情况下不允许使用 root 帐户进行 SSH 登录。因此,您必须使用 SSH 公共密钥配置虚拟机实例,以便能够远程访问。"
#: ../../get-started/cloud-install/gce.rst:222
msgid "Refer to :ref:`security` for more details."
msgstr "请参考 :ref:`security` 了解详情。"
#: ../../get-started/cloud-install/gce.rst:224
msgid ""
"Click the :menuselection:`Security` tab, copy and paste your SSH public "
"key:"
msgstr "点击 :menuselection:`安全性` 标签,复制并粘贴 SSH 公共密钥:"
#: ../../get-started/cloud-install/gce.rst:230
msgid "Figure 18: Set SSH key for remote login"
msgstr "图 18:设置 SSH 密钥进行远程登录"
#: ../../get-started/cloud-install/gce.rst:234
msgid ""
"The username is assigned from characters preceding ``@`` in the email "
"address, included in the SSH key. The dot symbol \".\" is not allowed, "
"because it is an invalid character while creating user accounts in |CL|."
msgstr "分配的用户名来自电子邮件地址 ``@`` 前面的字符,包含在 SSH 密钥中。不允许使用符号 \".\",因为在 |CL| 中创建用户帐户时它是无效字符。"
#: ../../get-started/cloud-install/gce.rst:239
msgid "Click the :guilabel:`Create` button to create the |CL| VM."
msgstr "点击 :guilabel:`Create` 按钮创建 |CL| 虚拟机。"
#: ../../get-started/cloud-install/gce.rst:241
msgid "The Clear Linux VM instance is created and assigned a public IP address:"
msgstr "Clear Linux 虚拟机实例已创建并分配了一个公共 IP 地址:"
#: ../../get-started/cloud-install/gce.rst:247
msgid "Figure 19: Clear Linux VM instance is created and started"
msgstr "图 19Clear Linux 虚拟机实例已创建并启动"
#: ../../get-started/cloud-install/gce.rst:249
msgid ""
"You can now SSH login to the VM using the IP address obtained in the "
"previous step, and the username associated with the SSH public key:"
msgstr "利用上一步获得的 IP 地址以及与 SSH 公共密钥相关联的用户名,您现在可以通过 SSH 登录虚拟机:"
#: ../../get-started/cloud-install/gce.rst:256
msgid "Figure 20: SSH login to Clear Linux VM"
msgstr "图 20SSH 登录 Clear Linux 虚拟机"
#: ../../get-started/cloud-install/gce.rst:259
msgid "Related topics"
msgstr "相关主题"
#: ../../get-started/cloud-install/gce.rst:261
msgid ":ref:`azure`"
msgstr ":ref:`azure`"
#: ../../get-started/cloud-install/gce.rst:262
msgid ":ref:`aws-web`"
msgstr ":ref:`aws-web`"
#~ msgid ""
#~ "This tutorial walks you through the "
#~ "steps to create a virtual machine "
#~ "instance of |CL-ATTR| on `Google "
#~ "Cloud Platform`_ (:abbr:`GCP (Google Cloud "
#~ "Platform)`)."
#~ msgstr ""
#~ msgid "Process"
#~ msgstr ""
#~ msgid "Click the *Navigation menu* icon on the upper left screen menu."
#~ msgstr ""
#~ msgid ""
#~ "Select the *Storage* item from the "
#~ "side bar on the left. You will "
#~ "be sent to the Storage Browser "
#~ "tool or the Cloud Storage overview "
#~ "page."
#~ msgstr ""
#~ msgid ""
#~ "Click the ``CREATE BUCKET`` button to"
#~ " enter the bucket creation tool. The"
#~ " bucket name must be unique because"
#~ " buckets in the Cloud Storage share"
#~ " a single global namespace."
#~ msgstr ""
#~ msgid ""
#~ "Leave the remaining options set to "
#~ "the defaults, and select the ``Create``"
#~ " button at the bottom to create "
#~ "a *Bucket*."
#~ msgstr ""
#~ msgid ""
#~ "Once the bucket is created, click "
#~ "the ``Upload files`` button on the "
#~ "Bucket details page to upload the "
#~ "|CL| GCE image archive to the "
#~ "named bucket:"
#~ msgstr ""
#~ msgid "Hover your mouse over the *Compute Engine* menu and select *Images*."
#~ msgstr ""
#~ msgid ""
#~ "On the Compute Engine Image library "
#~ "page, click the ``[+] CREATE IMAGE`` "
#~ "menu item to create a custom "
#~ "image:"
#~ msgstr ""
#~ msgid "Under :guilabel:`Cloud Storage file`, select :guilabel:`Browse`."
#~ msgstr ""
#~ msgid ""
#~ "Accept all default options, and click"
#~ " the ``Create`` button at the bottom"
#~ " to import the Clear Linux GCE "
#~ "image to the image library."
#~ msgstr ""
#~ msgid ""
#~ "Hover your mouse over the *Compute "
#~ "Engine* menu group and select the "
#~ "*VM instances* item."
#~ msgstr ""
#~ msgid ""
#~ "Alternatively, click the ``CREATE INSTANCE``"
#~ " button on the VM instances page "
#~ "to create a VM instance."
#~ msgstr ""
#~ msgid ""
#~ "In :guilabel:`Region`, choose a region "
#~ "based on the `Best practices for "
#~ "Compute Engine regions selection`_."
#~ msgstr ""
#~ msgid "Under *Boot disk*, click the ``Change`` button."
#~ msgstr ""
#~ msgid "Select the *Custom images* tab for using Clear Linux OS GCE image."
#~ msgstr ""
#~ msgid ""
#~ "Scroll down to the bottom of the"
#~ " VM instance creation page, expand "
#~ "the *Management, security, disks, networking,"
#~ " sole tenancy* group."
#~ msgstr ""
#~ msgid "Click the *Security* tab, copy and paste your SSH public key:"
#~ msgstr ""
#~ msgid "Click the ``Create`` button to create the |CL| VM."
#~ msgstr ""
#~ msgid ""
#~ "The following tutorials describe a "
#~ "similar process and may be useful "
#~ "references:"
#~ msgstr ""
#~ msgid "Launch |CL-ATTR| Compute Engine on Google Cloud Platform\\*"
#~ msgstr "在 Google Cloud Platform\\* 上启动 |CL-ATTR| Compute Engine"
@@ -0,0 +1,107 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../get-started/compatibility-check.rst:4
msgid "Check processor and EFI firmware compatibility"
msgstr "检查处理器和 EFI 固件的兼容性"
#: ../../get-started/compatibility-check.rst:6
msgid ""
"Before installing |CL-ATTR|, check your host system's processor and EFI "
"firmware compatibility. To check compatibilty, choose one of the "
"following paths:"
msgstr "安装 |CL-ATTR| 之前,检查主机系统的处理器和 EFI 固件兼容性。要检查兼容性,选择如下途径:"
#: ../../get-started/compatibility-check.rst:9
msgid ""
"From a system with a Linux\\* OS installed, follow the instructions to "
":ref:`check-compatibility-steps`."
msgstr "在安装了 Linux\\* 操作系统的系统中,按照说明 :ref:`check-compatibility-steps`。"
#: ../../get-started/compatibility-check.rst:11
msgid ""
"From a non-Linux OS, first :ref:`bare-metal-install-desktop` and then "
"follow the instructions to :ref:`check-compatibility-steps`."
msgstr "在非 Linux 操作系统中,首先 :ref:`bare-metal-install-desktop`,然后按照说明 :ref:`check-compatibility-steps`。"
#: ../../get-started/compatibility-check.rst:15
msgid ""
"This does not check other system components (for example: storage and "
"graphics) for compatibility with |CL|."
msgstr "该操作不会检查其他系统组件(例如:储存和显卡)与 |CL| 的兼容性。"
#: ../../get-started/compatibility-check.rst:21
msgid "Check compatibility"
msgstr "检查兼容性"
#: ../../get-started/compatibility-check.rst:23
msgid "Download the `clear-linux-check-config.sh`_ file."
msgstr "下载 `clear-linux-check-config.sh`_ 文件。"
#: ../../get-started/compatibility-check.rst:25
msgid "If a browser is not available, use:"
msgstr "如果浏览器不可用,使用:"
#: ../../get-started/compatibility-check.rst:31
msgid "Make the script executable."
msgstr "保证脚本可以运行。"
#: ../../get-started/compatibility-check.rst:37
msgid "Run the script."
msgstr "运行脚本。"
#: ../../get-started/compatibility-check.rst:39
msgid ""
"Check to see if the host's processor and EFI firmware is capable of "
"running |CL|."
msgstr "检查主机的处理器和 EFI 固件是否可以运行 |CL|。"
#: ../../get-started/compatibility-check.rst:46
msgid "Check to see if the host is capable of running |CL| in a container."
msgstr "检查主机是否可以在一个容器中运行 |CL|。"
#: ../../get-started/compatibility-check.rst:52
msgid ""
"The script prints a list of test results similar to the output below. All"
" items should return a `SUCCESS` status. This example indicates the "
"host's processor and EFI firmware support running |CL|."
msgstr "脚本会输出测试结果列表,如下所示。所有项应返回 `SUCCESS` 状态。本例表明主机的处理器和 EFI 固件可以支持运行 |CL|。"
#~ msgid ""
#~ "On a system that is currently "
#~ "running a Linux\\* operating system, "
#~ "follow the instructions below to "
#~ "determine if your system's processor and"
#~ " EFI firmware are capable of running"
#~ " |CL-ATTR|. Otherwise, :ref:`bare-metal-"
#~ "install-desktop` and then perform the"
#~ " steps below."
#~ msgstr ""
#~ msgid ""
#~ "The script will print a list of"
#~ " test results similar to the output"
#~ " below. All items should return a "
#~ "`SUCCESS` status. This example indicates "
#~ "the host's processor and EFI firmware"
#~ " support running |CL|."
#~ msgstr ""
@@ -0,0 +1,81 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../get-started/index.rst:4
msgid "Get started"
msgstr "开始使用"
#: ../../get-started/index.rst:6
msgid ""
"The Get Started section guides you through the requirements and "
"installation of |CL-ATTR|. Follow these step-by-step intructions to get "
"started with |CL|, fast."
msgstr "“开始使用”一节引导用户了解 |CL-ATTR| 的要求并完成安装。逐步按照说明操作,快速开始使用 |CL|。"
#: ../../get-started/index.rst:10
msgid "Pre-install"
msgstr "安装前"
#: ../../get-started/index.rst:12
msgid "There are a couple of things to take care of before you install."
msgstr "安装前有一些需要注意的事项。"
#: ../../get-started/index.rst:14
msgid ":ref:`system-requirements`"
msgstr ":ref:`system-requirements`"
#: ../../get-started/index.rst:15
msgid ":ref:`compatibility-check`"
msgstr ":ref:`compatibility-check`"
#: ../../get-started/index.rst:16
msgid ":ref:`bootable-usb`"
msgstr ":ref:`bootable-usb`"
#: ../../get-started/index.rst:18
msgid "When installing |CL-ATTR| in a VM, consider which kernel to use."
msgstr "在虚拟机上安装 |CL-ATTR| 时,考虑使用哪种内核。"
#: ../../get-started/index.rst:20
msgid ":ref:`Compatible VM kernels <vm-kernels>`"
msgstr ":ref:`Compatible VM kernels <vm-kernels>`"
#: ../../get-started/index.rst:30
msgid "Install"
msgstr "安装"
#: ../../get-started/index.rst:42
msgid "Install in a virtual machine"
msgstr "在虚拟机上安装"
#: ../../get-started/index.rst:52
msgid "Deploy to the cloud"
msgstr "部署到云"
#~ msgid ""
#~ "The Get Started section will get "
#~ "you up and running fast with "
#~ "|CL-ATTR|. Use these step-by-step "
#~ "instructions to guide you through the"
#~ " installing |CL| from a live desktop"
#~ " or to a virtual machine."
#~ msgstr ""
@@ -0,0 +1,225 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../get-started/install-configfile.rst:4
msgid "Install using clr-installer and a configuration file"
msgstr "利用 clr-installer 和配置文件安装"
#: ../../get-started/install-configfile.rst:6
msgid ""
"This page explains how to install |CL-ATTR| using the clr-installer tool "
"with a configuration file. The configuration file (:file:`clr-"
"installer.yaml`) can be reused to duplicate the same installation "
"configuration on additional machines."
msgstr "本页说明如何利用 clr-installer 工具和配置文件安装 |CL-ATTR|。配置文件 (:file:`clr-installer.yaml`) 可以重复使用,在其他机器上复制相同的安装配置。"
#: ../../get-started/install-configfile.rst:16
msgid "Prerequisites"
msgstr "必备条件"
#: ../../get-started/install-configfile.rst:18
msgid "Ensure that your target system supports the installation:"
msgstr "确保目标系统支持此安装:"
#: ../../get-started/install-configfile.rst:20
msgid ":ref:`system-requirements`"
msgstr ":ref:`system-requirements`"
#: ../../get-started/install-configfile.rst:21
msgid ":ref:`compatibility-check`"
msgstr ":ref:`compatibility-check`"
#: ../../get-started/install-configfile.rst:24
msgid "Process"
msgstr "流程"
#: ../../get-started/install-configfile.rst:26
msgid ""
"This guide describes two methods for using a configuration file with the "
"clr-installer tool. You can use either method to achieve the same goal. "
"Choose the method that works best for your setup."
msgstr "本指南介绍了利用配置文件和 clr-installer 工具进行安装的两种方法。您可以使用任何一种方法实现同一目标。选择最适合您的方法。"
#: ../../get-started/install-configfile.rst:30
msgid "If you are installing |CL| for the first time, we recommend Example 1."
msgstr "如果您是首次安装 |CL|,我们推荐例 1。"
#: ../../get-started/install-configfile.rst:32
msgid "To clone an existing |CL| setup on another system, we recommend Example 2."
msgstr "要在另一系统上克隆现有的 |CL| 配置,我们推荐例 2。"
#: ../../get-started/install-configfile.rst:35
msgid "Example 1"
msgstr "例 1"
#: ../../get-started/install-configfile.rst:37
msgid ""
"This method uses a configuration file template to perform a new "
"installation."
msgstr "本方法使用配置文件模板执行全新安装。"
#: ../../get-started/install-configfile.rst:39
#: ../../get-started/install-configfile.rst:146
msgid "Perform the following steps:"
msgstr "执行以下步骤:"
#: ../../get-started/install-configfile.rst:41
#: ../../get-started/install-configfile.rst:163
msgid "Go to `Downloads`_ and download the latest Clear Linux OS Server image."
msgstr "转向 `Downloads`_,下载最新的 Clear Linux OS Server 映像。"
#: ../../get-started/install-configfile.rst:43
#: ../../get-started/install-configfile.rst:165
msgid ""
"For example: "
"https://download.clearlinux.org/releases/30010/clear/clear-30010-live-"
"server.iso.xz"
msgstr "例如:https://download.clearlinux.org/releases/30010/clear/clear-30010-live-server.iso.xz"
#: ../../get-started/install-configfile.rst:46
#: ../../get-started/install-configfile.rst:168
msgid "Follow the instructions to :ref:`bootable-usb` based on your OS."
msgstr "按照说明 :ref:`bootable-usb`,因操作系统而异。"
#: ../../get-started/install-configfile.rst:48
#: ../../get-started/install-configfile.rst:170
msgid "Boot up the USB thumb drive."
msgstr "启动 U 盘。"
#: ../../get-started/install-configfile.rst:49
#: ../../get-started/install-configfile.rst:171
msgid "Select :guilabel:`Clear Linux OS` from the menu."
msgstr "从菜单中选择 :guilabel:`Clear Linux OS`。"
#: ../../get-started/install-configfile.rst:50
#: ../../get-started/install-configfile.rst:172
msgid "In the console window, log in as root and set a password."
msgstr "在控制台窗口中,以 root 用户身份登录,然后设置密码。"
#: ../../get-started/install-configfile.rst:51
#: ../../get-started/install-configfile.rst:173
msgid ""
"Verify you have a network connection to the Internet and configure proxy "
"settings if you're working behind a firewall."
msgstr "确认拥有互联网连接,配置代理设置(如果使用防火墙)。"
#: ../../get-started/install-configfile.rst:53
msgid "Download a :file:`live-server.yaml` template."
msgstr "下载 :file:`live-server.yaml` 模板。"
#: ../../get-started/install-configfile.rst:55
msgid "For example:"
msgstr "例如:"
#: ../../get-started/install-configfile.rst:61
msgid "Edit the template and change the settings as needed."
msgstr "根据需要编辑模板,改变设置。"
#: ../../get-started/install-configfile.rst:63
msgid "Commonly-changed settings include:"
msgstr "通常改变的设置包括:"
#: ../../get-started/install-configfile.rst:67
msgid ""
"Under *block-devices*, set “file: \"/dev/sda\"” or enter your preferred "
"device."
msgstr "在块设备中,设置 “file: \"/dev/sda\"” 或输入喜欢的设备。"
#: ../../get-started/install-configfile.rst:68
msgid ""
"Under *targetMedia*, set the third partition size to “0” to use the "
"entire disk space."
msgstr "在 *targetMedia* 中,将第三分区大小设置为 “0”,以使用整个磁盘空间。"
#: ../../get-started/install-configfile.rst:69
msgid "Under *bundles*, add additional bundles as needed."
msgstr "在 bundle 文件部分,根据需要添加其他 bundle 文件。"
#: ../../get-started/install-configfile.rst:70
msgid ""
"Delete the *post-install* section unless you have post-installation "
"scripts."
msgstr "删除安装后部分(除非您有安装后脚本)。 "
#: ../../get-started/install-configfile.rst:71
msgid ""
"Under *Version*, set a version number. To use the latest version, set to "
"“0”."
msgstr "在版本下设置版本号。要使用最新版本,请将版本号设置为 “0”。"
#: ../../get-started/install-configfile.rst:73
msgid ""
"Commonly-changed settings are shown in lines 15, 34, 37, and 51 below. "
"See `Installer YAML Syntax`_ for more details."
msgstr "通常改变的设置在下面的 15、34、37 和 51 行显示。查看 `Installer YAML Syntax`_ 了解详情。"
#: ../../get-started/install-configfile.rst:134
#: ../../get-started/install-configfile.rst:177
msgid "Start the installation with the command:"
msgstr "利用以下命令开始安装:"
#: ../../get-started/install-configfile.rst:141
msgid "Example 2"
msgstr "例 2"
#: ../../get-started/install-configfile.rst:143
msgid ""
"This method uses a saved configuration file from a previous installation,"
" which you can use to easily duplicate the installation on additional "
"machines."
msgstr "此方法使用此前安装中保存的配置文件,可以轻松利用该文件在其他机器上复制安装。"
#: ../../get-started/install-configfile.rst:148
msgid ""
"Open a console window on a system where |CL| was installed to retrieve a "
"copy of the configuration file."
msgstr "在安装 |CL| 的系统上打开控制台窗口,找到配置文件的副本。"
#: ../../get-started/install-configfile.rst:151
msgid "In the console window, log in as root and enter your password."
msgstr "在控制台窗口中,以 root 用户身份登录,输入密码。"
#: ../../get-started/install-configfile.rst:153
msgid ""
"Change directory to :file:`/root` and copy the :file:`clr-installer.yaml`"
" file to a USB thumb drive."
msgstr "将目录更改为 :file:`/root`,然后将 :file:`clr-installer.yaml` 文件复制到 U 盘。"
#: ../../get-started/install-configfile.rst:161
msgid "Start the installation on the target with the following steps:"
msgstr "按照以下步骤在目标设备上开始安装:"
#: ../../get-started/install-configfile.rst:175
msgid ""
"Plug in and mount the USB thumb drive containing the retrieved :file"
":`clr-installer.yaml` configuration file."
msgstr "插入并挂载 U 盘。U 盘中包含找到的 :file:`clr-installer.yaml` 配置文件。"
#: ../../get-started/install-configfile.rst:184
msgid "References"
msgstr "参考"
#: ../../get-started/install-configfile.rst:186
msgid "`Clear Linux Installer`_"
msgstr "`Clear Linux Installer`_"
#: ../../get-started/install-configfile.rst:187
msgid "`Installer YAML Syntax`_"
msgstr "`Installer YAML Syntax`_"
@@ -0,0 +1,165 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../get-started/virtual-machine-install/hyper-v.rst:4
msgid "|CL-ATTR| on Microsoft Hyper-V\\*"
msgstr "Microsoft Hyper-V\\* 上的 |CL-ATTR|"
#: ../../get-started/virtual-machine-install/hyper-v.rst:6
msgid ""
"This page explains how to run |CL-ATTR| inside a `Windows Server "
"Virtualization`_\\* or **Hyper-V** environment."
msgstr "本页说明如何在 `Windows Server Virtualization`_\\* 或 **Hyper-V** 环境中运行 |CL-ATTR|。"
#: ../../get-started/virtual-machine-install/hyper-v.rst:14
msgid "Prerequisites"
msgstr "必备条件"
#: ../../get-started/virtual-machine-install/hyper-v.rst:16
msgid "Enable `Intel® Virtualization Technology`_ (Intel® VT)"
msgstr "启用 `Intel® Virtualization Technology`_ (英特尔® 虚拟化技术)"
#: ../../get-started/virtual-machine-install/hyper-v.rst:18
msgid ""
"Enable `Intel® Virtualization Technology for Directed I/O`_ (Intel® VT-d)"
" in your BIOS/UEFI firmware configuration."
msgstr "在 BIOS/UEFI 固件配置中启用 `Intel® Virtualization Technology for Directed I/O`_ (英特尔® 定向I/O虚拟化技术)。"
#: ../../get-started/virtual-machine-install/hyper-v.rst:22
msgid "Enable Hyper-V"
msgstr "启用 Hyper-V"
#: ../../get-started/virtual-machine-install/hyper-v.rst:24
msgid ""
"Please refer to `Install Hyper-V on Windows 10`_ to enable and configure "
"*Hyper-V* on your machine."
msgstr "请参阅 `Install Hyper-V on Windows 10`_ 以在机器上启用和配置 *Hyper-V*。"
#: ../../get-started/virtual-machine-install/hyper-v.rst:28
msgid "Create a virtual network"
msgstr "创建虚拟网络"
#: ../../get-started/virtual-machine-install/hyper-v.rst:30
msgid ""
"Once *Hyper-V* has been enabled on your Windows system, you will need to "
"create a virtual network in the **Hyper-V Manager**. Refer to the "
"`Create a virtual network`_ documentation to create and configure a "
"virtual network."
msgstr "在 Windows 系统上启用 *Hyper-V* 后,需要在 **Hyper-V Manager** 中创建虚拟网络。请参阅 `Create a virtual network`_ 文档以创建和配置虚拟网络。"
#: ../../get-started/virtual-machine-install/hyper-v.rst:36
msgid "Create a virtual machine"
msgstr "创建虚拟机"
#: ../../get-started/virtual-machine-install/hyper-v.rst:38
msgid ""
"Download and decompress the latest hyperv disk image :file:`clear-XXXXX-"
"hyperv.img.gz`, where XXXXX is the latest available version of |CL| from "
"our `Downloads`_ page."
msgstr "下载和解压缩最新的 hyperv 磁盘映像 :file:`clear-XXXXX-hyperv.img.gz`,其中 XXXXX 是 `Downloads`_ 页上的最新可用 |CL| 版本。"
#: ../../get-started/virtual-machine-install/hyper-v.rst:42
msgid "Create a virtual machine using the **Hyper-V Manager**:"
msgstr "利用 **Hyper-V Manager** 创建虚拟机:"
#: ../../get-started/virtual-machine-install/hyper-v.rst:44
msgid "Choose **Generation 2** when prompted to *specify VM generation*."
msgstr "提示指定虚拟机世代时选择第 2 代。"
#: ../../get-started/virtual-machine-install/hyper-v.rst:45
msgid ""
"Choose **Use an existing virtual hard disk** and browse to find the :file"
":`clear-XXXX-hyperv.vhdx` file."
msgstr "选择使用现有虚拟硬盘,找到 :file:`clear-XXXX-hyperv.vhdx` 文件。"
#: ../../get-started/virtual-machine-install/hyper-v.rst:47
msgid ""
"When finished, open VM settings, select Firmware Section and in Secure "
"Boot config, **uncheck** Enable Secure Boot."
msgstr "完成后,打开虚拟机设置,选择“固件选择”,在“安全引导配置”中取消选中“启用安全引导”。"
#: ../../get-started/virtual-machine-install/hyper-v.rst:50
msgid "Currently, |CL| does not boot with `secure boot` enabled."
msgstr "现在,|CL| 不会通过启用 `secure boot` 来引导。"
#: ../../get-started/virtual-machine-install/hyper-v.rst:53
msgid "Connect to your new VM and start it. You should see a prompt:"
msgstr "连接至新虚拟机并将其启动。系统显示提示:"
#: ../../get-started/virtual-machine-install/hyper-v.rst:59
msgid "Set a root user password."
msgstr "设置 root 用户密码。"
#: ../../get-started/virtual-machine-install/hyper-v.rst:61
msgid "Your virtual machine running |CL| is ready!"
msgstr "运行 |CL| 的虚拟机已准备就绪!"
#~ msgid ""
#~ "This section explains how to run "
#~ "|CL-ATTR| inside a `Windows Server "
#~ "Virtualization`_\\* or **Hyper-V** environment."
#~ msgstr ""
#~ msgid ""
#~ "Please ensure you have enabled `Intel®"
#~ " Virtualization Technology "
#~ "<http://www.intel.com/content/www/us/en/virtualization"
#~ "/virtualization-technology/intel-virtualization-"
#~ "technology.html>`_ (Intel® VT) and `Intel® "
#~ "Virtualization Technology for Directed I/O "
#~ "<https://software.intel.com/en-us/articles/intel-"
#~ "virtualization-technology-for-directed-io-"
#~ "vt-d-enhancing-intel-platforms-for-"
#~ "efficient-virtualization-of-io-devices>`_ "
#~ "(Intel® VT-d) in your BIOS/UEFI firmware"
#~ " configuration."
#~ msgstr ""
#~ msgid ""
#~ "Please refer to the `Microsoft "
#~ "documentation`_ to enable and configure "
#~ "*Hyper-V* on your machine."
#~ msgstr ""
#~ msgid ""
#~ "Once *Hyper-V* has been enabled on "
#~ "your Windows system you will need "
#~ "to create a virtual network in the"
#~ " **Hyper-V Manager**. Refer to the "
#~ "`Create a Virtual Network documentation`_ "
#~ "to create and configure a virtual "
#~ "network."
#~ msgstr ""
#~ msgid ""
#~ "Download and decompress the latest "
#~ "hyperv disk image :file:`clear-XXXXX-"
#~ "hyperv.img.gz`, where XXXXX is the "
#~ "latest available version of |CL| from"
#~ " our `downloads`_ section."
#~ msgstr ""
#~ msgid "Use Hyper-V\\*"
#~ msgstr "使用 Hyper-V\\*"
@@ -0,0 +1,272 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../get-started/virtual-machine-install/kvm.rst:4
msgid "|CL-ATTR| on KVM"
msgstr "KVM 上的 |CL-ATTR|"
#: ../../get-started/virtual-machine-install/kvm.rst:6
msgid ""
"This page explains how to run |CL-ATTR| in a virtualized environment "
"using :abbr:`KVM (Kernel-based Virtual Machine)`."
msgstr "本页说明如何利用 :abbr:`KVM (Kernel-based Virtual Machine)` 在虚拟环境中运行 |CL-ATTR|。"
#: ../../get-started/virtual-machine-install/kvm.rst:14
msgid "Install QEMU-KVM"
msgstr "安装 QEMU-KVM"
#: ../../get-started/virtual-machine-install/kvm.rst:16
msgid ""
"Enable the `Intel® Virtualization Technology`_ (Intel® VT) and the "
"`Intel® Virtualization Technology for Directed I/O`_ (Intel® VT-d) in the"
" host machines BIOS."
msgstr "在主机 BIOS 中启用 `Intel® Virtualization Technology`_ (英特尔® 虚拟化技术) 和 `Intel® Virtualization Technology for Directed I/O`_ (英特尔® 定向I/O虚拟化技术)。"
#: ../../get-started/virtual-machine-install/kvm.rst:20
msgid "Log in and open a terminal emulator."
msgstr "登录并打开终端模拟器。"
#: ../../get-started/virtual-machine-install/kvm.rst:22
msgid "Install `QEMU*-KVM` on the host machine. Below are some example distros."
msgstr "在主机上安装 `QEMU*-KVM`。下面是部分示例操作系统。"
#: ../../get-started/virtual-machine-install/kvm.rst:24
msgid "On |CL|:"
msgstr "在 |CL| 上:"
#: ../../get-started/virtual-machine-install/kvm.rst:30
#: ../../get-started/virtual-machine-install/kvm.rst:159
msgid "On Ubuntu\\* 18.04 LTS Desktop:"
msgstr "在 Ubuntu\\* 18.04 LTS Desktop 上:"
#: ../../get-started/virtual-machine-install/kvm.rst:36
#: ../../get-started/virtual-machine-install/kvm.rst:165
msgid "On Mint\\* 19.1 “Cinnamon” Desktop:"
msgstr "在 Mint\\* 19.1 “Cinnamon” Desktop 上:"
#: ../../get-started/virtual-machine-install/kvm.rst:42
#: ../../get-started/virtual-machine-install/kvm.rst:171
msgid "On Fedora\\* 30 Workstation:"
msgstr "在 Fedora\\* 30 Workstation 上:"
#: ../../get-started/virtual-machine-install/kvm.rst:49
msgid "Download and launch the virtual machine"
msgstr "下载并开启虚拟机"
#: ../../get-started/virtual-machine-install/kvm.rst:51
msgid ""
"Download the latest pre-built |CL| KVM image file from the `image "
"<https://cdn.download.clearlinux.org/image/>`_ directory. Look for "
"``clear-<version>-kvm.img.xz``. You can also use this command:"
msgstr "从 `image <https://cdn.download.clearlinux.org/image/>`_ 目录下载最新的预构建 |CL| KVM 映像。查找 ``clear-<version>-kvm.img.xz``。您还可以使用此命令:"
#: ../../get-started/virtual-machine-install/kvm.rst:59
msgid "Uncompress the downloaded image:"
msgstr "解压缩下载的映像:"
#: ../../get-started/virtual-machine-install/kvm.rst:65
msgid ""
"Download the 3 OVMF files (`OVMF.fd`, `OVMF_CODE.fd`, `OVMF_VARS.fd`) "
"that provides UEFI support for virtual machines."
msgstr "下载 3 个 OVMF 文件(`OVMF.fd`、`OVMF_CODE.fd`、`OVMF_VARS.fd`),为虚拟机提供 UEFI 支持。"
#: ../../get-started/virtual-machine-install/kvm.rst:76
msgid ""
"The default OVMF files from |CL| may not work for some distro version(s)."
" You may get an `ASSERT` in the `debug.log` file when starting the VM. If"
" that is the case, use the distro-specific-OVMF files instead. For "
"example, the |CL| OVMF files work for Ubuntu 18.04 LTS, but not for "
"Ubuntu 19.04 LTS. Installing and using the OVMF files for Ubuntu 19.04 "
"LTS resolved the `ASSERT` issue."
msgstr "|CL| 的默认 OVMF 文件可能并不适用于部分操作系统版本。开启虚拟机时,可能会在 `debug.log` 文件中发现 `ASSERT`。如果出现此情况,则改用因操作系统而异的 OVMF 文件。例如,|CL| OVMF 文件适用于 Ubuntu 18.04 LTS,但不适用于 Ubuntu 19.04 LTS。安装和使用适用于 Ubuntu 19.04 LTS 的 OVMF 文件,解决了 `ASSERT` 问题。"
#: ../../get-started/virtual-machine-install/kvm.rst:82
msgid ""
"Download the `start_qemu.sh`_ script from the `image "
"<https://cdn.download.clearlinux.org/image/>`_ directory. This script "
"will launch the |CL| VM and provide console interaction within the same "
"terminal emulator window."
msgstr "从 `image <https://cdn.download.clearlinux.org/image/>`_ 目录下载 `start_qemu.sh`_ 脚本。此脚本将启动 |CL| 虚拟机,并在同一个终端模拟器窗口中提供控制台交互操作。"
#: ../../get-started/virtual-machine-install/kvm.rst:91
msgid "Make the script executable:"
msgstr "保证脚本可以运行:"
#: ../../get-started/virtual-machine-install/kvm.rst:97
msgid "Start the |CL| KVM virtual machine:"
msgstr "启动 |CL| KVM 虚拟机:"
#: ../../get-started/virtual-machine-install/kvm.rst:103
msgid "Log in as ``root`` user and set a new password."
msgstr "以 ``root`` 用户身份登录,设置新密码。"
#: ../../get-started/virtual-machine-install/kvm.rst:106
msgid "SSH access into the virtual machine"
msgstr "通过 SSH 访问虚拟机"
#: ../../get-started/virtual-machine-install/kvm.rst:108
msgid ""
"To interact with the |CL| VM through SSH instead of the console it was "
"launched from, follow these steps."
msgstr "要通过 SSH 而非开启虚拟机的控制台与 |CL| 虚拟机进行交互,请按照以下步骤操作:"
#: ../../get-started/virtual-machine-install/kvm.rst:111
msgid "Configure SSH in the |CL| VM to allow root login:"
msgstr "在 |CL| 虚拟机中配置 SSH,允许 root 登录:"
#: ../../get-started/virtual-machine-install/kvm.rst:119
msgid "Enable and start SSH server in the |CL| VM:"
msgstr "在 |CL| 虚拟机中启用和启动 SSH 服务器:"
#: ../../get-started/virtual-machine-install/kvm.rst:126
#: ../../get-started/virtual-machine-install/kvm.rst:215
msgid ""
"Determine the IP address of the host on which you will launch the VM. "
"Substitute <ip-addr-of-kvm-host> in the next step with this information."
msgstr "确认将在其上开启虚拟机的托管主机的 IP 地址。下一步中用此信息代替 <ip-addr-of-kvm-host>。"
#: ../../get-started/virtual-machine-install/kvm.rst:133
msgid "SSH into the |CL| VM using the default port of `10022`:"
msgstr "利用默认端口 `10022`,通过 SSH 登录 |CL| 虚拟机:"
#: ../../get-started/virtual-machine-install/kvm.rst:140
msgid "Optional: Add the GNOME Display Manager (GDM)"
msgstr "可选:添加 GNOME Display Manager (GDM)"
#: ../../get-started/virtual-machine-install/kvm.rst:142
msgid ""
"To add :abbr:`GDM (GNOME Display Manager)` to the |CL| VM, follow these "
"steps:"
msgstr "为将 :abbr:`GDM (GNOME Display Manager)` 添加至 |CL| 虚拟机,请按照以下步骤操作:"
#: ../../get-started/virtual-machine-install/kvm.rst:144
msgid "Shutdown the active |CL| VM."
msgstr "关闭运行的 |CL| 虚拟机。"
#: ../../get-started/virtual-machine-install/kvm.rst:150
msgid ""
"Install the Spice viewer on the local host or remote system. Below are "
"some example distros."
msgstr "在本地主机或远程系统上安装 Spice 查看器。下面是部分示例操作系统。"
#: ../../get-started/virtual-machine-install/kvm.rst:153
msgid "On Clear Linux:"
msgstr "在 Clear Linux 上:"
#: ../../get-started/virtual-machine-install/kvm.rst:177
msgid ""
"Modify the :file:`start_qemu.sh` script to increase memory (`-m`), add "
"graphics driver (`-vga`), and add Spice (`-spice`, `-usb`, and `-device`)"
" support."
msgstr "修改 :file:`start_qemu.sh` 脚本,增加内存 (`-m`),添加显卡驱动程序 (`-vga`) 和 Spice`-spice`、`-usb` 和 `-device`)支持。"
#: ../../get-started/virtual-machine-install/kvm.rst:198
msgid ""
"Due to changes in the :file:`start_qemu.sh` script from the previous "
"step, using the same OVMF files will result in the VM not booting "
"properly and you end up in the the UEFI shell. The easiest way to avoid "
"this is to delete the OVMF files and restore the originals before "
"relaunching the VM."
msgstr "由于上一步在 :file:`start_qemu.sh` 脚本中进行了更改,使用同一 OVMF 文件会导致虚拟机不能正常引导,最后进入 UEFI shell 界面。避免这种情况的最简单方法是删除 OVMF 文件,在重启虚拟机前恢复原始文件。"
#: ../../get-started/virtual-machine-install/kvm.rst:203
msgid "Increase the size of the VM by 10GB to accommodate the GDM installation:"
msgstr "将虚拟机大小增加 10GB 以适应 GDM 安装。"
#: ../../get-started/virtual-machine-install/kvm.rst:209
msgid "Relaunch the |CL| VM:"
msgstr "重新启动 |CL| 虚拟机:"
#: ../../get-started/virtual-machine-install/kvm.rst:222
msgid ""
"From the local host or remote system, open a new terminal emulator window"
" and connect into the |CL| VM using the Spice viewer:"
msgstr "从本地主机或远程系统上,打开新的终端模拟器窗口,利用 Spice 查看器连接至 |CL| 虚拟机:"
#: ../../get-started/virtual-machine-install/kvm.rst:229
msgid "Log in as `root` user into the |CL| VM."
msgstr "以 `root` 用户身份登录 |CL| 虚拟机。"
#: ../../get-started/virtual-machine-install/kvm.rst:231
msgid ""
"Follow these steps from :ref:`increase-virtual-disk-size` to resize the "
"partition of the virtual disk of the VM."
msgstr "按照 :ref:`increase-virtual-disk-size` 中的这些步骤,调整虚拟机的虚拟磁盘分区大小。"
#: ../../get-started/virtual-machine-install/kvm.rst:233
msgid "Add GDM to the |CL| VM:"
msgstr "将 GDM 添加至 |CL| 虚拟机:"
#: ../../get-started/virtual-machine-install/kvm.rst:239
msgid "Reboot the |CL| VM to start GDM:"
msgstr "重启 |CL| 虚拟机以启动 GDM"
#: ../../get-started/virtual-machine-install/kvm.rst:245
msgid "Go through the GDM out-of-box experience (OOBE)."
msgstr "进行 GDM 开箱体验 (OOBE)。"
#: ../../get-started/virtual-machine-install/kvm.rst:247
msgid ""
"The default aspect ratio of the GDM GUI for the |CL| VM is 4:3. To change"
" it, use GDM's `Devices > Displays` setting tool (located at the top-"
"right corner)."
msgstr "GDM GUI 针对 |CL| 虚拟机的默认画面比例为 4:3。要改变该比例,请使用 GDM 的 `Devices > Displays` 设置工具(右上角)。"
#~ msgid ""
#~ "This guide explains how to run "
#~ "|CL-ATTR| in a virtualized environment "
#~ "using :abbr:`KVM (Kernel-based Virtual "
#~ "Machine)`."
#~ msgstr ""
#~ msgid ""
#~ "Enable the `Intel® Virtualization Technology`_"
#~ " (Intel® VT) and the `Intel®Virtualization"
#~ " Technology for Directed I/O`_ (Intel® "
#~ "VT-d) in the host machines BIOS."
#~ msgstr ""
#~ msgid ""
#~ "Download the `QEMU-KVM launcher`_ script"
#~ " from the `image "
#~ "<https://cdn.download.clearlinux.org/image/>`_ directory. "
#~ "This script will launch the |CL| "
#~ "VM and provide console interaction "
#~ "within the same terminal emulator "
#~ "window."
#~ msgstr ""
#~ msgid ""
#~ "Follow these steps to `resize the "
#~ "partition`_ of the virtual disk of "
#~ "the VM."
#~ msgstr ""
#~ msgid "Run |CL-ATTR| as a KVM guest OS"
#~ msgstr "运行 |CL-ATTR|,用作 KVM 来宾操作系统"
@@ -0,0 +1,603 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-09-06 11:51-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0152\n"
"Last-Translator: \n"
"Language: zh_Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:4
msgid "|CL-ATTR| on VirtualBox\\*"
msgstr "VirtualBox\\* 上的 |CL-ATTR|"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:6
msgid ""
"This page explains how to create a virtual machine on the `VirtualBox`_ "
"hypervisor with |CL-ATTR| as the guest operating system. These "
"instructions support the |CL| live-server installer to create the |CL| "
"virtual machine (VM)."
msgstr ""
"本页说明如何利用 |CL-ATTR| 在 `VirtualBox`_ 虚拟机管理程序中创建虚拟机,用作来宾操作系统。本说明为 |CL| live-"
"server 安装程序创建 |CL| 虚拟机 (VM) 提供支持。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:15
msgid "Prerequisites"
msgstr "必备条件"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:17
msgid ""
"Enable virtualization, such as `Intel® Virtualization Technology "
"<https://www.intel.com/content/www/us/en/virtualization/virtualization-"
"technology/intel-virtualization-technology.html>`_ (Intel® VT), on the "
"host system from EFI/BIOS."
msgstr "在主机系统上从 EFI/BIOS 启用虚拟化功能,例如 `Intel® "
"Virtualization Technology <https://www.intel.cn/content/www/cn/zh/"
"virtualization/virtualization-technology/"
"intel-virtualization-technology.html>`_ (英特尔® 虚拟化技术)。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:20
msgid ""
"Download and install |VB| **version 6.0 or later** from `VirtualBox`_ "
"using the `VirtualBox Installation Instructions`_ for your platform."
msgstr ""
"使用适用于您的平台的 `VirtualBox Installation Instructions`_,从 `VirtualBox`_ 下载并安装 "
"|VB| 6.0 或更高版本。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:25
msgid "Download and extract the |CL| installer ISO"
msgstr "下载并解压缩 |CL| 安装程序 ISO"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:27
msgid ""
"Download the :file:`clear-<VERSION>-live-server.iso.xz` of |CL| on the "
"`Downloads`_ page."
msgstr "在 `Downloads`_ 页下载 |CL| 的文件 :file:`clear-<VERSION>-live-server.iso.xz`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:30
msgid ""
"Validate the integrity of the downloaded image by checking the file hash "
"and signatures. Refer to :ref:`validate-signatures` for detailed steps."
msgstr "通过检查文件哈希值和签名,验证所下载映像的完整性。参考 :ref:`validate-signatures` 了解详细步骤。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:33
msgid "Decompress the downloaded image."
msgstr "解压缩下载的映像。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:35
msgid ""
"On Windows, you can use `7zip`_ to extract the file by right-clicking the"
" file to *Extract Here* (in the same directory)"
msgstr "在 Windows 系统中,您可以使用 `7zip`_ 解压缩文件,即右键点击文件,然后选择“解压缩到此处”(在相同目录下)"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:42
msgid "Figure 1: 7zip extract here command"
msgstr "图 17zip 的“解压缩到此处”命令"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:44
msgid "On Linux :"
msgstr "Linux 系统:"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:50
msgid "Delete the originally downloaded compressed file."
msgstr "删除最初下载的压缩文件。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:53
msgid "Create a new |VB| virtual machine"
msgstr "创建新的 |VB| 虚拟机"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:55
msgid ""
"A new :abbr:`VM (Virtual Machine)` needs to be created in |VBM| where "
"|CL| will be installed. General instructions for creating a virtual "
"machine and details about using different settings are available in the "
"VirtualBox manual section `Creating Your First Virtual Machine`_."
msgstr ""
"在即将安装 |CL| 的 |VBM| 中需要创建新的 :abbr:`VM (Virtual Machine)`。VirtualBox 指南中的 "
"`Creating Your First Virtual Machine`_ 章节介绍了创建虚拟机的一般说明和使用不同设置的详细信息。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:59
msgid "Launch the |VBM| from your host system."
msgstr "在主机系统上启动 |VBM|。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:61
msgid "Click the :guilabel:`New` button to create a new VM."
msgstr "点击 :guilabel:`New` 按钮创建一个新虚拟机。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:63
msgid "Choose :guilabel:`Expert mode`."
msgstr "选择 :guilabel:`Expert mode`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:65
msgid ""
"On the :guilabel:`Create Virtual Machine` screen, enter the following "
"settings:"
msgstr "在 :guilabel:`Create Virtual Machine` 屏幕上,输入以下设置:"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:67
msgid "**Name**: Choose name (e.g. ClearLinuxOS-VM)."
msgstr "名称:选择名称(例如 ClearLinuxOS-VM)。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:68
msgid "**Type**: Linux"
msgstr "类型:Linux"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:69
msgid "**Version**: **Linux 2.6 / 3.x / 4.x (64-bit)**"
msgstr "版本:Linux 2.6 / 3.x / 4.x64 位)"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:70
msgid "**Hard disk**: `Create a virtual hard disk now`"
msgstr "硬盘: `Create a virtual hard disk now`"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:71
msgid "**Memory size default**: 2048 MB (Adjust appropriately.)"
msgstr "默认内存大小:2048 MB(进行相应调整。)"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:74
msgid ""
"Later, if you want to change the amount of RAM allocated, power down your"
" VM. Return to :file:`Settings > System` and change :guilabel:`Base "
"Memory` to the desired size."
msgstr ""
"以后如果希望更改分配的 RAM 大小,请关闭虚拟机。返回 :file:`Settings > System` 并将 :guilabel:`Base"
" Memory` 更改为想要的大小。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:81
msgid "Figure 2: Create Virtual Machine"
msgstr "图 2:创建虚拟机"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:83
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:98
msgid "Click :guilabel:`Create`."
msgstr "点击 :guilabel:`Create`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:85
msgid "On the :guilabel:`Create Virtual Hard Disk` screen, select:"
msgstr "在 :guilabel:`Create Virtual Hard Disk` 屏幕上,选择:"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:87
msgid "**File location**"
msgstr "**文件位置**"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:88
msgid "**File size**: **32.00 GB**. Adjust size to your needs."
msgstr "文件大小:32.00 GB。根据需要调整大小。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:89
msgid "**Hard disk file type**: `VDI (VirtualBox Disk Image)`"
msgstr "硬盘文件类型: `VDI (VirtualBox Disk Image)`"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:90
msgid "**Storage on physical hard disk**: `Dynamically allocated`"
msgstr "物理硬盘存储: `Dynamically allocated`"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:96
msgid "Figure 3: Create Virtual Hard Disk"
msgstr "图 3:创建虚拟硬盘"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:100
msgid "A new virtual machine will be created and appear in the |VBM|."
msgstr "新的虚拟机将创建完成并出现在 |VBM| 中。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:102
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:218
msgid "Click :guilabel:`Settings` to configure the |CL| VM."
msgstr "点击 :guilabel:`Settings` 配置 |CL| 虚拟机。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:104
msgid "In the left-hand menu, navigate to the :menuselection:`System` menu."
msgstr "在左侧菜单中,导航至 :menuselection:`系统` 菜单。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:106
msgid ""
"On the :guilabel:`Motherboard` tab, select the :guilabel:`Chipset` menu, "
"and then select :menuselection:`ICH9`. See Figure 4."
msgstr ""
"在 :guilabel:`Motherboard` 标签上,选择 :guilabel:`Chipset` 菜单,然后选择 "
":menuselection:`ICH9`。参见图 4。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:111
msgid ""
"You can select which chipset will be presented to the virtual machine. "
"Consult the `VM VirtualBox User Manual`_ for more details."
msgstr "您可以为虚拟机选择芯片组。查阅 `VM VirtualBox User Manual`_ 了解详情。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:114
msgid "In :guilabel:`Enabled Features`, check these boxes:"
msgstr "在 :guilabel:`Enabled Features` 中,选中以下方框:"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:116
msgid "**Enable I/O APIC**"
msgstr "**启用 I/O APIC**"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:117
msgid "**Enable EFI (special OSes only)**"
msgstr "**启用 EFI(仅适用于特殊操作系统)**"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:123
msgid "Figure 4: Settings > System"
msgstr "图 4: 设置 > 系统"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:127
msgid ""
"By default, only 1 virtual CPU is allocated to the new VM. Consider "
"increasing the number of virtual processors allocated to the virtual "
"machine under Settings > System > Processor for increased performance."
msgstr "默认情况下,只为新的虚拟机分配 1 个虚拟 CPU。可在“设置”>“系统”>“处理器”中考虑增加分配给虚拟机的虚拟处理器数量,以提高性能。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:132
msgid "Click :guilabel:`OK`."
msgstr "点击 :guilabel:`OK`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:135
msgid "Install |CL| on the |VB| VM"
msgstr "在 |VB| 虚拟机上安装 |CL|。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:137
msgid "|CL| is ready to be installed."
msgstr "|CL| 现在已准备好安装。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:140
msgid "Mount the installation ISO"
msgstr "挂载安装 ISO"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:142
msgid ""
"The |CL| installer ISO needs to be mounted as a virtual CD-ROM on the VM "
"before powering the VM on."
msgstr "|CL| 安装程序 ISO 必须在虚拟机上作为虚拟 CD-ROM 挂载,然后才能打开虚拟机。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:145
msgid ""
"From the *ClearLinux-OS* :guilabel:`Settings` menu at left, select "
":guilabel:`Storage`."
msgstr "从左边的 *ClearLinux-OS* :guilabel:`Settings` 菜单选择 :guilabel:`Storage`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:148
msgid ""
"From :guilabel:`Storage Devices`, middle column, click the blue disk "
"labeled :guilabel:`Empty`."
msgstr "从 :guilabel:`Storage Devices` 中间栏上,点击标记为 :guilabel:`Empty` 的蓝色盘。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:151
msgid ""
"From the :guilabel:`Attributes` menu, click the blue CD disk next to the "
":guilabel:`Optical Drive` drop down menu and click :guilabel:`Choose "
"Virtual Optical Disk File...`"
msgstr ""
"从 :guilabel:`Attributes` 菜单点击 :guilabel:`Optical Drive` 下拉菜单旁边的蓝色 CD "
"盘,然后点击 :guilabel:`Choose Virtual Optical Disk File...`"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:159
msgid "Figure 5: Choose Virtual Optical Disk Drive"
msgstr "图 5:选择虚拟光盘驱动器"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:161
msgid ""
"Where there appears :guilabel:`Please choose a virtual optical disk "
"file`, select the ISO file and click *Open*."
msgstr "显示 :guilabel:`Please choose a virtual optical disk file` 后,选择 ISO 文件并点击打开。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:168
msgid "Figure 6: Mounting an ISO"
msgstr "图 6:挂载 ISO"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:170
msgid "Click :guilabel:`OK` to exit and return to the main |VBM|."
msgstr "点击 :guilabel:`OK` 退出,返回主 |VBM|。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:173
msgid "Install |CL| with live-server installer"
msgstr "利用 live-server 安装程序安装 |CL|"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:175
msgid ""
"In the |VBM|, select virtual machine you created and click "
":guilabel:`Start`."
msgstr "在 |VBM| 中,选择您创建的虚拟机,点击 :guilabel:`Start`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:181
msgid "Figure 7: Start the installer"
msgstr "图 7:启动安装程序"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:185
msgid ""
"To release the mouse cursor from the VM console window, press the right "
":kbd:`Ctrl` key on the keyboard."
msgstr "要从虚拟机控制台窗口释放鼠标光标,按下键盘右边的 :kbd:`Ctrl` 键。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:188
msgid ""
"When :guilabel:`Clear Linux Installer` in boot manager appears, select "
":kbd:`Enter`. Do not install the bundle `desktop-autostart`."
msgstr ""
"引导管理器中出现 :guilabel:`Clear Linux Installer` 时,选择 :kbd:`回车`。不要安装 bundle 文件 "
"`desktop-autostart`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:191
msgid ""
"Follow the steps in :ref:`bare-metal-install-server` to install |CL| onto"
" the VM virtual disk. Note:"
msgstr "按照 :ref:`bare-metal-install-server` 中的步骤,将 |CL| 安装在虚拟机的虚拟磁盘上。注:"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:194
msgid ""
"In :guilabel:`Configure Installation Media`, navigate top VBOX HARDDISK, "
"and then select :guilabel:`Confirm`."
msgstr ""
"在 :guilabel:`Configure Installation Media` 中,导航至顶级 VBOX HARDDISK,然后选择 "
":guilabel:`Confirm`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:197
msgid ""
"In :menuselection:`Advanced options --> Manage User`, create an "
"administrative user."
msgstr "在 :menuselection:`高级选项 --> 管理用户` 中,创建一个管理员用户。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:200
msgid "Do not install the bundle `desktop-autostart`."
msgstr "不要安装 bundle 文件 `desktop-autostart`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:202
msgid "When |CL| installation is complete, click :guilabel:`Exit`."
msgstr "完成 |CL| 安装后,点击 :guilabel:`Exit`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:204
msgid "At the prompt, enter:"
msgstr "根据提示输入:"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:211
msgid "Unmount the ISO"
msgstr "卸载 ISO"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:213
msgid ""
"The |CL| installer ISO needs to be unmounted to allow the VM to boot from"
" the virtual hard disk."
msgstr "需要卸载 |CL| 安装程序 ISO,以便从虚拟硬盘引导虚拟机。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:216
msgid "Return to the |VBM|."
msgstr "返回 |VBM|。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:220
msgid ""
"From the VM :guilabel:`Settings` window, navigate to the "
":guilabel:`Storage` pane in the left menu."
msgstr "从虚拟机 :guilabel:`Settings` 窗口,导航至左侧菜单的 :guilabel:`Storage` 窗格。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:223
msgid ""
"From the middle :guilabel:`Storage Devices` column, click the blue CD "
"disk labeled :guilabel:`clear-<VERSION>-live-server.iso` under the "
":guilabel:`Controller: IDE`."
msgstr ""
"从 :guilabel:`Storage Devices` 中间栏上,点击 :guilabel:`Controller: IDE` 下面标注为 "
":guilabel:`clear-<VERSION>-live-server.iso` 的蓝色 CD 盘。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:227
msgid ""
"From the :guilabel:`Attributes` column on the right, in "
":guilabel:`Optical Drive`, select the blue CD icon beside and click "
":guilabel:`Remove Disk from Virtual Drive`."
msgstr ""
"在 :guilabel:`Attributes` 右边的 :guilabel:`Optical Drive` 栏中,选择旁边的蓝色 CD "
"图标,点击 :guilabel:`Remove Disk from Virtual Drive`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:235
msgid "Figure 8: Remove Disk from Virtual Drive"
msgstr "图 8:从虚拟驱动器中取出磁盘"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:237
msgid ""
"Click :guilabel:`OK` to exit the :guilabel:`VM Settings` menu and return "
"to the main |VBM|."
msgstr "点击 :guilabel:`OK` 退出 :guilabel:`VM Settings` 菜单,返回主 |VBM|。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:241
msgid "Install |VB| Linux Guest Additions"
msgstr "安装 |VB| Linux Guest Additions"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:243
msgid ""
"|CL| provides Linux Guest Additions drivers for full compatibility using "
"an install script in the **kernel-lts** (Long Term Support) bundle by "
"|CL|."
msgstr ""
"|CL| 利用其 **kernel-lts** (长期支持)bundle 中的安装脚本为 Linux Guest Additions "
"驱动程序提供完全的兼容性。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:246
msgid "From the |VBM| select the |CL| VM, and select :guilabel:`Start`."
msgstr "从 |VBM| 中选择 |CL| 虚拟机,然后选择 :guilabel:`Start`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:248
msgid "In the VM Console, log in as the administrative user previously created."
msgstr "在虚拟机控制台上,以先前创建的管理员用户身份登录。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:251
msgid ""
"A message may appear: \"A kernel update is available: you may wish to "
"reboot the system.\""
msgstr ""
"随机会显示一条消息:\"A kernel update is available: you may wish to reboot the "
"system.\""
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:254
msgid "To update the kernel, enter:"
msgstr "要更新内核,请输入:"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:260
msgid "At initial login, enter the administrative user's password and continue."
msgstr "初次登录时,请输入管理员用户的密码,然后继续。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:262
msgid ""
"Validate the installed kernel is **kernel-lts** by checking the output of"
" the :command:`uname -r` command. It should end in **.lts** or "
"**.lts2018**."
msgstr ""
"查看 :command:`uname -r` 命令的输出结果,验证安装的内核为 **kernel-lts**。它的结尾应该为 **.lts** 或"
" **.lts2018**。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:270
msgid ""
"If the running kernel is not **lts**: install the LTS kernel manually, "
"update the bootloader, and check again:"
msgstr "如果运行的内核不是 **lts**:手动安装 LTS 内核,更新引导启动程序,然后再次检查:"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:280
msgid ""
"Remove any kernel bundles that do not end in *-lts* or *kernel-install* "
"to simplify and avoid conflicts:"
msgstr "移除任何结尾不是 *-lts* 或 *kernel-install* 的内核 bundle,简化和避免冲突:"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:288
msgid ""
"In the VM Console top menu, click :guilabel:`Devices`, and select "
":guilabel:`Insert Guest Additions CD image...` to mount the |VB| driver "
"installation to the |CL| VM."
msgstr ""
"在虚拟机控制台顶级菜单中,点击 :guilabel:`Devices`,然后选择 :guilabel:`Insert Guest "
"Additions CD image...`,在 |CL| 虚拟机上挂载 |VB| 驱动程序安装。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:296
msgid "Figure 9: Insert Guest Additions CD image"
msgstr "图 9:插入 Guest Additions CD 映像"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:298
msgid ""
"If a dialogue appears, \"VBx_GAs_6.0.8... Would you like to run it?\", "
"select :guilabel:`Cancel`."
msgstr ""
"如果出现对话 \"VBx_GAs_6.0.8...Would you like to run it?\",选择 "
":guilabel:`Cancel`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:301
msgid "Instead, we provide a script to patch and install |VB| drivers on |CL|."
msgstr "我们提供脚本在 |CL| 上安装 |VB| 驱动程序和修补程序。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:303
msgid "Open a Terminal and enter the script:"
msgstr "打开终端,输入脚本:"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:311
msgid ""
"Successful installation shows: \"Guest Additions installation complete\"."
" If drivers are already installed, don't re-install them."
msgstr "成功安装后显示:\"Guest Additions installation complete\"。如果驱动程序已经安装,不要重复安装。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:314
msgid "Shut down the system. Select :menuselection:`Machine --> ACPI Shutdown`."
msgstr "关闭系统。选择 :menuselection:`机器 --> ACPI 关机`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:320
msgid "Figure 10: Powering off a VirtualBox VM"
msgstr "图 10:关闭 VirtualBox 虚拟机"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:322
msgid "Select :guilabel:`Settings`, :guilabel:`Display`."
msgstr "选择 :guilabel:`Settings` :guilabel:`Display`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:324
msgid ""
"In :guilabel:`Graphics Controller`, select :guilabel:`VBoxSVGA` to adjust"
" screen size dynamically."
msgstr "在 :guilabel:`Graphics Controller` 中,选择 :guilabel:`VBoxSVGA`,以便动态调整屏幕大小。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:331
msgid "Figure 11: VirtualBox hardware acceleration error"
msgstr "图 11VirtualBox 硬件加速错误"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:333
msgid "In the |VBM|, select :guilabel:`Start`."
msgstr "在 |VBM| 中,选择 :guilabel:`Start`。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:335
msgid "In the VM console, login and verify the |VB| drivers are loaded:"
msgstr "在虚拟机控制台上,登录并确认 |VB| 驱动程序已加载。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:341
msgid ""
"You should see drivers loaded with names beginning with **vbox**: (e.g., "
"vboxvideo, vboxguest)."
msgstr "此时,应该会看到以 **vbox** 开头的驱动程序(例如 vboxvideo、vboxguest)已加载。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:344
msgid "Add `desktop-autostart` for a full desktop experience."
msgstr "添加 `desktop-autostart` 获得完整的桌面体验。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:350
msgid "Reboot the VM and log in with the administrative user."
msgstr "重启虚拟机,以管理员用户身份登录。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:356
msgid "The |CL| VM running on |VB| is ready to develop and explore."
msgstr "|VB| 上运行的 |CL| 虚拟机准备就绪,可供开发和探索。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:359
msgid "Troubleshooting"
msgstr "故障检修"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:361
msgid ""
"**Problem:** On a Microsoft\\* Windows\\* OS, |VB| encounters an error "
"when trying to start a VM indicating *VT-X/AMD-v hardware acceleration is"
" not available on your system.*"
msgstr ""
"问题: 在 Microsoft\\* Windows\\* 操作系统上,尝试开启虚拟机时 |VB| 发生错误,出现消息:系统不支持 "
"VT-X/AMD-v 硬件加速。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:369
msgid "Figure 12: VirtualBox hardware acceleration error"
msgstr "图 12VirtualBox 硬件加速错误"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:371
msgid ""
"**Solution:** First, double check the `Prerequisites`_ section to make "
"sure *Hardware accelerated virtualization* extensions have been enabled "
"in the host system's EFI/BIOS."
msgstr "解决方法:首先仔细检查 `Prerequisites`_ 部分,确保主机系统的 EFI/BIOS 中启用了经过硬件加速的虚拟化扩展。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:375
msgid ""
"*Hardware accelerated virtualization*, may get disabled for |VB| when "
"another hypervisor, such as *Hyper-V* is enabled."
msgstr "启用另一个管理程序(如 *Hyper-V*)后,|VB| 应禁用经过硬件加速的虚拟化。"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:378
msgid ""
"To disable *Hyper-V* execute this command in an **Administrator: Command "
"Prompt or Powershell**, and reboot the system:"
msgstr "要禁用 *Hyper-V*,在管理员:命令提示符或 Powershell 中执行此命令,然后重启系统:"
#: ../../get-started/virtual-machine-install/virtualbox-cl-installer.rst:385
msgid ""
"To enable Hyper-V again, execute this command in an **Administrator: "
"Command Prompt or Powershell**, and reboot the system:"
msgstr "要再次启用 Hyper-V,在管理员:命令提示符或 Powershell 中执行此命令,然后重启系统:"
#~ msgid "Install a |CL-ATTR| VM in VirtualBox\\*"
#~ msgstr "在 VirtualBox\\* 中安装 |CL-ATTR| 虚拟机"
#~ msgid ""
#~ "Enable virtualization, such as `Intel® "
#~ "Virtualization Technology`_ (Intel® VT), on"
#~ " the host system from EFI/BIOS."
#~ msgstr ""
#~ "在主机系统上从 EFI/BIOS 启用虚拟化功能,例如 `Intel® "
#~ "Virtualization Technology`_ (英特尔® VT)。"
@@ -0,0 +1,677 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:4
msgid "|CL-ATTR| on VMware\\* Workstation Player (pre-configured image)"
msgstr "VMware\\* Workstation Player (预配置映像)上的 |CL-ATTR|"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:6
msgid ""
"This page explains how to deploy a pre-configured |CL| VMware image on "
"`VMware Workstation 14 Player`_."
msgstr "本页说明如何在 `VMware Workstation 14 Player`_ 上部署预配置的 |CL| VMware 映像。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:14
msgid "Overview"
msgstr "概述"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:16
msgid ""
"VMware Workstation 14 Player is a type 2 hypervisor. For example, it runs"
" on top of Windows\\* or Linux\\* operating system. With VMware ESXi, you"
" can create, configure, manage, and run |CL-ATTR| :abbr:`VMs (Virtual "
"Machines)` on your local system."
msgstr "VMware Workstation 14 Player 是一个类型 2 的管理程序。例如,它可以运行在 Windows\\* 之上或 Linux\\* 操作系统。使用 VMware ESXi,可以创建,配置,管理和本地系统上运行 |CL-ATTR| :abbr:`VMs (Virtual Machines)`。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:23
msgid ""
"Screenshots in this document show VMware Workstation 14 Player for "
"Windows. Menus and prompts in the Linux version have minor wording "
"differences."
msgstr "本文截图采用了 Windows 版 VMware Workstation 14 Player。Linux 版本中的菜单和提示有微小的文字差异。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:28
msgid "Install the VMware Workstation Player hypervisor"
msgstr "安装 VMware Workstation Player 虚拟机管理程序"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:30
msgid ""
"Enable :abbr:`Intel® VT (Intel® Virtualization Technology)` and "
":abbr:`Intel® VT-d (Intel® Virtualization Technology for Directed I/O)` "
"in your system's BIOS."
msgstr "在系统 BIOS 中启用 :abbr:`Intel® VT (Intel® Virtualization Technology)` 和 :abbr:`Intel® VT-d (Intel® Virtualization Technology for Directed I/O)`。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:34
msgid ""
"`VMware Workstation 14 Player`_ is available for Windows and Linux. "
"Download your preferred version."
msgstr "`VMware Workstation 14 Player`_ 有 Windows 和 Linux 版本。下载您喜欢的版本。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:37
msgid ""
"Depending on which OS you're running, install it by following one of "
"these instructions:"
msgstr "根据您的操作系统,安装下述说明安装。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:40
msgid "On supported Linux distros:"
msgstr "在支持的 Linux 操作系统上:"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:42
msgid "Enable a GUI desktop."
msgstr "启用 GUI 桌面:"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:44
msgid "Start a terminal emulator."
msgstr "启动一个终端模拟器。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:46
msgid ""
"Start the installer by issuing the command below and following the guided"
" steps."
msgstr "发出如下命令,按照指引步骤启动安装程序。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:53
msgid "On Windows:"
msgstr "在 Windows 上:"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:55
msgid "Start the installer."
msgstr "启动安装程序。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:56
msgid "Follow the setup wizard."
msgstr "按照安装向导提示操作。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:58
msgid "For additional help, see the `VMware Workstation Player Documentation`_."
msgstr "有关其他帮助,请查看 `VMware Workstation Player Documentation`_。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:61
msgid "Download the latest |CL| VMware image"
msgstr "下载最新的 |CL| VMware 映像"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:63
msgid ""
"Get the latest |CL| VMware image from the `image repository`_. Look for "
":file:`clear-[version number]-vmware.vmdk.xz`. You can also use this "
"command:"
msgstr "从 `image repository`_ 中获取最新的 |CL| VMware 映像。寻找 :file:`clear-[version number]-vmware.vmdk.xz`。您也可以使用这个命令:"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:72
msgid "Decompress and verify the image"
msgstr "解压缩并验证映像"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:74
msgid ""
"Visit :ref:`download-verify-decompress` and follow the instructions for "
"your Windows\\* or Linux\\* environment. Visit :ref:`image-types` for "
"additional information about all available |CL| images."
msgstr "访问 :ref:`download-verify-decompress` 然后按照 Windows\\* 和 Linux\\* 环境的说明进行操作。访问 :ref:`image-types` 有关的所有可用 |CL| 映像的附加信息。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:79
msgid "Create and configure a new VM"
msgstr "创建并配置新虚拟机"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:81
msgid "Start the `VMware Workstation Player` app."
msgstr "启动 `VMware Workstation Player` 应用。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:82
msgid ""
"On the home screen, click :guilabel:`Create a New Virtual Machine`. See "
"figure 1."
msgstr "在主屏幕上,点击 :guilabel:`Create a New Virtual Machine`。见图 1。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:89
msgid "Figure 1: VMware Workstation 14 Player - Create a new virtual machine"
msgstr "图 1VMware Workstation 14 Player - 创建新虚拟机"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:91
msgid ""
"On the :guilabel:`Welcome to the New Virtual Machine Wizard` screen, "
"select the :guilabel:`I will install the operating system later` option. "
"See figure 2."
msgstr "在 :guilabel:`Welcome to the New Virtual Machine Wizard` 屏幕上,选择 :guilabel:`I will install the operating system later` 选项。见图 2。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:99
msgid ""
"Figure 2: VMware Workstation 14 Player - Select install operating system "
"later."
msgstr "图 2VMware Workstation 14 Player - 选择稍后安装操作系统。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:102
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:118
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:129
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:228
msgid "Click the :guilabel:`Next` button."
msgstr "点击 :guilabel:`Next` 按钮。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:104
msgid ""
"On the :guilabel:`Select a Guest Operating System` screen, set the "
":guilabel:`Guest operating system` setting to :guilabel:`Linux`. See "
"figure 3."
msgstr "在 :guilabel:`Select a Guest Operating System` 屏幕上,将 :guilabel:`Guest operating system` 设置为 :guilabel:`Linux`。见图 3。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:112
msgid ""
"Figure 3: VMware Workstation 14 Player - Select guest operating system "
"type"
msgstr "图 3VMware Workstation 14 Player - 选择来宾操作系统类型"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:115
msgid ""
"Set :guilabel:`Version` setting to :guilabel:`Other Linux 3.x or later "
"kernel 64-bit`."
msgstr "将 :guilabel:`Version` 设置为 :guilabel:`Other Linux 3.x or later kernel 64-bit`。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:120
msgid ""
"On the :guilabel:`Name the Virtual Machine` screen, give your new VM a "
"name. See figure 4."
msgstr "在 :guilabel:`Name the Virtual Machine` 屏幕上,为新虚拟机命名。见图 4。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:127
msgid "Figure 4: VMware Workstation 14 Player - Name virtual machine"
msgstr "图 4VMware Workstation 14 Player - 虚拟机命名"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:131
msgid ""
"On the :guilabel:`Specify Disk Capacity` screen, click the "
":guilabel:`Next` button. Keep the default disk settings unchanged. When "
"we attach the pre-configured |CL| VMware image, we will remove the "
"default virtual disk and replace it with the pre-configured one. See "
"figure 5."
msgstr "在 :guilabel:`Specify Disk Capacity` 屏幕上,点击 :guilabel:`Next` 按钮。默认磁盘设置保持不变。挂载预配置的 |CL| VMware 映像时,我们将移除默认虚拟磁盘,用预配置的磁盘来代替。见图 5。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:141
msgid "Figure 5: VMware Workstation 14 Player - Set disk capacity"
msgstr "图 5VMware Workstation 14 Player - 设置磁盘容量"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:143
msgid ""
"On the :guilabel:`Ready to Create Virtual Machine` screen, click the "
":guilabel:`Customize Hardware...` button. See figure 6."
msgstr "在 :guilabel:`Ready to Create Virtual Machine` 屏幕上,点击 :guilabel:`Customize Hardware...` 按钮。见图 6。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:150
msgid "Figure 6: VMware Workstation 14 Player - Customize hardware"
msgstr "图 6VMware Workstation 14 Player - 定制硬件"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:152
msgid ""
"Under the :guilabel:`Device` list, select :guilabel:`Processors`. See "
"figure 7."
msgstr "在 :guilabel:`Device` 列表中,选择 :guilabel:`Processors`。见图 7。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:159
msgid "Figure 7: VMware Workstation 14 Player - Set virtualization engine option"
msgstr "图 7VMware Workstation 14 Player - 设置虚拟化引擎选项"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:162
msgid ""
"Under the :guilabel:`Virtualization engine` section, check "
":guilabel:`Virtualize Intel VT-x/EPT or AMD-V/RVI`."
msgstr "在 :guilabel:`Virtualization engine` 部分,选中 :guilabel:`Virtualize Intel VT-x/EPT or AMD-V/RVI`。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:165
msgid ""
"To disconnect the virtual CD/DVD (IDE) since it is not needed, under the "
":guilabel:`Device` list, select :guilabel:`New CD/DVD (IDE)`. See figure "
"8."
msgstr "如果因不再需要而断开虚拟 CD/DVD (IDE),请在 :guilabel:`Device` 列表中选择 :guilabel:`New CD/DVD (IDE)`。见图 8。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:172
msgid "Figure 8: VMware Workstation 14 Player - Disconnect CD/DVD (IDE)"
msgstr "图 8VMware Workstation 14 Player - 断开 CD/DVD (IDE)"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:174
msgid ""
"Under the :guilabel:`Device status` section, uncheck :guilabel:`Connect "
"at power on`."
msgstr "在 :guilabel:`Device status` 部分,取消选中 :guilabel:`Connect at power on`。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:177
msgid "Click the :guilabel:`Close` button."
msgstr "点击· :guilabel:`Close` 按钮。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:179
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:256
msgid "Click the :guilabel:`Finish` button."
msgstr "点击 :guilabel:`Finish` 按钮。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:182
msgid "Attach the pre-configured |CL| VMware image"
msgstr "挂载预配置的 |CL| Vmware 映像"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:184
msgid ""
"Move the downloaded and decompressed pre-configured |CL| VMware image "
"file :file:`clear-[version number]-basic.vmdk` to the directory where "
"your newly-created VM resides."
msgstr "将下载和解压缩的预配置 |CL| VMware 映像文件 :file:`clear-[version number]-basic.vmdk` 移动至新建虚拟机所在的目录。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:190
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:275
msgid "Depending on the OS, you can typically find the VMware VM files under:"
msgstr "根据操作系统不同,通常可以在如下地址找到 VMware 虚拟机文件:"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:192
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:277
msgid "On Linux distros: :file:`/home/username/vmware`"
msgstr "Linux 操作系统::file:`/home/username/vmware`"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:193
msgid "On Windows: :file:`C:\\Users\\username\\Documents\\Virtual Machines`"
msgstr "Windows:file:`C:\\Users\\username\\Documents\\Virtual Machines`"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:195
msgid ""
"On the :guilabel:`VMware Workstation Player` home screen, select your "
"newly-created VM. See figure 9."
msgstr "在 :guilabel:`VMware Workstation Player` 主屏幕上,选择新创建的虚拟机。见图 9。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:202
msgid "Figure 9: VMware Workstation 14 Player - Edit virtual machine settings"
msgstr "图 9: VMware Workstation 14 Player - 编辑虚拟机设置"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:204
msgid "Click :guilabel:`Edit virtual machine settings`."
msgstr "点击 :guilabel:`Edit virtual machine settings`。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:206
msgid ""
"To remove the default hard disk, under the :guilabel:`Device` list, "
"select :guilabel:`Hard Disk (SCSI)`. See figure 10."
msgstr "要移除默认硬盘,在 :guilabel:`Device` 列表中选择 :guilabel:`Hard Disk (SCSI)`。见图 10."
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:213
msgid "Figure 10: VMware Workstation 14 Player - Remove hard drive"
msgstr "图 10VMware Workstation 14 Player - 移除硬盘"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:215
msgid "Click the :guilabel:`Remove` button."
msgstr "点击 :guilabel:`Remove` 按钮。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:217
msgid ""
"To add a new hard disk and attach the pre-configured |CL| VMware image, "
"click the :guilabel:`Add...` button. See Figure 11."
msgstr "要添加新硬盘并挂载预配置的 |CL| VMware 映像,点击 :guilabel:`Add...` 按钮。见图 11。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:224
msgid "Figure 11: VMware Workstation 14 Player - Add new hard drive"
msgstr "图 11VMware Workstation 14 Player - 添加新硬盘"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:226
msgid ""
"Under the :guilabel:`Hardware types` section, select :guilabel:`Hard "
"Disk`."
msgstr "在 :guilabel:`Hardware types` 部分,选择 :guilabel:`Hard Disk`。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:230
msgid "Select your preferred :guilabel:`Virtual disk type`. See figure 12."
msgstr "选择您喜欢的 :guilabel:`Virtual disk type`。见图 12。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:236
msgid "Figure 12: VMware Workstation 14 Player - Select virtual disk type"
msgstr "图 12VMware Workstation 14 Player - 选择虚拟磁盘类型"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:238
msgid "Select the :guilabel:`Use an existing virtual disk` option. See figure 13."
msgstr "选择 :guilabel:`Use an existing virtual disk` 选项。见图 13。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:244
msgid "Figure 13: VMware Workstation 14 Player - Use existing virtual disk"
msgstr "图 13VMware Workstation 14 Player - 使用现有虚拟磁盘"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:246
msgid ""
"Click the :guilabel:`Browse` button and select the pre-configured |CL| "
"VMware image file. See figure 14."
msgstr "点击 :guilabel:`Browse` 按钮,选择预配置的 |CL| VMware 映像文件。见图 14。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:253
msgid ""
"Figure 14: VMware Workstation 14 Player - Select ready-made VMware |CL| "
"image file"
msgstr "图 14VMware Workstation 14 Player - 选择现成的 VMware |CL| 映像文件"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:260
msgid ""
"When asked to convert the existing virtual disk to a newer format, "
"selecting either option works."
msgstr "要求将现有虚拟磁盘转换为较新的格式时,选择任何一个选项均可。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:264
msgid "Enable UEFI boot support"
msgstr "启用 UEFI 引导支持"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:266
msgid ""
"|CL| needs UEFI support to boot. To enable it, add the following line to "
"the end of your VM's :file:`.vmx` file:"
msgstr "|CL| 需要 UEFI 支持才可以引导。要予以启用,请在虚拟机的 :file:`.vmx` 文件结尾处添加如下行:"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:278
msgid ""
"On Windows: :file:`C:\\\\Users\\\\username\\\\Documents\\\\Virtual "
"Machines`"
msgstr "Windows:file:`C:\\\\Users\\\\username\\\\Documents\\\\Virtual Machines`"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:281
msgid "Power on the VM"
msgstr "开启虚拟机"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:283
msgid "After configuring the settings above, power on your |CL| virtual machine."
msgstr "配置上述设置后,开启 |CL| 虚拟机。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:285
msgid ""
"On the :guilabel:`VMware Workstation Player` home screen, select your VM."
" See figure 15."
msgstr "在 :guilabel:`VMware Workstation Player` 主屏幕上,选择虚拟机。见图 15。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:292
msgid "Figure 15: VMware Workstation 14 Player - Power on virtual machine"
msgstr "图 15VMware Workstation 14 Player - 开启虚拟机"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:294
msgid "Click :guilabel:`Play virtual machine`."
msgstr "点击 :guilabel:`Play virtual machine`。"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:297
msgid "Related topics"
msgstr "相关主题"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:299
msgid "For other guides on using the VMWare Player and ESXi, see:"
msgstr "有关使用 VMWare Player 和 ESXi 的其他指南,请查看:"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:301
msgid ":ref:`vmw-player`"
msgstr ":ref:`vmw-player`"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:302
msgid ":ref:`vmware-esxi-install-cl`"
msgstr ":ref:`vmware-esxi-install-cl`"
#: ../../get-started/virtual-machine-install/vmw-player-preconf.rst:303
msgid ":ref:`vmware-esxi-preconfigured-cl-image`"
msgstr ":ref:`vmware-esxi-preconfigured-cl-image`"
#~ msgid ""
#~ "`VMware Workstation 14 Player`_ is a "
#~ "type 2 hypervisor. It runs on top"
#~ " of another operating system such as"
#~ " Windows\\* or Linux\\*. With VMware "
#~ "ESXi, you can create, configure, manage,"
#~ " and run |CL-ATTR| :abbr:`VMs "
#~ "(Virtual Machines)` on your local "
#~ "system."
#~ msgstr ""
#~ msgid ""
#~ "This section shows how to deploy a"
#~ " pre-configured |CL| VMware image on"
#~ " VMware Workstation 14 Player."
#~ msgstr ""
#~ msgid "In this tutorial, we perform the following steps:"
#~ msgstr ""
#~ msgid ""
#~ "The screenshots on this document show"
#~ " the Windows version of the VMware"
#~ " Workstation 14 Player. The menus and"
#~ " prompts are similar to those in "
#~ "the Linux version save some minor "
#~ "wording differences."
#~ msgstr ""
#~ msgid "For additional help, see the `VMware Workstation Player guide`_."
#~ msgstr ""
#~ msgid "Download the corresponding SHA512 checksum file of your |CL| image."
#~ msgstr ""
#~ msgid ":ref:`download-verify-decompress-mac`"
#~ msgstr ""
#~ msgid ""
#~ "Run pre-configured |CL-ATTR| image "
#~ "as a VMware\\* Workstation Player guest"
#~ " OS"
#~ msgstr "运行预配置的 |CL-ATTR| 映像,用作 VMware\\* Workstation Player 来宾操作系统"
#~ msgid ""
#~ "Visit :ref:`image-types` for additional "
#~ "information about all available |CL| "
#~ "images."
#~ msgstr "访问 :ref:`image-types`,了解关于所有 |CL| 映像的其他信息。"
#~ msgid "Verify the integrity of the |CL| image"
#~ msgstr "确认 |CL| 映像的完整性。"
#~ msgid ""
#~ "Before you use a downloaded |CL| "
#~ "image, verify its integrity. This action"
#~ " eliminates the small chance of a "
#~ "corrupted image due to download issues."
#~ " To support verification, each released "
#~ "|CL| image has a corresponding SHA512"
#~ " checksum file designated with the "
#~ "suffix `-SHA512SUMS`."
#~ msgstr ""
#~ "在使用下载的 |CL| 映像之前,请确认其完整性。本操作消除了由于下载错误导致的罕见映像损坏。为支持确认,每个释放的"
#~ " |CL| 映像均有一个相应的 SHA512 校验和 (checksum) "
#~ "文件,其指定后缀为 `-SHA512SUMS`。"
#~ msgid "Download the corresponding SHA512 checksum file of your |CL| `image`_."
#~ msgstr "下载与您的 |CL| `映像`_ 相应的 SHA512 校验和文件。"
#~ msgid "Start Command Prompt."
#~ msgstr "启动命令提示符。"
#~ msgid "Go to the directory with the downloaded image and checksum files."
#~ msgstr "转到含有下载映像和校验和文件的目录。"
#~ msgid "Get the SHA512 checksum of the image with the command:"
#~ msgstr "利用该命令获取该映像的 SHA512 校验和:"
#~ msgid ""
#~ "Manually compare the output with the "
#~ "original checksum value shown in the "
#~ "downloaded checksum file and make sure"
#~ " they match."
#~ msgstr "手动比较该结果与所下载校验和文件中所示的原始校验和值,确保它们相匹配。"
#~ msgid ""
#~ "Released |CL| images are compressed with"
#~ " either GNU zip (*.gz*) or XZ "
#~ "(*.xz*). The compression type depends on"
#~ " the target platform or environment. "
#~ "To decompress the image, follow these"
#~ " steps:"
#~ msgstr ""
#~ "释放的 |CL| 映像以 GNU zip (*.gz*) 或 "
#~ "XZ (*.xz*) 格式压缩。压缩类型取决于目标平台或环境。要解压映像,应遵循这些步骤:"
#~ msgid "Download and install `7-Zip`_."
#~ msgstr "下载并安装 `7-Zip`_。"
#~ msgid "Go to the directory with the downloaded image and right-click it."
#~ msgstr "转到含有下载映像的目录并右键点击它。"
#~ msgid ""
#~ "From the pop-up menu, select "
#~ ":guilabel:`7-Zip` and select :guilabel:`Extract "
#~ "Here` as shown in Figure 1."
#~ msgstr "从弹出菜单中选择 :guilabel:`7-Zip`,然后选择 :guilabel:`Extract Here`,如图 1 所示。"
#~ msgid "Figure 1: Windows 7-Zip extract file."
#~ msgstr "图 1Windows 7-Zip 提取文件。"
#~ msgid "Image types"
#~ msgstr "映像类型"
#~ msgid ""
#~ "Table 1 lists the currently available"
#~ " images that are platform independent. "
#~ "Table 2 lists the currently available"
#~ " images that are platform specific."
#~ msgstr "表 1 列出了当前可用的独立于平台的映像。表 2 列出了当前可用的特定于平台的映像。"
#~ msgid "Table 1: Types of platform-independent |CL| images"
#~ msgstr "表 1:独立于平台的 |CL| 映像类型"
#~ msgid "Image Type"
#~ msgstr "映像类型"
#~ msgid "Description"
#~ msgstr "描述"
#~ msgid "live-desktop.img or live-desktop.iso"
#~ msgstr "live-desktop.img 或 live-desktop.iso"
#~ msgid "Image for booting to GNOME\\* desktop to preview or install the OS."
#~ msgstr "用于引导至 GNOME\\* 桌面进行预览或安装操作系统的映像。"
#~ msgid "live-server.img or live-server.iso"
#~ msgstr "live-server.img 或 live-server.iso"
#~ msgid ""
#~ "Image for booting to server command "
#~ "prompt to preview or install the "
#~ "OS."
#~ msgstr "用于引导至服务器命令提示符进行预览或安装操作系统的映像。"
#~ msgid "Table 2: Types of platform-specific |CL| images"
#~ msgstr "表 2:特定于平台的 |CL| 映像类型"
#~ msgid "aws.img"
#~ msgstr "aws.img"
#~ msgid "Image suitable for use with Amazon\\* AWS\\*."
#~ msgstr "适用于 Amazon\\* AWS\\* 的映像。"
#~ msgid "azure.vhd"
#~ msgstr "azure.vhd"
#~ msgid "Virtual Hard Disk for use on Microsoft\\* Azure\\* cloud platform."
#~ msgstr "适用于 Microsoft\\* Azure\\* 云平台的虚拟硬盘。"
#~ msgid "azure-docker.vhd"
#~ msgstr "azure-docker.vhd"
#~ msgid ""
#~ "Virtual Hard Disk for use on "
#~ "Microsoft Azure cloud platform with "
#~ "Docker\\* pre-installed."
#~ msgstr "适用于预装 Docker\\* 的 Microsoft Azure 云平台的虚拟硬盘。"
#~ msgid "azure-machine-learning.vhd"
#~ msgstr "azure-machine-learning.vhd"
#~ msgid ""
#~ "Virtual Hard Disk for use on "
#~ "Microsoft Azure cloud platform with the"
#~ " `machine-learning-basic` bundle installed."
#~ msgstr "适用于安装 `machine-learning-basic` 捆绑包 的 Microsoft Azure 云平台的虚拟硬盘。"
#~ msgid "cloudguest.img"
#~ msgstr "cloudguest.img"
#~ msgid ""
#~ "Image with generic cloud guest virtual"
#~ " machine (VM) requirements installed."
#~ msgstr "安装了通用云来宾虚拟机 (VM) 的映像。"
#~ msgid "gce.tar"
#~ msgstr "gce.tar"
#~ msgid "Image with the Google Compute Engine (GCE) specific kernel."
#~ msgstr "带有 Google 计算引擎 (GCE) 特定内核的映像。"
#~ msgid "hyperv.vhdx"
#~ msgstr "hyperv.vhdx"
#~ msgid ""
#~ "Virtual Hard Disk for use with "
#~ "Microsoft Hyper-V\\* hypervisor. Includes "
#~ "`optimized kernel`_ for Hyper-V."
#~ msgstr ""
#~ "与 Microsoft Hyper-V\\* 虚拟机管理程序一起使用的虚拟硬盘。包括针对 "
#~ "Hyper-V `optimized kernel`_"
#~ msgid "kvm.img"
#~ msgstr "kvm.img"
#~ msgid ""
#~ "Image for booting in a simple VM"
#~ " with start_qemu.sh. Includes `optimized "
#~ "kernel`_ for KVM."
#~ msgstr "用于使用 start_qemu.sh 在简单虚拟机中引导的映像。包括针对 KVM `optimized kernel`_。"
#~ msgid "kvm-legacy.img"
#~ msgstr "kvm-legacy.img"
#~ msgid ""
#~ "Image for booting in a simple VM"
#~ " using legacy BIOS, if using "
#~ "start_qemu.sh make sure to remove -bios"
#~ " parameter."
#~ msgstr "用于使用传统 BIOS 在简单虚拟机中引导的映像;如果使用 start_qemu.sh,请确保移除 -bios 参数。"
#~ msgid "pxe.tar"
#~ msgstr "pxe.tar"
#~ msgid "Image suitable for use with PXE server."
#~ msgstr "适用于 PXE 服务器的映像。"
#~ msgid "vmware.vmdk"
#~ msgstr "vmware.vmdk"
#~ msgid ""
#~ "Virtual Machine Disk for VMware\\* "
#~ "platforms inclduing Player, Workstation, and"
#~ " ESXi."
#~ msgstr "面向包括 Player、Workstation 和 ESXi 在内的 VMware\\* 平台的虚拟机磁盘。"
#~ msgid "We also provide instructions for other operating systems:"
#~ msgstr "我们还提供了针对其他操作系统的说明。"
#~ msgid ":ref:`download-verify-decompress-linux`"
#~ msgstr ":ref:`download-verify-decompress-linux`"
@@ -0,0 +1,697 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../get-started/virtual-machine-install/vmw-player.rst:4
msgid "|CL-ATTR| on VMware\\* Workstation Player"
msgstr "VMware\\* Workstation Player 上的 |CL-ATTR|"
#: ../../get-started/virtual-machine-install/vmw-player.rst:6
msgid ""
"This page explains how to create a new VM and install |CL| on it with the"
" VMware Workstation Player hypervisor."
msgstr "本页解释了如何创建新虚拟机,以及如何利用 VMware Workstation Player 虚拟机管理程序在它上面安装 |CL|。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:14
msgid "Overview"
msgstr "概述"
#: ../../get-started/virtual-machine-install/vmw-player.rst:16
msgid ""
"`VMware Workstation Player`_ is a type 2 hypervisor. It runs on top of "
"Windows\\* or Linux\\* operating systems. With VMware ESXi, you can "
"create, configure, manage, and run |CL-ATTR| :abbr:`VMs (Virtual "
"Machines)` on your local system."
msgstr "`VMware Workstation Player`_ 是一个 2 类虚拟机管理程序。它运行于 Windows\\* 或 Linux\\* 操作系统之上。利用 VMware ESXi,可以在本地系统上创建、配置、管理和运行 |CL-ATTR| :abbr:`VMs (Virtual Machines)`。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:21
msgid ""
"VMware offers a type 1 hypervisor called `VMware ESXi`_ designed for the "
"cloud environment. For information on how to install |CL| as guest OS on "
"it, see :ref:`vmware-esxi-install-cl`."
msgstr "VMware 提供一个专为云环境设计的 `VMware ESXi`_ 1 类虚拟机管理程序。有关如何在其上安装 |CL| 用作来宾操作系统的信息,请查看 :ref:`vmware-esxi-install-cl`。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:27
msgid ""
"The screenshots on this document show the Windows version of the VMware "
"Workstation 15 Player. The menus and prompts are similar to those in "
"other versions and for the Linux OS save some minor wording differences."
msgstr "本文档的截屏显示了 VMware Workstation 15 Player 的 Windows 版本。除了措辞上的微小差异,菜单和提示与其他 Windows 版本以及 Linux 操作系统类似。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:31
msgid ""
"If you prefer to use a pre-configured |CL| VMware image instead, see our "
":ref:`vmw-player-preconf` guide."
msgstr "如果您更喜欢使用预配置 |CL| VMware 映像,请查看我们的 :ref:`vmw-player-preconf` 指南。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:35
msgid "Install the VMware Workstation Player hypervisor"
msgstr "安装 VMware Workstation Player 虚拟机管理程序"
#: ../../get-started/virtual-machine-install/vmw-player.rst:37
msgid ""
"Enable :abbr:`Intel® VT (Intel® Virtualization Technology)` and "
":abbr:`Intel® VT-d (Intel® Virtualization Technology for Directed I/O)` "
"in your system's BIOS."
msgstr "在系统 BIOS 中启用 :abbr:`Intel® VT (Intel® Virtualization Technology)` 和 :abbr:`Intel® VT-d (Intel® Virtualization Technology for Directed I/O)`。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:41
msgid ""
"`VMware Workstation Player`_ is available for Windows and Linux. Download"
" your preferred version."
msgstr "`VMware Workstation Player`_ 有 Windows 和 Linux 版本。下载您喜欢的版本。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:46
msgid ""
"By default, selecting download means you receive the latest version of "
"this application. Commands may differ based on the version."
msgstr "默认情况i下,选择下载意味着您接受该应用程序的最新版本。根据版本不同,命令可能会有所差异。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:49
msgid ""
"Install VMware Workstation Player following the instructions appropriate "
"for your system's OS:"
msgstr "按照适用于操作系统的说明,安装 VMware Workstation Player"
#: ../../get-started/virtual-machine-install/vmw-player.rst:52
msgid "On supported Linux distros:"
msgstr "在支持的 Linux 操作系统上:"
#: ../../get-started/virtual-machine-install/vmw-player.rst:54
msgid "Enable a GUI desktop."
msgstr "启用 GUI 桌面:"
#: ../../get-started/virtual-machine-install/vmw-player.rst:55
msgid "Start a terminal emulator."
msgstr "启动一个终端模拟器。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:56
msgid ""
"Start the installer by issuing the command below and follow the guided "
"steps."
msgstr "发出如下命令,按照指引步骤启动安装程序。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:63
msgid "On Windows:"
msgstr "在 Windows 上:"
#: ../../get-started/virtual-machine-install/vmw-player.rst:65
msgid "Start the installer."
msgstr "启动安装程序。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:66
msgid "Follow the setup wizard."
msgstr "按照安装向导提示操作。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:68
msgid "For additional help, see the `VMware Workstation Player Documentation`_."
msgstr "有关其他帮助,请查看 `VMware Workstation Player Documentation`_。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:71
msgid "Download the latest |CL| installer"
msgstr "下载最新的 |CL| 安装程序"
#: ../../get-started/virtual-machine-install/vmw-player.rst:73
msgid "Get the latest installer with |CL| OS Desktop from the `downloads`_ page."
msgstr "利用 |CL| OS Desktop 从 `downloads`_ 页面获得最新安装程序。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:75
msgid ""
"Visit :ref:`image-types` for additional information about all available "
"|CL| images."
msgstr "访问 :ref:`image-types`,了解关于所有 |CL| 映像的其他信息。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:77
msgid ""
"We also provide instructions for downloading and verifying a Clear Linux "
"ISO. For more information, refer to :ref:`download-verify-decompress`."
msgstr "我们还提供关于下载和验证 Clear Linux ISO 的说明。欲了解详情,请参阅 :ref:`download-verify-decompress`。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:81
msgid "Create and configure a new VM"
msgstr "创建并配置新虚拟机"
#: ../../get-started/virtual-machine-install/vmw-player.rst:83
msgid "Start the `VMware Workstation Player` app."
msgstr "启动 `VMware Workstation Player` 应用。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:85
msgid ""
"On the home screen, click :guilabel:`Create a New Virtual Machine`. See "
"Figure 1."
msgstr "在主屏幕上,点击 :guilabel:`Create a New Virtual Machine`。见图 1。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:92
msgid "Figure 1: VMware Workstation Player - Create a new virtual machine"
msgstr "图 1VMware Workstation Player - 创建新虚拟机"
#: ../../get-started/virtual-machine-install/vmw-player.rst:95
msgid ""
"On the :guilabel:`Welcome to the New Virtual Machine Wizard` screen, "
"select the :guilabel:`Installer disc image file (iso)` option. See Figure"
" 2."
msgstr "在 :guilabel:`Welcome to the New Virtual Machine Wizard` 屏幕上,选择 :guilabel:`Installer disc image file (iso)` 选项。见图 2。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:103
msgid "Figure 2: VMware Workstation Player - Select |CL| installer ISO"
msgstr "图 2VMware Workstation Player - 选择 |CL| 安装程序 ISO"
#: ../../get-started/virtual-machine-install/vmw-player.rst:105
msgid ""
"Click the :guilabel:`Browse` button and select the decompressed |CL| "
"installer ISO."
msgstr "点击 :guilabel:`Browse` 按钮,选择解压缩的 |CL| 安装程序 ISO。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:108
#: ../../get-started/virtual-machine-install/vmw-player.rst:124
#: ../../get-started/virtual-machine-install/vmw-player.rst:135
#: ../../get-started/virtual-machine-install/vmw-player.rst:151
msgid "Click the :guilabel:`Next` button."
msgstr "点击 :guilabel:`Next` 按钮。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:110
msgid ""
"On the :guilabel:`Select a Guest Operating System`, set the "
":guilabel:`Guest operating system` setting to :guilabel:`Linux`. See "
"Figure 3."
msgstr "在 :guilabel:`Select a Guest Operating System` 部分,将 :guilabel:`Guest operating system` 设置为 :guilabel:`Linux`。见图 3。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:118
msgid "Figure 3: VMware Workstation Player - Select guest operating system type"
msgstr "图 3VMware Workstation Player - 选择来宾操作系统类型"
#: ../../get-started/virtual-machine-install/vmw-player.rst:121
msgid ""
"Set the :guilabel:`Version` setting to :guilabel:`Other Linux 4.x or "
"later kernel 64-bit`."
msgstr "将 :guilabel:`Version` 设置为 :guilabel:`Other Linux 4.x or later kernel 64-bit`。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:126
msgid ""
"On the :guilabel:`Name the Virtual Machine` screen, name the new VM. See "
"Figure 4."
msgstr "在 :guilabel:`Name the Virtual Machine` 屏幕上,为新虚拟机命名。见图 4。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:133
msgid "Figure 4: VMware Workstation Player - Name virtual machine"
msgstr "图 4VMware Workstation Player - 虚拟机命名"
#: ../../get-started/virtual-machine-install/vmw-player.rst:137
msgid ""
"On the :guilabel:`Specify Disk Capacity` screen, set the VM's maximum "
"disk size. See Figure 5."
msgstr "在 :guilabel:`Specify Disk Capacity` 屏幕上,设置虚拟机的最大磁盘空间。见图 5。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:144
msgid "Figure 5: VMware Workstation Player - Set disk capacity"
msgstr "图 5VMware Workstation Player - 设置磁盘容量"
#: ../../get-started/virtual-machine-install/vmw-player.rst:148
msgid ""
"For optimal performance with the |CL| Desktop image, we recommend 32GB of"
" drive space. See :ref:`system-requirements` for more details."
msgstr "为获得 |CL| Desktop 映像的最优性能,我们推荐 32GB 磁盘空间。请查看 :ref:`system-requirements` 了解详情。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:153
msgid ""
"On the :guilabel:`Ready to Create Virtual Machine` screen, click the "
":guilabel:`Customize Hardware...` button. See Figure 6."
msgstr "在 :guilabel:`Ready to Create Virtual Machine` 屏幕上,点击 :guilabel:`Customize Hardware...` 按钮。见图 6。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:160
msgid "Figure 6: VMware Workstation Player - Customize hardware"
msgstr "图 6VMware Workstation Player - 定制硬件"
#: ../../get-started/virtual-machine-install/vmw-player.rst:162
msgid "Select :guilabel:`Memory` and set the size to 2GB. See Figure 7."
msgstr "选择 :guilabel:`Memory`,将大小设置为 2GB。见图 7。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:168
msgid "Figure 7: VMware Workstation Player - Set memory size"
msgstr "图 7VMware Workstation Player - 设置内存大小"
#: ../../get-started/virtual-machine-install/vmw-player.rst:171
msgid ""
"The |CL| installer ISO needs a minimum of 2GB of RAM. After completing "
"installation, |CL| can run on as little as 128MB of RAM. Thus, you can "
"reduce the memory size if needed. See :ref:`system-requirements` for more"
" details."
msgstr "|CL| 安装程序 ISO 最少需要 2GB 大小的 RAM。完成安装后,|CL| 可在只有 128MB 的 RAM 上运行。因此,如果需要,您可以减少内存大小。请查看 :ref:`system-requirements` 了解详情。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:176
msgid ""
"Under the :guilabel:`Device` list, select :guilabel:`Processors`. See "
"Figure 8."
msgstr "在 :guilabel:`Device` 列表中,选择 :guilabel:`Processors`。见图 8。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:183
msgid "Figure 8: VMware Workstation Player - Set virtualization engine option"
msgstr "图 8VMware Workstation Player - 设置虚拟化引擎选项"
#: ../../get-started/virtual-machine-install/vmw-player.rst:186
msgid ""
"Under the :guilabel:`Virtualization engine` section, check "
":guilabel:`Virtualize Intel VT-x/EPT or AMD-V/RVI`."
msgstr "在 :guilabel:`Virtualization engine` 部分,选中 :guilabel:`Virtualize Intel VT-x/EPT or AMD-V/RVI`。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:189
msgid "Click the :guilabel:`Close` button."
msgstr "点击· :guilabel:`Close` 按钮。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:191
msgid "Click the :guilabel:`Finish` button."
msgstr "点击 :guilabel:`Finish` 按钮。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:194
msgid "Enable UEFI boot support"
msgstr "启用 UEFI 引导支持"
#: ../../get-started/virtual-machine-install/vmw-player.rst:196
msgid "|CL| needs UEFI support to boot. To enable UEFI:"
msgstr "|CL| 需要 UEFI 支持才可以引导。要启用 UEFI"
#: ../../get-started/virtual-machine-install/vmw-player.rst:198
msgid "Power off the VM. click the :guilabel:`Player` menu. See Figure 9."
msgstr "要关闭虚拟机,点击 :guilabel:`Player` 菜单。见图 9。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:204
msgid "Figure 9: VMware Workstation Player - Power off virtual machine"
msgstr "图 9VMware Workstation Player - 关闭虚拟机"
#: ../../get-started/virtual-machine-install/vmw-player.rst:206
msgid "Go to :guilabel:`Power` and select :guilabel:`Shut Down Guest`."
msgstr "转到 :guilabel:`Power`,选择 :guilabel:`Shut Down Guest`。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:208
msgid "Add the following line to the end of your VM's :file:`.vmx` file:"
msgstr "在虚拟机的 :file:`.vmx` 文件结尾处添加如下代码行:"
#: ../../get-started/virtual-machine-install/vmw-player.rst:216
msgid "Depending on the OS, you can typically find the VMware VM files under:"
msgstr "根据操作系统不同,通常可以在如下地址找到 VMware 虚拟机文件:"
#: ../../get-started/virtual-machine-install/vmw-player.rst:218
msgid "On Linux distros: :file:`/home/username/vmware`"
msgstr "Linux 操作系统::file:`/home/username/vmware`"
#: ../../get-started/virtual-machine-install/vmw-player.rst:219
msgid ""
"On Windows: :file:`C:\\\\Users\\\\username\\\\Documents\\\\Virtual "
"Machines`"
msgstr "Windows:file:`C:\\\\Users\\\\username\\\\Documents\\\\Virtual Machines`"
#: ../../get-started/virtual-machine-install/vmw-player.rst:222
msgid "Install |CL| into the new VM"
msgstr "将 |CL| 安装至新虚拟机"
#: ../../get-started/virtual-machine-install/vmw-player.rst:224
msgid ""
"Select the newly-created VM and click the :guilabel:`Play virtual "
"machine` button. See Figure 10."
msgstr "选择新创建的虚拟机,点击 :guilabel:`Play virtual machine` 按钮。见图 10。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:231
msgid "Figure 10: VMware Workstation Player - Power on virtual machine"
msgstr "图 10VMware Workstation Player - 开启虚拟机"
#: ../../get-started/virtual-machine-install/vmw-player.rst:233
msgid ""
"Follow the :ref:`install-on-target-start` guide to complete the "
"installation of |CL|."
msgstr "按照 :ref:`install-on-target-start` 指南完成 |CL| 的安装。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:236
msgid ""
"After the installation completes, reboot the VM. This reboot restarts the"
" |CL| installer."
msgstr "完成安装后,重启虚拟机。此操作会重新启动 |CL| 安装程序。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:240
msgid "Detach the |CL| installer ISO from the VM"
msgstr "从虚拟机断开 |CL| 安装程序 ISO"
#: ../../get-started/virtual-machine-install/vmw-player.rst:242
msgid ""
"To enable the mouse pointer so you access VMware Workstation Player's "
"menus, press :kbd:`<CTRL>` + :kbd:`<ALT>` on the keyboard."
msgstr "为启用鼠标指针,以便访问 VMware Workstation Player 的菜单,请按下键盘上的 :kbd:`<CTRL>` + :kbd:`<ALT>`。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:245
msgid ""
"To disconnect the CD/DVD to stop it from booting the |CL| installer ISO "
"again, click the :guilabel:`Player` menu. See Figure 11."
msgstr "要断开 CD/DVD 防止它再次引导 |CL| 安装程序 ISO,请点击 :guilabel:`Player` 菜单。见图 11。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:252
msgid "Figure 11: VMware Workstation Player - Edit CD/DVD settings"
msgstr "图 11VMware Workstation Player - 编辑 CD/DVD 设置"
#: ../../get-started/virtual-machine-install/vmw-player.rst:254
msgid "Go to :menuselection:`Removable Devices-->CD/DVD (IDE)-->Disconnect`."
msgstr "转到 :menuselection:`可移除设备-->CD/DVD (IDE)-->断开`。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:256
msgid "Click the :guilabel:`OK` button."
msgstr "点击 :guilabel:`OK` 按钮。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:259
msgid "Install open-vm-tools"
msgstr "安装 open-vm-tools"
#: ../../get-started/virtual-machine-install/vmw-player.rst:261
msgid ""
"Optional: You may want to install the `open-vm-tools` in your virtual "
"machine. The Open Virtual Machine Tools (open-vm-tools) are the open "
"source implementation of VMware Tools for Linux\\* guest operating "
"systems."
msgstr "可选:您可能希望在虚拟机上安装 `open-vm-tools`。Open Virtual Machine Tools (open-vm-tools) 是用于 Linux\\* guest 操作系统的开源 VMware 执行工具。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:265
msgid ""
"Power on your |CL| virtual machine. On the :guilabel:`VMware Workstation "
"Player` home screen, select your VM. See Figure 10."
msgstr "配置上述设置后,开启 |CL| 虚拟机。在 :guilabel:`VMware Workstation Player` 主屏幕上,选择虚拟机。见图 10。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:268
msgid "Click :guilabel:`Play virtual machine`."
msgstr "点击 :guilabel:`Play virtual machine`。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:270
msgid "In |CL| you can install the bundle, and enable the tools, in your VM."
msgstr "您可以在 |CL| 中安装捆绑包,然后在虚拟机中启用这些工具。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:277
msgid ""
"More information is available on the `VMWare Tools Product "
"Documentation`_ site."
msgstr "详情可访问网站 `VMWare Tools Product Documentation`_。"
#: ../../get-started/virtual-machine-install/vmw-player.rst:281
msgid "Related topics"
msgstr "相关主题"
#: ../../get-started/virtual-machine-install/vmw-player.rst:283
msgid "For other guides on using the VMWare Player and ESXi, see:"
msgstr "有关使用 VMWare Player 和 ESXi 的其他指南,请查看:"
#: ../../get-started/virtual-machine-install/vmw-player.rst:285
msgid ":ref:`vmw-player-preconf`"
msgstr ":ref:`vmw-player-preconf`"
#: ../../get-started/virtual-machine-install/vmw-player.rst:286
msgid ":ref:`vmware-esxi-install-cl`"
msgstr ":ref:`vmware-esxi-install-cl`"
#: ../../get-started/virtual-machine-install/vmw-player.rst:287
msgid ":ref:`vmware-esxi-preconfigured-cl-image`"
msgstr ":ref:`vmware-esxi-preconfigured-cl-image`"
#~ msgid ""
#~ "This section shows how to create a"
#~ " new VM and install |CL| into "
#~ "it with the VMware Workstation 14 "
#~ "Player hypervisor. Installing |CL| into "
#~ "a new VM provides you flexibility "
#~ "when configuring the VM. You can "
#~ "configure the VM's size, number of "
#~ "partitions, installed bundles, etc."
#~ msgstr ""
#~ msgid "In this tutorial, we perform the following steps:"
#~ msgstr ""
#~ msgid ""
#~ "The screenshots on this document show"
#~ " the Windows version of the VMware"
#~ " Workstation 14 Player. The menus and"
#~ " prompts are similar to those in "
#~ "the Linux version save some minor "
#~ "wording differences."
#~ msgstr ""
#~ msgid "For additional help, see the `VMware Workstation Player guide`_."
#~ msgstr ""
#~ msgid ""
#~ "This page explains how to create a"
#~ " new VM and install |CL| on it"
#~ " with the VMware Workstation 14 "
#~ "Player hypervisor."
#~ msgstr ""
#~ msgid ""
#~ "`VMware Workstation 14 Player`_ is a "
#~ "type 2 hypervisor. It runs on top"
#~ " of another operating system such as"
#~ " Windows\\* or Linux\\*. With VMware "
#~ "ESXi, you can create, configure, manage,"
#~ " and run |CL-ATTR| :abbr:`VMs "
#~ "(Virtual Machines)` on your local "
#~ "system."
#~ msgstr ""
#~ msgid ""
#~ "Installing |CL| into a new VM "
#~ "provides you flexibility when configuring "
#~ "the VM. You can configure the VM's"
#~ " size, number of partitions, installed "
#~ "bundles, etc."
#~ msgstr ""
#~ msgid ""
#~ "Screenshots in this document show VMware"
#~ " Workstation 14 Player for Windows. "
#~ "Menus and prompts in the Linux "
#~ "version have minor wording differences."
#~ msgstr ""
#~ msgid ""
#~ "`VMware Workstation 14 Player`_ is "
#~ "available for Windows and Linux. "
#~ "Download your preferred version."
#~ msgstr ""
#~ msgid ""
#~ "Install VMware Workstation 14 Player "
#~ "following the instructions appropriate for "
#~ "your system's OS:"
#~ msgstr ""
#~ msgid "Download the latest |CL| installer ISO"
#~ msgstr ""
#~ msgid ""
#~ "Get the latest |CL| installer ISO "
#~ "image from the `image`_ repository. Look"
#~ " for :file:`clear-[version number]-installer.iso.xz`."
#~ msgstr ""
#~ msgid "Verify the integrity of the |CL| image"
#~ msgstr ""
#~ msgid ""
#~ "Before you use a downloaded |CL| "
#~ "image, verify its integrity. This action"
#~ " eliminates the small chance of a "
#~ "corrupted image due to download issues."
#~ " To support verification, each released "
#~ "|CL| image has a corresponding SHA512"
#~ " checksum file designated with the "
#~ "suffix `-SHA512SUMS`."
#~ msgstr ""
#~ msgid "Download the corresponding SHA512 checksum file of your |CL| image."
#~ msgstr ""
#~ msgid "Start Command Prompt."
#~ msgstr ""
#~ msgid "Go to the directory with the downloaded image and checksum files."
#~ msgstr ""
#~ msgid "Get the SHA512 checksum of the image with the command:"
#~ msgstr ""
#~ msgid ""
#~ "Manually compare the output with the "
#~ "original checksum value shown in the "
#~ "downloaded checksum file and make sure"
#~ " they match."
#~ msgstr ""
#~ msgid "Decompress the |CL| image"
#~ msgstr ""
#~ msgid ""
#~ "Released |CL| images are compressed with"
#~ " either GNU zip (*.gz*) or XZ "
#~ "(*.xz*). The compression type depends on"
#~ " the target platform or environment. "
#~ "To decompress the image, follow these"
#~ " steps:"
#~ msgstr ""
#~ msgid "Download and install `7-Zip`_."
#~ msgstr ""
#~ msgid "Go to the directory with the downloaded image and right-click it."
#~ msgstr ""
#~ msgid ""
#~ "From the pop-up menu, select "
#~ ":guilabel:`7-Zip` and select :guilabel:`Extract "
#~ "Here` as shown in Figure 1."
#~ msgstr ""
#~ msgid "Figure 1: Windows 7-Zip extract file."
#~ msgstr ""
#~ msgid "We also provide instructions for other operating systems:"
#~ msgstr ""
#~ msgid ":ref:`download-verify-decompress-linux`"
#~ msgstr ""
#~ msgid ":ref:`download-verify-decompress-mac`"
#~ msgstr ""
#~ msgid "Figure 1: VMware Workstation 14 Player - Create a new virtual machine"
#~ msgstr ""
#~ msgid "Figure 2: VMware Workstation 14 Player - Select |CL| installer ISO"
#~ msgstr ""
#~ msgid ""
#~ "Figure 3: VMware Workstation 14 Player"
#~ " - Select guest operating system type"
#~ msgstr ""
#~ msgid ""
#~ "Set the :guilabel:`Version` setting to "
#~ ":guilabel:`Other Linux 3.x or later "
#~ "kernel 64-bit`."
#~ msgstr ""
#~ msgid "Figure 4: VMware Workstation 14 Player - Name virtual machine"
#~ msgstr ""
#~ msgid "Figure 5: VMware Workstation 14 Player - Set disk capacity"
#~ msgstr ""
#~ msgid ""
#~ "A minimal |CL| installation can exist"
#~ " on 600MB of drive space. See "
#~ ":ref:`system-requirements` for more details."
#~ msgstr ""
#~ msgid "Figure 6: VMware Workstation 14 Player - Customize hardware"
#~ msgstr ""
#~ msgid "Figure 7: VMware Workstation 14 Player - Set memory size"
#~ msgstr ""
#~ msgid ""
#~ "Figure 8: VMware Workstation 14 Player"
#~ " - Set virtualization engine option"
#~ msgstr ""
#~ msgid "Figure 9: VMware Workstation 14 Player - Power on virtual machine"
#~ msgstr ""
#~ msgid "Figure 10: VMware Workstation 14 Player - Edit CD/DVD settings"
#~ msgstr ""
#~ msgid "Go to :menuselection:`Removable Devices-->CD/DVD (IDE)-->Settings`."
#~ msgstr ""
#~ msgid ""
#~ "On the :guilabel:`Device status` section, "
#~ "uncheck the :guilabel:`Connected` and the "
#~ ":guilabel:`Connect at power on` settings. "
#~ "See Figure 11."
#~ msgstr ""
#~ msgid "Figure 11: VMware Workstation 14 Player - Disconnect CD/DVD"
#~ msgstr ""
#~ msgid "To power off the VM, click the :guilabel:`Player` menu. See Figure 12."
#~ msgstr ""
#~ msgid "Figure 12: VMware Workstation 14 Player - Power off virtual machine"
#~ msgstr ""
#~ msgid ""
#~ "|CL| needs UEFI support to boot. "
#~ "To enable UEFI, add the following "
#~ "line to the end of your VM's "
#~ ":file:`.vmx` file:"
#~ msgstr ""
#~ msgid "Power on the VM"
#~ msgstr ""
#~ msgid ""
#~ "After configuring the settings above, "
#~ "power on your |CL| virtual machine."
#~ msgstr ""
#~ msgid ""
#~ "On the :guilabel:`VMware Workstation Player`"
#~ " home screen, select your VM. See "
#~ "Figure 13."
#~ msgstr ""
#~ msgid "Figure 13: VMware Workstation 14 Player - Power on virtual machine"
#~ msgstr ""
#~ msgid "Install |CL-ATTR| as a VMware\\* Workstation Player guest OS"
#~ msgstr "安装 |CL-ATTR| 用作 Vmware\\* Workstation Player 来宾操作系统"
#~ msgid ""
#~ "Install Open VM Tools. You may "
#~ "want to install the `open-vm-"
#~ "tools` in your virtual machine. The "
#~ "Open Virtual Machine Tools (open-vm-"
#~ "tools) are the open source "
#~ "implementation of VMware Tools for Linux"
#~ " guest operating systems. In |CL| you"
#~ " can use the following to install "
#~ "the bundle in your VM"
#~ msgstr ""
#~ "安装 Open VM Tools。您可能希望在虚拟机上安装 `open-"
#~ "vm-tools`。Open Virtual Machine Tools "
#~ "(open-vm-tools) 是用于 Linux 来宾操作系统的开源 "
#~ "VMware 执行工具。在 |CL| 中,您可以利用如下步骤在您的虚拟机中安装该 "
#~ "bundle"
@@ -0,0 +1,533 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:4
msgid "|CL-ATTR| on VMware\\* ESXi"
msgstr "VMware\\* ESXi 上的 |CL-ATTR|"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:6
msgid ""
"This page explains how to create a new :abbr:`VM (Virtual Machine)` and "
"manually install |CL-ATTR| on the new VM with VMware ESXi 6.5."
msgstr "本页说明如何创建新的 :abbr:`虚拟机 (虚拟机)` 以及如何在运行 VMware ESXi 6.5 的新虚拟机上手动安装 |CL-ATTR|。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:14
msgid "Overview"
msgstr "概述"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:16
msgid ""
"`VMware ESXi`_ is a type 1 bare-metal hypervisor that runs directly on "
"top of server hardware. With VMware ESXi, you can create, configure, "
"manage, and run |CL| virtual machines in the cloud."
msgstr "`VMware ESXi`_ 是一个 1 类裸机虚拟机管理程序,可直接在服务器硬件上运行。利用 VMware ESXi,可以在云端创建、配置、管理和运行 |CL| 虚拟机。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:20
msgid ""
"Manually installing |CL| on a new VM gives additional configuration "
"flexibility during installation. For example: alternate disk sizes, "
"number of partitions, pre-installed bundles, etc."
msgstr "安装期间,在新的虚拟机上手动安装 |CL| 提高了配置灵活性。例如,备用磁盘空间、分区数量、预安装 bundle 等。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:24
msgid ""
"If you prefer to use a pre-configured |CL| VMware image instead, refer to"
" :ref:`vmware-esxi-preconfigured-cl-image`."
msgstr "如果喜欢使用预配置的 |CL| VMware 映像,可参阅 :ref:`vmware-esxi-preconfigured-cl-image`。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:29
msgid ""
"VMware also offers a type 2 hypervisor designed for the desktop "
"environment, called `VMware Workstation Player`_. Refer to :ref:`vmw-"
"player-preconf` or :ref:`vmw-player` for more information."
msgstr "VMware 还提供一个适用于桌面环境的 2 类虚拟机管理程序,名为 `VMware Workstation Player`_。请参阅 :ref:`vmw-player-preconf` 或 :ref:`vmw-player` 了解更多信息。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:33
msgid "Visit :ref:`image-types` to learn more about all available images."
msgstr "访问 :ref:`image-types` 了解所有可用映像的详情。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:36
msgid "Download the latest |CL| installer ISO"
msgstr "下载最新的 |CL| 安装程序 ISO"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:38
msgid ""
"Get the latest |CL| installer ISO image from the `image`_ repository. "
"Look for :file:`clear-[version number]-installer.iso.xz`."
msgstr "从 `image`_ 存储库中获取最新的 |CL| 安装程序 ISO。寻找 :file:`clear-[version number]-installer.iso.xz`。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:41
msgid ""
"We also provide instructions for downloading and verifying a Clear Linux "
"ISO. For more information, refer to :ref:`download-verify-decompress`."
msgstr "我们还提供关于下载和验证 Clear Linux ISO 的说明。欲了解详情,请参阅 :ref:`download-verify-decompress`。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:45
msgid "Upload the |CL| installer ISO to the VMware server"
msgstr "将 |CL| 安装程序 ISO 上传至 VMware 服务器"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:47
msgid ""
"Connect to the VMware server and log into an account with sufficient "
"permission to create and manage VMs."
msgstr "连接 VMware 服务器,登录拥有充分权限的帐户以创建和管理虚拟机。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:49
msgid ""
"Under the :guilabel:`Navigator` window, select :guilabel:`Storage`. See "
"Figure 1."
msgstr "在 :guilabel:`Navigator` 窗口中,选择 :guilabel:`Storage`。见图 1。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:51
msgid ""
"Under the :guilabel:`Datastores` tab, click the :guilabel:`Datastore "
"browser` button."
msgstr "在 :guilabel:`Datastores` 标签下,点击 :guilabel:`Datastore browser` 按钮。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:58
msgid "Figure 1: VMware ESXi - Navigator > Storage"
msgstr "图 1VMware ESXi - 浏览器 > 存储"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:60
msgid ""
"Click the :guilabel:`Create directory` button and name the directory "
"`ISOs`. See Figure 2."
msgstr "点击 :guilabel:`Create directory` 按钮并命名目录 `ISOs`。见图 2。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:67
msgid "Figure 2: VMware ESXi - Datastore > Create directory"
msgstr "图 2VMware ESXi - 数据存储 > 创建目录"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:69
msgid ""
"Select the newly-created directory and click the :guilabel:`Upload` "
"button. See Figure 3."
msgstr "选择新建目录,点击 :guilabel:`Upload` 按钮。见图 3。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:76
msgid "Figure 3: VMware ESXi - Datastore > Upload ISO"
msgstr "图 3VMware ESXi - 数据存储 > 上传 ISO"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:78
msgid ""
"Select the decompressed |CL| installer ISO file :file:`clear-[version "
"number]-installer.iso` and upload it."
msgstr "选择解压缩的 |CL| 安装程序 ISO 文件 :file:`clear-[version number]-installer.iso` 并将其上传。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:82
msgid "Create and configure a new VM"
msgstr "创建并配置新虚拟机"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:84
msgid ""
"In this section, you will create a new VM, configure its basic parameters"
" such as drive size, number of CPUs, memory size, and then attach the "
"|CL| installer ISO."
msgstr "本节中,您会创建新虚拟机,配置基本参数,如驱动器大小、CPU 数量、内存大小,然后挂载 |CL| 安装程序 ISO。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:87
msgid ""
"Under the :guilabel:`Navigator` window, select :guilabel:`Virtual "
"Machines`. See Figure 4."
msgstr "在 :guilabel:`Navigator` 窗口中,选择 :guilabel:`Virtual Machines`。见图 4。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:89
msgid "In the right window, click the :guilabel:`Create / Register VM` button."
msgstr "在右侧窗口中,点击 :guilabel:`Create / Register VM` 按钮。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:95
msgid "Figure 4: VMware ESXi - Navigator > Virtual Machines"
msgstr "图 4VMware ESXi - 浏览器 > 虚拟机"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:97
msgid "On the :guilabel:`Select creation type` step:"
msgstr "在 :guilabel:`Select creation type` 步骤:"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:99
msgid "Select the :guilabel:`Create a new virtual machine` option. See Figure 5."
msgstr "选择 :guilabel:`Create a new virtual machine` 选项。见图 5。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:101
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:115
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:126
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:179
msgid "Click the :guilabel:`Next` button."
msgstr "点击 :guilabel:`Next` 按钮。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:107
msgid "Figure 5: VMware ESXi - Create a new virtual machine"
msgstr "图 5VMware ESXi - 创建新虚拟机"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:109
msgid "On the :guilabel:`Select a name and guest OS` step:"
msgstr "在 :guilabel:`Select a name and guest OS` 步骤:"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:111
msgid "Give the new VM a name in the :guilabel:`Name` field. See Figure 6."
msgstr "在 :guilabel:`Name` 字段中为新虚拟机命名 见图 6。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:112
msgid ""
"Set the :guilabel:`Compatability` option to :guilabel:`ESXi 6.5 virtual "
"machine`."
msgstr "将 :guilabel:`Compatability` 选项设置为 :guilabel:`ESXi 6.5 virtual machine`。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:113
msgid "Set the :guilabel:`Guest OS family` option to :guilabel:`Linux`."
msgstr "将 :guilabel:`Guest OS family` 选项设置为 :guilabel:`Linux`。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:114
msgid ""
"Set the :guilabel:`Guest OS version` option to :guilabel:`Other 3.x or "
"later Linux (64-bit)`."
msgstr "将 :guilabel:`Guest OS version` 选项设置为 :guilabel:`Other 3.x or later Linux (64-bit)`。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:121
msgid "Figure 6: VMware ESXi - Give a name and select guest OS type"
msgstr "图 6VMware ESXi - 命名并选择来宾操作系统类型"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:123
msgid "On the :guilabel:`Select storage` step:"
msgstr "在 :guilabel:`Select storage` 步骤:"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:125
msgid "Accept the default option."
msgstr "接受默认选项。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:128
msgid "On the :guilabel:`Customize settings` step:"
msgstr "在 :guilabel:`Customize settings` 步骤:"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:130
msgid "Click the :guilabel:`Virtual Hardware` button. See Figure 7."
msgstr "点击 :guilabel:`Virtual Hardware` 按钮。见图 7。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:131
msgid ""
"Expand the :guilabel:`CPU` setting and enable :guilabel:`Hardware "
"virtualization` by checking :guilabel:`Expose hardware assisted "
"virtualization to the guest OS`."
msgstr "展开 :guilabel:`CPU` 设置,选中 :guilabel:`Hardware virtualization` 启用 :guilabel:`Expose hardware assisted virtualization to the guest OS`。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:138
msgid "Figure 7: VMware ESXi - Enable hardware virtualization"
msgstr "图 7VMware ESXi - 启用硬件虚拟化"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:140
msgid "Set :guilabel:`Memory` size to 2048MB (2GB). See Figure 8."
msgstr "将 :guilabel:`Memory` 大小设置为 2048MB (2GB)。见图 8。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:146
msgid "Figure 8: VMware ESXi - Set memory size"
msgstr "图 8VMware ESXi - 设置内存大小"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:150
msgid ""
"The |CL| installer ISO needs a minimum of 2GB of RAM to work properly. "
"You can reduce the memory size after the installation completes if you "
"want, because a minimum |CL| installation can function on as little as "
"128MB of RAM. See :ref:`system-requirements` for more details."
msgstr "|CL| 安装程序 ISO 需要至少 2GB 的 RAM 才能正常运行。如果需要,可以在安装完成后减少内存,因为 |CL| 最小安装可以在仅有 128MB RAM 的情况下运行。请查看 :ref:`system-requirements` 了解详情。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:155
msgid "Set :guilabel:`Hard disk 1` to the desired capacity. See Figure 9."
msgstr "将 :guilabel:`Hard disk 1` 设置为所需容量。见图 9。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:161
msgid "Figure 9: VMware ESXi - Set hard disk size"
msgstr "图 9VMware ESXi - 设置硬盘大小"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:165
msgid ""
"A minimum |CL| installation can exist on 600MB of drive space. See :ref"
":`system-requirements` for more details."
msgstr "|CL| 最小安装可在 600MB 的驱动器空间中存储。请查看 :ref:`system-requirements` 了解详情。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:168
msgid ""
"Attach the |CL| installer ISO. For the :guilabel:`CD/DVD Drive 1` "
"setting, click the drop-down list to the right of it and select the "
":guilabel:`Datastore ISO file` option. Then select the |CL| installer "
"ISO :file:`clear-[version number]-installer.iso` that you previously "
"uploaded to the VMware server. See Figure 10."
msgstr "挂载 |CL| 安装程序 ISO。对于 :guilabel:`CD/DVD Drive 1` 设置,点击其右侧下拉列表,选择 :guilabel:`Datastore ISO file` 选项。然后,选择此前上传至 VMware 服务器的 |CL| 安装程序 ISO :file:`clear-[version number]-installer.iso`。见图 10。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:177
msgid "Figure 10: VMware ESXi - Set CD/DVD to boot installer ISO"
msgstr "图 10VMware ESXi - 设置 CD/DVD 引导安装程序 ISO"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:180
msgid "Click the :guilabel:`Finish` button."
msgstr "点击 :guilabel:`Finish` 按钮。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:183
msgid "Install |CL| into the new VM"
msgstr "将 |CL| 安装至新虚拟机"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:185
msgid "Power on the VM."
msgstr "开启虚拟机。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:187
msgid ""
"Under the :guilabel:`Navigator` window, select :guilabel:`Virtual "
"Machines`. See Figure 11."
msgstr "在 :guilabel:`Navigator` 窗口中,选择 :guilabel:`Virtual Machines`。见图 11。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:189
msgid "In the right window, select the newly-created VM."
msgstr "在右侧窗口中,选择新创建的虚拟机。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:190
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:270
msgid "Click the :guilabel:`Power on` button."
msgstr "点击 :guilabel:`Power on` 按钮。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:191
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:271
msgid ""
"Click on the icon representing the VM to bring it into view and maximize "
"its window."
msgstr "点击代表虚拟机的图标,显示虚拟机,将虚拟机窗口最大化。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:198
msgid "Figure 11: VMware ESXi - Navigator > Virtual Machines > Power on VM"
msgstr "图 11VMware ESXi - 浏览器 > 虚拟机 > 开启虚拟机"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:200
msgid ""
"Follow the :ref:`install-on-target-start` guide to complete the "
"installation of |CL|."
msgstr "按照 :ref:`install-on-target-start` 指南完成 |CL| 的安装。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:202
msgid ""
"After the installation is complete, follow the |CL| instruction to reboot"
" it. This will restart the installer again."
msgstr "安装完成后,按照 |CL| 说明重启。此操作会再次重启安装程序。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:206
msgid "Reconfigure the VM's settings to boot the newly-installed |CL|"
msgstr "重新配置虚拟机设置,以引导新安装的 |CL|"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:208
msgid ""
"After |CL| has been installed using the installer ISO, it must be "
"detached so it will not run again. Also, in order to boot the newly-"
"installed |CL|, you must enable UEFI support."
msgstr "利用安装程序 ISO 安装 |CL| 后,必须卸载安装程序 ISO,防止再次运行。而且,为了引导新安装的 |CL|,必须启用 UEFI 支持。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:212
msgid "Power off the VM."
msgstr "关闭虚拟机。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:214
msgid ""
"Click the :guilabel:`Actions` button - located on the top-right corner of"
" the VM's windows - and go to the :guilabel:`Power` setting and select "
"the :guilabel:`Power off` option. See Figure 12."
msgstr "点击 :guilabel:`Actions` 按钮(按钮位于虚拟机窗口的右上角),转到 :guilabel:`Power` 设置,然后选择 :guilabel:`Power off` 选项。见图 12。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:222
msgid "Figure 12: VMware ESXi - Actions > Power off"
msgstr "图 12VMware ESXi - 操作 > 关闭"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:224
msgid "Edit the VM settings."
msgstr "编辑虚拟机设置。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:226
msgid ""
"Click the :guilabel:`Actions` button again and select :guilabel:`Edit "
"settings`. See Figure 13."
msgstr "再次点击 :guilabel:`Actions` 按钮,选择 :guilabel:`Edit settings`。见图 13。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:233
msgid "Figure 13: VMware ESXi - Actions > Edit settings"
msgstr "图 13VMware ESXi - 操作 > 编辑设置"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:235
msgid ""
"Disconnect the CD/DVD to stop it from booting the |CL| installer ISO "
"again."
msgstr "断开 CD/DVD,防止它再次引导 |CL| 安装程序 ISO。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:237
msgid "Click the :guilabel:`Virtual Hardware` button. See Figure 14."
msgstr "点击 :guilabel:`Virtual Hardware` 按钮。见图 14。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:238
msgid ""
"For the :guilabel:`CD/DVD Drive 1` setting, uncheck the "
":guilabel:`Connect` checkbox."
msgstr "对于 :guilabel:`CD/DVD Drive 1` 设置,取消选中 :guilabel:`Connect` 复选框。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:245
msgid "Figure 14: VMware ESXi - Disconnect the CD/DVD drive"
msgstr "图 14VMware ESXi - 断开 CD/DVD 驱动器"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:247
msgid "|CL| needs UEFI support in order to boot. Enable it."
msgstr "|CL| 需要 UEFI 支持才可以引导。请予以启用。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:249
msgid "Click the :guilabel:`VM Options` button. See Figure 15."
msgstr "点击 :guilabel:`VM Options` 按钮。见图 15。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:250
msgid "Expand the :guilabel:`Boot Options` setting."
msgstr "展开 :guilabel:`Boot Options` 设置。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:251
msgid ""
"For the :guilabel:`Firmware` setting, click the drop-down list to the "
"right of it and select the :guilabel:`EFI` option."
msgstr "对于 :guilabel:`Firmware` 设置,点击其右侧的下拉列表,选择 :guilabel:`EFI` 选项。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:258
msgid "Figure 15: VMware ESXi - Set boot firmware to EFI"
msgstr "图 15VMware ESXi - 将引导固件设置为 EFI"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:260
msgid "Click the :guilabel:`Save` button."
msgstr "点击 :guilabel:`Save` 按钮。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:263
msgid "Power on the VM and boot |CL|"
msgstr "开启虚拟机,引导 |CL|"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:265
msgid "After configuring the settings above, power on the VM."
msgstr "配置上述设置后,开启虚拟机。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:267
msgid ""
"Under the :guilabel:`Navigator` window, select :guilabel:`Virtual "
"Machines`. See Figure 16."
msgstr "在 :guilabel:`Navigator` 窗口中,选择 :guilabel:`Virtual Machines`。见图 16。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:269
msgid "In the right window, select the VM."
msgstr "在右侧窗口,选择虚拟机。"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:278
msgid "Figure 16: VMware ESXi - Navigator > Virtual Machines > Power on VM"
msgstr "图 16VMware ESXi - 浏览器 > 虚拟机 > 开启虚拟机"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:281
msgid "Related topics"
msgstr "相关主题"
#: ../../get-started/virtual-machine-install/vmware-esxi-install-cl.rst:283
msgid ":ref:`vmware-esxi-preconfigured-cl-image`"
msgstr ":ref:`vmware-esxi-preconfigured-cl-image`"
#~ msgid ""
#~ "`VMware ESXi`_ is a type 1 "
#~ "bare-metal hypervisor which runs directly"
#~ " on top of server hardware. With "
#~ "VMware ESXi, you can create, configure,"
#~ " manage, and run |CL-ATTR| virtual"
#~ " machines in the cloud."
#~ msgstr ""
#~ msgid ""
#~ "This section shows you how to "
#~ "create a new :abbr:`VM (Virtual "
#~ "Machine)` and manually install |CL| into"
#~ " it with VMware ESXi 6.5."
#~ msgstr ""
#~ msgid ""
#~ "Manually installing |CL| into a new "
#~ "VM provides you some additional "
#~ "configuration flexibility during installation. "
#~ "For example: alternate disk sizes, "
#~ "number of partitions, pre-installed "
#~ "bundles, etc."
#~ msgstr ""
#~ msgid ""
#~ "If you would prefer to use a "
#~ "preconfigured |CL| VMware image instead, "
#~ "see :ref:`vmware-esxi-preconfigured-cl-"
#~ "image`."
#~ msgstr ""
#~ msgid ""
#~ "VMware also offers a type 2 "
#~ "hypervisor called `VMware Workstation Player`_"
#~ " which is designed for the desktop"
#~ " environment."
#~ msgstr ""
#~ msgid "See :ref:`vmw-player-preconf` or see :ref:`vmw-player`"
#~ msgstr ""
#~ msgid "Install steps:"
#~ msgstr ""
#~ msgid "Decompress the |CL| image"
#~ msgstr ""
#~ msgid ""
#~ "Released |CL| images are compressed with"
#~ " either GNU zip (*.gz*) or XZ "
#~ "(*.xz*). The compression type depends on"
#~ " the target platform or environment. "
#~ "To decompress the image, follow these"
#~ " steps:"
#~ msgstr ""
#~ msgid "Start a terminal emulator."
#~ msgstr ""
#~ msgid "Go to the directory with the downloaded image."
#~ msgstr ""
#~ msgid "To decompress an XZ image, enter:"
#~ msgstr ""
#~ msgid "To decompress a GZ image, enter:"
#~ msgstr ""
#~ msgid "For alternative instructions on other operating systems, see:"
#~ msgstr ""
#~ msgid ":ref:`download-verify-decompress-mac`"
#~ msgstr ""
#~ msgid ":ref:`download-verify-decompress-windows`"
#~ msgstr ""
#~ msgid "Install |CL-ATTR| as a VMware\\* ESXi guest OS"
#~ msgstr "安装 |CL-ATTR|,用作 VMware\\* ESXi 来宾操作系统"
@@ -0,0 +1,541 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:4
msgid "|CL-ATTR| on VMware\\* ESXi (pre-configured image)"
msgstr "VMware\\* ESXi(预配置映像)上的 |CL-ATTR|"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:6
msgid ""
"This page explains how to deploy a pre-configured |CL| VMware :abbr:`VM "
"(Virtual Machine)` image on a VMware ESXi 6.5 host."
msgstr "本页说明如何在 VMware ESXi 6.5 主机上部署预配置的 |CL| VMware :abbr:`VM (Virtual Machine)` 映像。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:14
msgid "Overview"
msgstr "概述"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:16
msgid ""
"`VMware ESXi`_ is a type 1 bare-metal hypervisor which runs directly on "
"top of server hardware. With VMware ESXi, you can create, configure, "
"manage, and run |CL-ATTR| virtual machines at scale."
msgstr "`VMware ESXi`_ 是一个 1 类裸机虚拟机管理程序,可直接在服务器硬件上运行。利用 VMware ESXi,可以大规模创建、配置、管理和运行 |CL-ATTR| 虚拟机。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:20
msgid ""
"We provide a pre-configured |CL| VMware image that can be run on a VMware"
" ESXi 6.5 host."
msgstr "我们提供可在 VMware ESXi 6.5 主机上运行的 |CL| VMware 映像。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:23
msgid ""
"If manuall installation is preferred, refer to :ref:`vmware-esxi-install-"
"cl`."
msgstr "如果喜欢手动安装,请参阅 :ref:`vmware-esxi-install-cl`。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:27
msgid ""
"VMware also offers a type 2 hypervisor designed for the desktop "
"environment, called `VMware Workstation Player`_. Refer to :ref:`vmw-"
"player-preconf` or :ref:`vmw-player` for more information."
msgstr "VMware 还提供一个适用于桌面环境的 2 类虚拟机管理程序,名为 `VMware Workstation Player`_。请参阅 :ref:`vmw-player-preconf` 或 :ref:`vmw-player` 了解更多信息。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:32
msgid "Download the latest |CL| VMware image"
msgstr "下载最新的 |CL| VMware 映像"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:34
msgid ""
"Get the latest |CL| VMware prebuilt image from the `image`_ repository. "
"Look for :file:`clear-[version number]-vmware.vmdk.xz`. You can also use "
"this command:"
msgstr "从 `image`_ 存储库中获取最新的 |CL| VMware 预构建映像。查找 :file:`clear-[version number]-vmware.vmdk.xz`。还可以使用以下命令:"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:42
msgid ""
"Visit :ref:`image-types` for additional information about all available "
"|CL| images."
msgstr "访问 :ref:`image-types`,了解关于所有 |CL| 映像的其他信息。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:44
msgid ""
"We also provide instructions for downloading and verifying a Clear Linux "
"ISO. For more information, refer to :ref:`download-verify-decompress`."
msgstr "我们还提供关于下载和验证 Clear Linux ISO 的说明。欲了解详情,请参阅 :ref:`download-verify-decompress`。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:48
msgid "Upload the |CL| image to the VMware server"
msgstr "将 |CL| 映像上传至 VMware 服务器"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:50
msgid ""
"Once the |CL| VMware prebuilt image has been downloaded and decompressed "
"on your local system, it must be uploaded to a datastore on the VMware "
"ESXi server."
msgstr "在本地系统下载并解压缩 |CL| VMware 预构建映像后,必须将其上传至 VMware ESXi 服务器上的数据存储。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:54
msgid ""
"The steps in this section can also be referenced from the VMware "
"documentation `Using Datastore File Browser in the VMware Host Client`_."
msgstr "有关本节中的步骤,还可以参考 VMware 文档 `Using Datastore File Browser in the VMware Host Client`_。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:57
msgid ""
"Connect to the VMware ESXi server and login to an account with sufficient"
" permission to create and manage VMs."
msgstr "连接 VMware ESXi 服务器,登录拥有充分权限的帐户,以创建和管理虚拟机。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:60
msgid ""
"Under the :guilabel:`Navigator` window on the left side, select "
":guilabel:`Storage`. See Figure 1"
msgstr "在左侧的 :guilabel:`Navigator` 窗口中,选择 :guilabel:`Storage`。见图 1"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:64
msgid ""
"Under the :guilabel:`Datastores` tab, click the :guilabel:`Datastore "
"browser` button."
msgstr "在 :guilabel:`Datastores` 标签下,点击 :guilabel:`Datastore browser` 按钮。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:71
msgid "Figure 1: VMware ESXi - Navigator > Storage"
msgstr "图 1VMware ESXi - 浏览器 > 存储"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:73
msgid ""
"Click the :guilabel:`Create directory` button and name the directory "
"`Clear Linux VM`. See Figure 2."
msgstr "点击 :guilabel:`Create directory` 按钮,将目录命名为 `Clear Linux VM`。见图 2。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:80
msgid "Figure 2: VMware ESXi - Datastore > Create directory"
msgstr "图 2VMware ESXi - 数据存储 > 创建目录"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:82
msgid ""
"Select the newly-created directory and click the :guilabel:`Upload` "
"button. See Figure 3."
msgstr "选择新建目录,点击 :guilabel:`Upload` 按钮。见图 3。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:89
msgid "Figure 3: VMware ESXi - Datastore > Upload VMware image"
msgstr "图 3VMware ESXi - 数据存储 > 上传 VMware 映像"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:91
msgid ""
"Select the decompressed |CL| VMware image file :file:`clear-[version "
"number]-vmware.vmdk` and upload it."
msgstr "选择解压缩的 |CL| Vmware 映像文件 :file:`clear-[version number]-vmware.vmdk` 并上传。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:95
msgid "Convert the |CL| image to an ESXi-supported format"
msgstr "将 |CL| 映像转换为 ESXi 支持的格式。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:97
msgid ""
"Once the |CL| VMware prebuilt image has been uploaded to the VMware ESXi "
"datastore, it must be converted to a format for use with VMware's ESXi "
"hypervisor."
msgstr "|CL| VMware 预构建映像上传至 VMware ESXi 数据存储后,必须将其转换为 VMware's ESXi 虚拟机管理程序可以使用的格式。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:101
msgid ""
"The steps in this section can also be referenced from the VMware "
"documentation on `Cloning and converting virtual machine disks with "
"vmkfstools`_"
msgstr "有关本节中的步骤,还可以参考 VMware 文档 `Cloning and converting virtual machine disks with vmkfstools`_"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:103
msgid ""
"SSH into the `vSphere Management Assistant`_ appliance that is managing "
"the ESXi host or connect to the vSphere hosting using the `vSphere CLI`_."
msgstr "通过 SSH 连接到 `vSphere Management Assistant`_ 设备,利用 `vSphere CLI`_ 管理 ESXi 主机或连接到 vSphere 主机托管。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:108
msgid ""
"If there is no :abbr:`vMA (vSphere Management Assistant)` appliance or "
":abbr:`vCLI (vSphere CLI)` configured and available, you can temporarily "
"enable SSH directly on the ESXi host by following the steps described in "
"`Enable the Secure Shell (SSH) in the VMware Host Client`_."
msgstr "如果没有配置或可用的 :abbr:`vMA (vSphere Management Assistant)` 设备或 :abbr:`vCLI (vSphere CLI)`,则可以按照 `在 VMware 主机客户端启用 Secure Shell (SSH)`_ 中所述步骤直接在 ESXi 主机上临时启用 SSH。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:112
msgid ""
"As a security best practice, remember to disable SSH access after "
"following the steps in this section."
msgstr "作为最佳安全实践,务必按照本节中的步骤操作之后禁用 SSH 访问。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:115
msgid ""
"Locate the uploaded image, which is typically found in "
":file:`/vmfs/volumes/datastore1`."
msgstr "找出上传的映像,该映像通常位于 :file:`/vmfs/volumes/datastore1`。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:118
msgid ""
"Use the :command:`vmkfstools` command to perform the conversion, as shown"
" below:"
msgstr "使用 :command:`vmkfstools` 命令进行转换,如下所示:"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:125
msgid "Two files should result from this:"
msgstr "由此应产生两个文件:"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:127
msgid ":file:`clear-[version number]-esxi-flat.vmdk`"
msgstr ":file:`clear-[version number]-esxi-flat.vmdk`"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:128
msgid ":file:`clear-[version number]-esxi.vmdk`"
msgstr ":file:`clear-[version number]-esxi.vmdk`"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:130
msgid ""
"The :file:`clear-[version number]-esxi.vmdk` file will be used in the "
"next section when you create a new VM."
msgstr ":file:`clear-[version number]-esxi.vmdk` 文件会在下一节创建新虚拟机时用到。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:134
msgid "Create and configure a new VM"
msgstr "创建并配置新虚拟机"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:136
msgid ""
"In this section, you will create a new VM, configure its basic parameters"
" such as number of CPUs, memory size, and then attach the converted |CL| "
"VMware image. Also, in order to boot |CL|, you must enable UEFI support."
msgstr "本节中,您会创建新虚拟机,配置基本参数,如 CPU 数量、内存大小,然后挂载转换后的 |CL| VMware 映像。而且,为了引导 |Cl|,必须启用 UEFI 支持。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:140
msgid ""
"Under the :guilabel:`Navigator` window, select :guilabel:`Virtual "
"Machines`. See Figure 4."
msgstr "在 :guilabel:`Navigator` 窗口中,选择 :guilabel:`Virtual Machines`。见图 4。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:143
msgid "In the right window, click the :guilabel:`Create / Register VM` button."
msgstr "在右侧窗口中,点击 :guilabel:`Create / Register VM` 按钮。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:149
msgid "Figure 4: VMware ESXi - Navigator > Virtual Machines"
msgstr "图 4VMware ESXi - 浏览器 > 虚拟机"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:151
msgid "On the :guilabel:`Select creation type` step:"
msgstr "在 :guilabel:`Select creation type` 步骤:"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:153
msgid "Select the :guilabel:`Create a new virtual machine` option. See Figure 5."
msgstr "选择 :guilabel:`Create a new virtual machine` 选项。见图 5。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:156
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:173
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:184
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:255
msgid "Click the :guilabel:`Next` button."
msgstr "点击 :guilabel:`Next` 按钮。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:162
msgid "Figure 5: VMware ESXi - Create a new virtual machine"
msgstr "图 5VMware ESXi - 创建新虚拟机"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:164
msgid "On the :guilabel:`Select a name and guest OS` step:"
msgstr "在 :guilabel:`Select a name and guest OS` 步骤:"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:166
msgid "Give the new VM a name in the :guilabel:`Name` field. See Figure 6."
msgstr "在 :guilabel:`Name` 字段中为新虚拟机命名。见图 6。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:168
msgid ""
"Set the :guilabel:`Compatability` option to :guilabel:`ESXi 6.5 virtual "
"machine`."
msgstr "将 :guilabel:`Compatability` 选项设置为 :guilabel:`ESXi 6.5 virtual machine`。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:170
msgid "Set the :guilabel:`Guest OS family` option to :guilabel:`Linux`."
msgstr "将 :guilabel:`Guest OS family` 选项设置为 :guilabel:`Linux`。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:171
msgid ""
"Set the :guilabel:`Guest OS version` option to :guilabel:`Other 3.x or "
"later Linux (64-bit)`."
msgstr "将 :guilabel:`Guest OS version` 选项设置为 :guilabel:`Other 3.x or later Linux (64-bit)`。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:179
msgid "Figure 6: VMware ESXi - Give a name and select guest OS type"
msgstr "图 6VMware ESXi - 命名并选择来宾操作系统类型"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:181
msgid "On the :guilabel:`Select storage` step:"
msgstr "在 :guilabel:`Select storage` 步骤:"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:183
msgid "Accept the default option."
msgstr "接受默认选项。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:186
msgid "On the :guilabel:`Customize settings` step:"
msgstr "在 :guilabel:`Customize settings` 步骤:"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:188
msgid "Click the :guilabel:`Virtual Hardware` button. See Figure 7."
msgstr "点击 :guilabel:`Virtual Hardware` 按钮。见图 7。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:189
msgid ""
"Expand the :guilabel:`CPU` setting and enable :guilabel:`Hardware "
"virtualization` by checking :guilabel:`Expose hardware assisted "
"virtualization to the guest OS`."
msgstr "展开 :guilabel:`CPU` 设置,选中 :guilabel:`Hardware virtualization` 启用 :guilabel:`Expose hardware assisted virtualization to the guest OS`。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:197
msgid "Figure 7: VMware ESXi - Enable hardware virtualization"
msgstr "图 7VMware ESXi - 启用硬件虚拟化"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:199
msgid ""
"Remove the default :guilabel:`Hard drive 1` setting by clicking the `X` "
"icon on the right side. See Figure 8."
msgstr "点击右侧的 `X` 图标,移除默认 :guilabel:`Hard drive 1` 设置。见图 8。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:206
msgid "Figure 8: VMware ESXi - Remove hard drive"
msgstr "图 8VMware ESXi - 移除硬盘"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:208
msgid ""
"Since a pre-configured image will be used, the :guilabel:`CD/DVD Drive 1`"
" setting will not be needed. Disable it by unchecking the "
":guilabel:`Connect` checkbox. See Figure 9."
msgstr "由于要使用预配置映像,所以不再需要 :guilabel:`CD/DVD Drive 1` 设置。取消选中 :guilabel:`Connect` 复选框禁用该设置。见图 9。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:216
msgid "Figure 9: VMware ESXi - Disconnect the CD/DVD drive"
msgstr "图 9VMware ESXi - 断开 CD/DVD 驱动器"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:218
msgid ""
"Attach the :file:`clear-[version number]-esxi.vmdk` file that was "
"converted from the pre-configured |CL| VMware image."
msgstr "挂载 :file:`clear-[version number]-esxi.vmdk` 文件。该文件从预配置的 |CL| VMware 映像转换而来。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:221
msgid ""
"Click the :guilabel:`Add hard disk` button and select the "
":guilabel:`Existing hard drive` option. See Figure 10."
msgstr "点击 :guilabel:`Add hard disk` 按钮,选择 :guilabel:`Existing hard drive` 选项。见图 10。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:228
msgid "Figure 10: VMware ESXi - Add an existing hard drive"
msgstr "图 10: VMware ESXi - 添加现有硬盘"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:230
msgid ""
"Select the converted :file:`clear-[version number]-esxi.vmdk` file. Do "
"not use the original unconverted :file:`clear-[version "
"number]-vmware.vmdk` file. See Figure 11."
msgstr "选择已转换的 :file:`clear-[version number]-esxi.vmdk` 文件。不要使用最初未转换的 :file:`clear-[version number]-vmware.vmdk` 文件。见图 11。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:238
msgid ""
"Figure 11: VMware ESXi - Select the converted :file:`clear-[version "
"number]-esxi.vmdk` file"
msgstr "图 11VMware ESXi - 选择已转换的 :file:`clear-[version number]-esxi.vmdk` 文件"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:241
msgid "|CL| needs UEFI support in order to boot. Enable UEFI boot support."
msgstr "|CL| 需要 UEFI 支持才可以引导。启用 UEFI 引导支持。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:243
msgid "Click the :guilabel:`VM Options` button. See Figure 12."
msgstr "点击 :guilabel:`VM Options` 按钮。见图 12。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:244
msgid "Expand the :guilabel:`Boot Options` setting."
msgstr "展开 :guilabel:`Boot Options` 设置。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:245
msgid ""
"For the :guilabel:`Firmware` setting, click the drop-down list to the "
"right of it and select the :guilabel:`EFI` option."
msgstr "对于 :guilabel:`Firmware` 设置,点击其右侧的下拉列表,选择 :guilabel:`EFI` 选项。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:252
msgid "Figure 12: VMware ESXi - Set boot firmware to EFI"
msgstr "图 12VMware ESXi - 将引导固件设置为 EFI"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:254
msgid "Click the :guilabel:`Save` button."
msgstr "点击 :guilabel:`Save` 按钮。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:256
msgid "Click the :guilabel:`Finish` button."
msgstr "点击 :guilabel:`Finish` 按钮。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:259
msgid "Power on the VM and boot |CL|"
msgstr "开启虚拟机,引导 |CL|"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:261
msgid "After configuring the settings above, power on the VM."
msgstr "配置上述设置后,开启虚拟机。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:263
msgid ""
"Under the :guilabel:`Navigator` window, select :guilabel:`Virtual "
"Machines`. See Figure 13."
msgstr "在 :guilabel:`Navigator` 窗口中,选择 :guilabel:`Virtual Machines`。见图 13。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:265
msgid "In the right window, select the newly-created VM."
msgstr "在右侧窗口中,选择新创建的虚拟机。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:266
msgid "Click the :guilabel:`Power on` button."
msgstr "点击 :guilabel:`Power on` 按钮。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:267
msgid ""
"Click on the icon representing the VM to bring it into view and maximize "
"its window."
msgstr "点击代表虚拟机的图标,显示虚拟机,将虚拟机窗口最大化。"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:274
msgid "Figure 13: VMware ESXi - Navigator > Virtual Machines > Power on VM"
msgstr "图 13VMware ESXi - 浏览器 > 虚拟机 > 开启虚拟机"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:277
msgid "Related topics"
msgstr "相关主题"
#: ../../get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst:279
msgid ":ref:`vmware-esxi-install-cl`"
msgstr ":ref:`vmware-esxi-install-cl`"
#~ msgid ""
#~ "This section shows you how to "
#~ "deploy a preconfigured |CL| VMware "
#~ ":abbr:`VM (Virtual Machine)` image on a"
#~ " VMware ESXi 6.5 host."
#~ msgstr ""
#~ msgid ""
#~ "If you would prefer to perform a"
#~ " manual installation of |CL| into a"
#~ " new VMware ESXi :abbr:`VM (Virtual "
#~ "Machine)` instead, see :ref:`vmware-esxi-"
#~ "install-cl`."
#~ msgstr ""
#~ msgid ""
#~ "VMware also offers a type 2 "
#~ "hypervisor called `VMware Workstation Player`"
#~ " which is designed for the desktop"
#~ " environment."
#~ msgstr ""
#~ msgid "See :ref:`vmw-player-preconf` or see :ref:`vmw-player`."
#~ msgstr ""
#~ msgid "Install steps:"
#~ msgstr ""
#~ msgid ""
#~ "The steps in this section can also"
#~ " be referenced from the `VMware "
#~ "documentation on Using the Datastore "
#~ "File Browser`_"
#~ msgstr ""
#~ msgid ""
#~ "The steps in this section can also"
#~ " be referenced from the `VMware "
#~ "documentation on Cloning and converting "
#~ "virtual machine disks with vmkfstools`_"
#~ msgstr ""
#~ msgid ""
#~ "If there is no :abbr:`vMA (vSphere "
#~ "Management Assistant)` appliance or "
#~ ":abbr:`vCLI (vSphere CLI)` configured and "
#~ "available, you can temporarily enable "
#~ "SSH directly on the ESXi host by"
#~ " referencing the `VMware documentation on"
#~ " Enable the Secure Shell (SSH)`_ ."
#~ msgstr ""
#~ msgid "Decompress the |CL| image"
#~ msgstr ""
#~ msgid ""
#~ "Released |CL| images are compressed with"
#~ " either GNU zip (*.gz*) or XZ "
#~ "(*.xz*). The compression type depends on"
#~ " the target platform or environment. "
#~ "To decompress the image, follow these"
#~ " steps:"
#~ msgstr ""
#~ msgid "Start a terminal emulator."
#~ msgstr ""
#~ msgid "Go to the directory with the downloaded image."
#~ msgstr ""
#~ msgid "To decompress an XZ image, enter:"
#~ msgstr ""
#~ msgid "To decompress a GZ image, enter:"
#~ msgstr ""
#~ msgid "For alternative instructions on other operating systems, see:"
#~ msgstr ""
#~ msgid ":ref:`download-verify-decompress-mac`"
#~ msgstr ""
#~ msgid ":ref:`download-verify-decompress-windows`"
#~ msgstr ""
#~ msgid "Run pre-configured |CL-ATTR| image as a VMware\\* ESXi guest OS"
#~ msgstr "运行预配置的 |CL-ATTR| 映像,用作 VMware\\* ESXi 来宾操作系统"
@@ -0,0 +1,161 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../tooling/autoproxy.rst:4
msgid "Autoproxy"
msgstr "Autoproxy"
#: ../../tooling/autoproxy.rst:6
msgid ""
"Autoproxy is provided to enable |CL-ATTR| to work smoothly behind a "
"corporate proxy."
msgstr "借助 Autoproxy|CL-ATTR| 可在公司代理服务器后平稳运行。"
#: ../../tooling/autoproxy.rst:14
msgid "Description"
msgstr "描述"
#: ../../tooling/autoproxy.rst:16
msgid ""
"Autoproxy tries to detect a Proxy Auto-Config (PAC) script and use it to "
"automatically resolve the proxy needed for a given connection. With "
"Autoproxy, you can use |CL| inside any proxy environment without having "
"to manually configure the proxies."
msgstr "Autoproxy 会尝试检测代理自动配置 (PAC) 脚本,并使用其自动解析给定连接所需的代理。使用 Autoproxy,可以在任意代理环境下使用 |CL|,而无需手动配置代理。"
#: ../../tooling/autoproxy.rst:21
msgid ""
"Corporate and private networks can be very complex, needing to restrict "
"and control network connections for security reasons. The typical side "
"effects are limited or blocked connectivity, and require manual "
"configuration of proxies to perform the most mundane tasks, such as "
"cloning a repo or checking for updates. With |CL|, all of the work is "
"done behind the scenes to effortlessly use your network and have "
"connections “just work”."
msgstr "公司和专用网络可能非常复杂,因此出于安全原因需限制和控制网络连接。常见的负面效果是限制或阻止连接,且需手动配置代理以执行最普通的任务,例如克隆存储库或检查是否存在更新。通过 |CL|,所有工作便可在后台完成,以便轻松使用网络并使连接“正常工作”。"
#: ../../tooling/autoproxy.rst:28
msgid ""
"This feature removes severe complications with network connectivity due "
"to proxy issues. You can automate tasks, such as unit testing, without "
"worrying about the proxy not being set, and you can remove unset proxies "
"from the equation when dealing with network unavailability across "
"systems."
msgstr "此功能可消除因代理问题所导致的极端复杂的网络连接难题。可以自动执行任务(例如单元测试),而无需担心代理未设置,并可在处理跨系统的网络不可用问题时将未设置代理这一因素排除在外。"
#: ../../tooling/autoproxy.rst:34
msgid "How it works"
msgstr "工作原理"
#: ../../tooling/autoproxy.rst:36
msgid ""
"We designed Autoproxy around tools provided by most Linux\\* "
"distributions with a few minor additions and modifications. We leveraged "
"the DHCP and network information obtained from systemd and created a PAC-"
"discovery daemon. The daemon uses the information to resolve a URL for a "
"PAC file. The daemon then passes the URL into PACrunner\\*. PACrunner "
"downloads the PAC file and uses the newly implemented Duktape\\* engine "
"to parse it."
msgstr "我们围绕多数 Linux\\* 发行版提供的工具设计了 Autoproxy,同时还进行了一些小的补充和修改。我们利用从系统获取的 DHCP 和网络信息,创建了 PAC 发现守护程序。该守护程序使用此信息来解析 PAC 文件的 URL。然后,守护程序将此 URL 传入 PACrunner\\*。PACrunner 下载 PAC 文件,使用新实现的 Duktape\\* 引擎来对其进行解析。"
#: ../../tooling/autoproxy.rst:47
msgid "Figure 1: Autoproxy Flow"
msgstr "图 1Autoproxy 流程"
#: ../../tooling/autoproxy.rst:49
msgid ""
"From that point on, any cURL\\* or network requests query PACrunner for "
"the correct proxy to use. We modified the cURL library to communicate "
"with PACrunner over DBus. However, cURL will ignore PACrunner and run "
"normally if no PAC file is loaded or if you manually set any proxies. "
"Thus, your environment settings are respected and no time is wasted "
"trying to resolve a proxy. All these steps happen in the background with "
"no user interaction."
msgstr "此后,所有 cURL\\* 或网络请求均会查询 PACrunner 以使用正确的代理。我们修改了 cURL 库以通过 DBus 与 PACrunner 进行通信。但是,如果未加载 PAC 文件或手动设置代理,cURL 则会忽略 PACrunner 并正常运行。如此一来,环境设置便会得以应用,且不会浪费时间来尝试解析代理。所有这些步骤均在后台执行,而无需用户介入。"
#: ../../tooling/autoproxy.rst:57
msgid "Troubleshooting"
msgstr "故障检修"
#: ../../tooling/autoproxy.rst:59
msgid ""
"Autoproxy allows |CL| to operate seamlessly behind a proxy because "
":ref:`swupd <swupd-guide>` and other |CL| tools are implemented on top of"
" libcurl. Tools that do not use libcurl, like git, must be configured "
"independently."
msgstr "Autoproxy 允许 |CL| 在代理后无缝运行,因为 :ref:`swupd <swupd-guide>` 和其他 |CL| 工具的实现均基于 libcurl。不使用 libcurl 的工具(例如 git)则须单独配置。"
#: ../../tooling/autoproxy.rst:64
msgid ""
"If you are familiar with PAC files and WPAD, you can use "
":command:`pacdiscovery` and :command:`FindProxyForURL` to troubleshoot "
"problems with autproxy."
msgstr "如果熟悉 PAC 文件和 WPAD,则可使用 :command:`pacdiscovery` 和 :command:`FindProxyForURL`,通过 Autoproxy 进行故障排除。"
#: ../../tooling/autoproxy.rst:70
msgid "Learn more about WPAD, PAC files, and PAC functions at `findproxyforurl`_."
msgstr "访问 `findproxyforurl`_,了解有关 WPAD、PAC 文件和 PAC 的更多信息。"
#: ../../tooling/autoproxy.rst:74
msgid "Run :command:`pacdiscovery` with no arguments to indicate"
msgstr "不带参数运行 :command:`pacdiscovery`,可以明确"
#: ../../tooling/autoproxy.rst:76
msgid "if there is a problem resolving the :command:`WPAD` host name resolution:"
msgstr "解析 :command:`WPAD` 主机名时是否出现问题:"
#: ../../tooling/autoproxy.rst:87
msgid "or if the :command:`pacrunner` service is disabled (masked)."
msgstr "或是是否已禁用(已屏蔽) :command:`pacrunner` 服务。"
#: ../../tooling/autoproxy.rst:98
msgid "Unmask the :command:`pacrunner` service by running:"
msgstr "运行以下命令取消屏蔽 :command:`pacrunner` 服务:"
#: ../../tooling/autoproxy.rst:104
msgid ""
":command:`FindProxyForURL` with :command:`busctl` can also indicate if "
"the :command:`pacrunner.service` is masked."
msgstr ":command:`FindProxyForURL` 和 :command:`busctl`,也可以明确是否已屏蔽 :command:`pacrunner.service`。"
#: ../../tooling/autoproxy.rst:117
msgid ""
":command:`FindProxyForURL` returns the URL and port of the proxy server "
"when an external URL and host are provided as arguments."
msgstr ":command:`FindProxyForURL` 会在外部 URL 和主机作为参数提供时,返回代理服务器的 URL 和端口。"
#: ../../tooling/autoproxy.rst:129
msgid ""
"If a proxy server is not avialable, or if :command:`pacrunner` is running"
" without a PAC file, :command:`FindProxyForURL` will return \"DIRECT\"."
msgstr "如果无代理服务器或是 :command:`pacrunner` 正在运行但不带 PAC 文件,:command:`FindProxyForURL` 则会返回 \"DIRECT\"。"
#: ../../tooling/autoproxy.rst:141
msgid ""
"Once :command:`pacdiscovery` is able to look up :command:`WPAD`, restart "
"the :command:`pacrunner` service:"
msgstr ":command:`pacdiscovery` 可查找 :command:`WPAD` 后,立即重新启动 :command:`pacrunner` 服务:"
#: ../../tooling/autoproxy.rst:151
msgid ""
"A \"domain\" or \"search\" entry in :file:`/etc/resolv.conf` is required "
"for short name lookups to resolve. The :file:`resolv.conf` man page has "
"additional details."
msgstr ":file:`/etc/resolv.conf` 中的 \"domain\" 或 \"search\" 条目是查找短名称以便进行解析所必需的条目。:File:`resolv.conf` 手册页包含其他详细信息。"
@@ -0,0 +1,611 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-05 12:07-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../guides/clear/autospec.rst:4
msgid "autospec"
msgstr "autospec"
#: ../../guides/clear/autospec.rst:6
msgid ""
"**autospec** is a tool used to assist with the automated creation and "
"maintenance of RPM packaging in |CL-ATTR|. Where a standard :abbr:`RPM "
"(RPM Package Manager)` build process using :command:`rpmbuild` requires a"
" tarball and :file:`.spec` file to start, autospec requires only a "
"tarball and package name to start."
msgstr "**autospec** 是在 |CL-ATTR| 中协助自动创建和维护 RPM 封装的工具。其中,使用 :command:`rpmbuild` 的标准 :abbr:`RPM (RPM Package Manager)` 构建流程需要 tarball 和 :file:`.spec` 文件才能启动,而 autospec 只需 tarball 和软件包名称便可启动。"
#: ../../guides/clear/autospec.rst:17
msgid "Description"
msgstr "描述"
#: ../../guides/clear/autospec.rst:19
msgid ""
"The autospec tool attempts to infer the requirements of the :file:`.spec`"
" file by analyzing the source code and :file:`Makefile` information. It "
"continuously runs updated builds based on new information discovered from"
" build failures until it has a complete and valid :file:`.spec` file. If "
"needed, you can influence the behavior of autospec and customize the "
"build by providing optional `control files`_ to the autospec tool."
msgstr "autospec 工具通过分析源代码和 :file:`Makefile` 信息来尝试推断 :file:`.spec` 文件的要求。它会根据从构建失败中发现的新信息不断运行更新后的内部版本,直到它具有完整有效的 :file:`.spec` 文件。如有必要,可以在 autospec 工具中增加可选的 `control files`_,影响 autospec 的行为,定制内部版本。"
#: ../../guides/clear/autospec.rst:26
msgid ""
"autospec uses **mock** as a sandbox to run the builds. Visit the `mock "
"wiki`_ for additional information on using mock."
msgstr "autospec 使用模拟作为沙箱运行内部版本。访问 `mock wiki`_,了解有关使用模拟的其他信息。"
#: ../../guides/clear/autospec.rst:29
msgid ""
"For a general understanding of how an RPM works, visit the `rpm website`_"
" or the `RPM Packaging Guide`_."
msgstr "要大致了解 RPM 工作原理,请访问 `rpm website`_ 或 `RPM Packaging Guide`_。"
#: ../../guides/clear/autospec.rst:33
msgid "How it works"
msgstr "工作原理"
#: ../../guides/clear/autospec.rst:35
msgid "Learn the autospec tool set up and process."
msgstr "了解 autospec 工具的设置和流程。"
#: ../../guides/clear/autospec.rst:42
msgid "Prerequisites"
msgstr "必备条件"
#: ../../guides/clear/autospec.rst:44
msgid ""
"The setup for building source in |CL| must be completed before using the "
"autospec tool."
msgstr "使用 autospec 工具之前,必须先在 |CL| 中完成构建源代码的设置操作。"
#: ../../guides/clear/autospec.rst:47
msgid ""
"Refer to `Setup environment to build source`_ for instructions on "
"completing the setup."
msgstr "请参阅 `设置环境以构建源代码`_,了解有关完成此设置的说明。"
#: ../../guides/clear/autospec.rst:51
msgid "Create an RPM"
msgstr "创建 RPM"
#: ../../guides/clear/autospec.rst:53
msgid "The basic autospec process is described in the following steps:"
msgstr "autospec 的基本流程如以下步骤所述:"
#: ../../guides/clear/autospec.rst:55
msgid ""
"The :command:`make autospec` command generates a :file:`.spec` file based"
" on the analysis of code and existing control files."
msgstr ":command:`make autospec` 命令根据对代码和现有控制文件的分析生成 :file:`.spec` 文件。"
#: ../../guides/clear/autospec.rst:58
msgid ""
"Any control files should be located in the same directory as the "
"resulting :file:`.spec` file."
msgstr "所有控制文件均应与所生成 :file:`.spec` 文件位于同一目录。"
#: ../../guides/clear/autospec.rst:61
msgid "View the `autospec README`_ for more information on `control files`_."
msgstr "查看 `autospec README`_,了解有关 `control files`_ 的更多信息。"
#: ../../guides/clear/autospec.rst:63
msgid "autospec creates a build root with mock config."
msgstr "autospec 通过模拟配置来创建内部版本根目录。"
#: ../../guides/clear/autospec.rst:65
msgid "autospec attempts to build an RPM from the generated :file:`.spec`."
msgstr "autospec 会尝试通过所生成的 :file:`.spec` 来构建 RPM。"
#: ../../guides/clear/autospec.rst:67
msgid "autospec detects any missed declarations in the :file:`.spec`."
msgstr "autospec 会检测 :file:`.spec` 中的所有缺失声明。"
#: ../../guides/clear/autospec.rst:69
msgid ""
"If build errors occur, autospec scans the build log to try to detect the "
"root cause."
msgstr "如果出现构建错误,autospec 则会扫描构建日志,尝试发现根源所在。"
#: ../../guides/clear/autospec.rst:72
msgid ""
"If autospec detects the root cause and knows how to continue, it restarts"
" the build automatically at step 1 with updated build instructions."
msgstr "如果 autospec 检测到根源,且知如何继续,则会在步骤 1 中利用更新后的构建指令自动重新启动构建。"
#: ../../guides/clear/autospec.rst:75
msgid ""
"Otherwise, autospec stops the build for user inspection to resolve the "
"errors. Respond to the build process output by fixing source code issues "
"and/or editing control files to resolve issues, which may include "
"dependencies or exclusions. See `autospec README`_ for more information "
"on control files."
msgstr "否则,autospec 会停止构建,以供用户检查,纠正错误。修复源代码问题和/或编辑控制文件,响应构建过程输出,从而解决问题。这些问题可能包括依存关系或排除项。查看 `autospec README`_,了解有关控制文件的更多信息。"
#: ../../guides/clear/autospec.rst:81
msgid "The user resumes the process at step 1 after errors are resolved."
msgstr "纠正错误后,用户在步骤 1 中恢复此流程。"
#: ../../guides/clear/autospec.rst:83
msgid ""
"If a binary dependency doesn't exist in |CL|, you must build it before "
"running autospec again."
msgstr "如果 |CL| 中不存在二进制依存关系,则须先构建这种关系,然后才能再次运行 autospec。"
#: ../../guides/clear/autospec.rst:86
msgid ""
"Following these steps, autospec continues to rebuild the package, based "
"on new information discovered from build failures, until it has a valid "
":file:`.spec`. If no build errors occur, RPM packages are successfully "
"built."
msgstr "执行完这些步骤后,autospec 根据从构建失败中发现的新信息继续重新构建软件包,直到它具有有效的 :file:`.spec`。如果未出现构建错误,则会成功构建 RPM 包。"
#: ../../guides/clear/autospec.rst:91
msgid "Examples"
msgstr "示例"
#: ../../guides/clear/autospec.rst:93
msgid "Complete `Setup environment to build source`_ before using these examples."
msgstr "在使用这些示例之前,请先完成 `设置环境以构建源代码`_。"
#: ../../guides/clear/autospec.rst:100
msgid "Example 1: Build RPM with an existing spec file"
msgstr "例 1:使用现有规格文件构建 RPM"
#: ../../guides/clear/autospec.rst:102
msgid ""
"This example shows how to build a RPM from a pre-packaged upstream "
"package with an existing spec file. The example uses the ``dmidecode`` "
"package."
msgstr "本例介绍如何使用现有规格文件通过预封装的上游软件包来构建 RPM。本例采用 ``dmidecode`` 软件包。"
#: ../../guides/clear/autospec.rst:105 ../../guides/clear/autospec.rst:161
msgid "Navigate to the autospec workspace and clone the ``dmidecode`` package:"
msgstr "导航到 autospec 工作区并克隆 ``dmidecode`` 软件包:"
#: ../../guides/clear/autospec.rst:114
msgid "You can clone all package repos at once using the following command:"
msgstr "您可使用以下命令一次性克隆所有软件包存储库:"
#: ../../guides/clear/autospec.rst:120 ../../guides/clear/autospec.rst:217
msgid "The optional NUM is the number of threads to use."
msgstr "可选 NUM 参数表示待用线程数量。"
#: ../../guides/clear/autospec.rst:122
msgid ""
"For a list of available packages, view the "
":file:`~/clearlinux/projects/common/packages` file."
msgstr "有关可用软件包的列表,请查看 :file:`~/clearlinux/projects/common/packages` 文件。"
#: ../../guides/clear/autospec.rst:125
msgid "Navigate to the local copy of the ``dmidecode`` package and build it:"
msgstr "导航到 ``dmidecode`` 软件包的本地副本进行构建:"
#: ../../guides/clear/autospec.rst:132
msgid ""
"The resulting RPMs are in :file:`./rpms`. Build logs and additional RPMs "
"are in :file:`./results`."
msgstr "生成的 RPM 位于 :file:`./rpms`。构建日志和其他 RPM 则位于 :file:`./results`。"
#: ../../guides/clear/autospec.rst:136
msgid "Example 2: Build a new RPM"
msgstr "例 2:构建新的 RPM"
#: ../../guides/clear/autospec.rst:138
msgid ""
"This example shows how to build a new RPM with no spec file. The example "
"will create a simple helloclear RPM."
msgstr "本例介绍如何构建新的 RPM,而不使用规格文件。本例会创建简易的 helloclear RPM。"
#: ../../guides/clear/autospec.rst:141
msgid ""
"Navigate to the autospec workspace and build the helloclear RPM. The "
":file:`Makefile` provides a :command:`make autospecnew` that can "
"automatically generate an RPM package using the autospec tool. You must "
"pass the URL to the source tarball and the NAME of the RPM you wish to "
"create:"
msgstr "导航到 autospec 工作区并构建 helloclear RPM。:file:`Makefile` 提供 :command:`make autospecnew`,可以使用 autospec 工具自动生成 RPM 包。必须将 URL 传递给源 tarball 以及待创建 RPM 的 NAME"
#: ../../guides/clear/autospec.rst:151
msgid ""
"The resulting RPMs are in :file:`./packages/helloclear/rpms`. Build logs "
"and additional RPMs are in :file:`./packages/helloclear/results`."
msgstr "生成的 RPM 位于 :file:`./packages/helloclear/rpms`。构建日志和其他 RPM 则位于 :file:`./packages/helloclear/results`。"
#: ../../guides/clear/autospec.rst:155
msgid "Example 3: Generate a new spec file with a pre-defined package"
msgstr "例 3:使用预定义软件包生成新的规格文件"
#: ../../guides/clear/autospec.rst:157
msgid ""
"This example shows how to modify an existing package to create a custom "
"RPM. In this example you will make a simple change to the ``dmidecode`` "
"package and rebuild the package."
msgstr "本例介绍如何修改现有软件包来创建定制 RPM。本例会对 ``dmidecode`` 软件包进行简单的更改并重新构建软件包。"
#: ../../guides/clear/autospec.rst:168
msgid "Navigate into the *dmidecode* directory:"
msgstr "导航到 *dmidecode* 目录:"
#: ../../guides/clear/autospec.rst:174
msgid "Open the :file:`excludes` file with an editor and add these lines:"
msgstr "用编辑器打开 :file:`excludes` 文件,添加以下行:"
#: ../../guides/clear/autospec.rst:187
msgid ""
"These files aren't needed by dmidecode, so we can remove them without any"
" issues."
msgstr "dmidecode 不需要这些文件,因此可放心将其删除。"
#: ../../guides/clear/autospec.rst:190
msgid ""
"In the :file:`dmidecode` directory, build the modified ``dmidecode`` "
"package:"
msgstr "在 :file:`dmidecode` 目录中,构建修改后的 ``dmidecode`` 软件包:"
#: ../../guides/clear/autospec.rst:196
msgid "The resulting RPMs are in :file:`./rpms`. Logs are in :file:`./results`."
msgstr "生成的 RPM 位于 :file:`./rpms`。日志则位于 :file:`./results`。"
#: ../../guides/clear/autospec.rst:199
msgid "Example 4: Provide control files to autospec"
msgstr "例 4:为 autospec 提供控制文件"
#: ../../guides/clear/autospec.rst:201
msgid ""
"This example shows how to modify control files to correct build failures "
"that autospec is unable to resolve. In this example, you will add a "
"missing license and dependencies so autospec can complete a successful "
"build."
msgstr "本例介绍如何修改控制文件,纠正 autospec 无法进行解析的构建问题。在本例中,您会添加缺少的许可证和依存关系,以便 autospec 成功完成构建。"
#: ../../guides/clear/autospec.rst:205
msgid "Navigate to the autospec workspace:"
msgstr "导航到 autospec 工作区:"
#: ../../guides/clear/autospec.rst:211
msgid "If you have not already, clone all upstream package repos:"
msgstr "如果尚未克隆所有上游数据包存储库,则进行克隆:"
#: ../../guides/clear/autospec.rst:221
msgid ""
"In a later step of this example, we will search the cloned package repos "
"for a missing dependency."
msgstr "在本例的后续步骤中,我们搜索克隆的软件包存储库中是否存在缺少的依存关系。"
#: ../../guides/clear/autospec.rst:224
msgid "Build the opae-sdk RPM:"
msgstr "构建 opae-sdk RPM"
#: ../../guides/clear/autospec.rst:230
msgid "This results in an error for a missing license file:"
msgstr "此操作会因缺少许可证文件而出错:"
#: ../../guides/clear/autospec.rst:236
msgid "Navigate to the package with build failures:"
msgstr "导航到包含构建问题的软件包:"
#: ../../guides/clear/autospec.rst:242
msgid ""
"Add one or more valid license identifiers from the `SPDX License List "
"<https://spdx.org/licenses/>`_. In the example below, two different "
"licenses are appropriate based on the opae-sdk project licensing:"
msgstr "添加一个或多个来自 `SPDX License List <https://spdx.org/licenses/>`_ 的有效许可证标识符。在下例中,根据 opae-sdk 项目许可,有两个不同的许可证适用:"
#: ../../guides/clear/autospec.rst:251
msgid "Run autospec again:"
msgstr "再次运行 autospec"
#: ../../guides/clear/autospec.rst:257
msgid "This results in a generic error:"
msgstr "此操作会导致一般错误:"
#: ../../guides/clear/autospec.rst:263
msgid "Open the build log to view the error details:"
msgstr "打开构建日志,查看错误详细信息:"
#: ../../guides/clear/autospec.rst:269
msgid ""
"The build log contains details for the specific failures. In this "
"instance, there are missing dependencies:"
msgstr "构建日志包含特定故障的详细信息。在本例中,存在缺少的依存关系:"
#: ../../guides/clear/autospec.rst:282
msgid ""
"Search the spec files of upstream |CL| packages to see if the json-c "
"library is available. In this case, it does exist and we'll add the "
"json-c 'dev' package into the buildreq_add:"
msgstr "搜索上游 |CL| 软件包的规格文件,查看 json-c 库是否可用。在本例中,此库不存在,我们需要将 json-c 'dev 软件包添加到 buildreq_add"
#: ../../guides/clear/autospec.rst:293
msgid ""
"This search step works only if the user cloned all of the upstream "
"package repos. In this example, upstream package repos were cloned in a "
"previous step."
msgstr "仅当用户已克隆所有上游软件包存储库后,此搜索步骤才有效。在本例中,已在上一步骤中克隆上游软件包存储库。"
#: ../../guides/clear/autospec.rst:297
msgid ""
"Search the spec files of upstream |CL| packages to see if the libuuid "
"library is available. In this case, it exists in the util-linux package, "
"so we'll add util-linux-dev package into the buildreq_add:"
msgstr "搜索上游 |CL| 软件包的规格文件,查看 libuuid 库是否可用。在本例中,此库存在于 util-linux 软件包中,因此需要将 util-linux-dev 软件包添加到 buildreq_add"
#: ../../guides/clear/autospec.rst:306
msgid ""
"Run autospec again and find the successfully-generated RPMs in the "
":file:`rpms` directory:"
msgstr "再次运行 autospec 并在 :file:`rpms` 目录中查找成功生成的 RPM"
#: ../../guides/clear/autospec.rst:315
msgid ""
"If you need a dependency that does not exist in the |CL| repo, you must "
"first build it manually (see `Example 2: Build a new RPM`_), then add the"
" repo so that autospec knows the package exists. For example:"
msgstr "如需 |CL| 存储库中不存在的某一依存关系,则须首先对其进行手动构建(请参阅 `Example 2: Build a new RPM`_),然后添加此存储库,以便 autospec 了解存在此软件包。例如:"
#: ../../guides/clear/autospec.rst:325
msgid ""
"You only need to add the dependency to the :file:`buildreq_add` control "
"file if autospec is not able to automatically find the correct dependency"
" on its own."
msgstr "如果 autospec 无法单独自动查找正确的依存关系,则需将此依存关系添加到 :file:`buildreq_add` 控制文件。"
#: ../../guides/clear/autospec.rst:330
msgid "Test packaged software"
msgstr "测试封装后的软件"
#: ../../guides/clear/autospec.rst:332
msgid ""
"After software has been packaged with autospec, the resulting RPMs can be"
" tested for functionality before being integrated and deployed into a "
"|CL| image with the :ref:`Mixer tool <mixer>`."
msgstr "使用 autospec 封装软件后,可对生成的 RPM 进行功能测试,然后再用 :ref:`Mixer tool <mixer>` 将其集成和部署到 |CL| 映像。"
#: ../../guides/clear/autospec.rst:336
msgid ""
"The |CL| development tooling offers two ways to quickly test autospec "
"generated RPMs."
msgstr "|CL| 开发工具提供两种快速测试 autospec 所生成 RPM 的方法。"
#: ../../guides/clear/autospec.rst:340
msgid ""
"The methods outlined below should only be used for temporary testing on "
"development systems."
msgstr "下列方法只应用于开发系统的临时测试。"
#: ../../guides/clear/autospec.rst:345
msgid "Test in a |CL| virtual machine"
msgstr "在 |CL| 虚拟机上测试"
#: ../../guides/clear/autospec.rst:347
msgid ""
"The |CL| development tooling includes a method to install RPMs into a "
"|CL| virtual machine running on the KVM hypervisor. Using a :abbr:`VM "
"(Virtual Machine)` allows testing in a completely isolated environment."
msgstr "|CL| 开发工具包括将 RPM 安装到 |CL| 虚拟机(在 KVM 管理程序上运行)的方法。使用 :abbr:`虚拟机`,可在完全隔离的环境下进行测试。"
#: ../../guides/clear/autospec.rst:351
msgid "To test an autospec-created package inside a VM:"
msgstr "要测试在虚拟机内 autospec 创建的软件包:"
#: ../../guides/clear/autospec.rst:353
msgid ""
"Download the |CL| KVM image into the :file:`~/clearlinux` directory as "
":file:`clear.img`. The location and name :file:`clear.img.xz` is "
"important for the tooling to work:"
msgstr "将 |CL| KVM 映像下载到 :file:`~/clearlinux` 目录,即 :file:`clear.img`。其位置和名称 :file:`clear.img.xz` 对于工具运行都十分重要:"
#: ../../guides/clear/autospec.rst:362
msgid "Extract the downloaded |CL| KVM image:"
msgstr "解压缩已下载的 |CL| KVM 映像:"
#: ../../guides/clear/autospec.rst:368
msgid ""
"Copy the QEMU start script and virtual firmware needed for KVM into the "
":file:`~/clearlinux` directory:"
msgstr "将 KVM 所需的 QEMU 启动脚本和虚拟固件复制到 :file:`~/clearlinux` 目录:"
#: ../../guides/clear/autospec.rst:376
msgid ""
"Run :command:`make install` from the package's autospec directory. The "
":command:`make install` command mounts the downloaded |CL| KVM image and "
"installs the autospec-created RPM into it:"
msgstr "在此软件包的 autospec 目录中运行 :command:`make install`。:command:`make install` 命令可挂载已下载的 |CL| KVM 映像并将 autospec 创建的 RPM 安装到其中:"
#: ../../guides/clear/autospec.rst:385
msgid ""
"The code that makes this possible can be viewed by searching for the "
"*install:* target in the `Makefile.common`_ file on GitHub."
msgstr "在 GitHub 上的 `Makefile.common`_ 文件中搜索 *install:* 目标,可以查看实现此操作的代码。"
#: ../../guides/clear/autospec.rst:388
msgid "Return to the :file:`~/clearlinux` directory and start the |CL| VM:"
msgstr "返回到 :file:`~/clearlinux` 目录并启动 |CL| 虚拟机:"
#: ../../guides/clear/autospec.rst:395
msgid ""
"A new |CL| VM will launch in the console. Log into the VM as *root* and "
"set a new password for the VM."
msgstr "新的 |CL| 虚拟机随即在控制台上启动。以 *root* 用户身份登录到虚拟机,为此虚拟机设置新密码。"
#: ../../guides/clear/autospec.rst:398
msgid ""
"Check that the software is installed in the |CL| VM as expected and "
"perform any relevant tests."
msgstr "确保该软件已正常安装到 |CL| 虚拟机上,然后完成所有相关测试。"
#: ../../guides/clear/autospec.rst:401
msgid ""
"After testing has been completed, the |CL| VM can be powered off and "
"deleted:"
msgstr "测试完成后,可关闭并删除 |CL| 虚拟机:"
#: ../../guides/clear/autospec.rst:411
msgid "Test directly on a development machine"
msgstr "直接在开发计算机上进行测试"
#: ../../guides/clear/autospec.rst:413
msgid ""
"The |CL| development tooling also includes a method to extract autospec-"
"created RPMs locally onto a |CL| development system for testing. "
"Extracting an RPM directly onto a system offers quicker testing; however"
" conflicts may occur and responsibility to remove the software after "
"testing is up to the developer."
msgstr "|CL| 开发工具还包括将 autospec 创建的 RPM 从本地解压缩到 |CL| 开发系统进行测试的方法。将 RPM 直接解压缩到系统中,可以加速测试过程,但可能发生冲突。同时,测试后删除软件的责任也取决于开发人员。"
#: ../../guides/clear/autospec.rst:419
msgid ""
"To test an autospec created package directly on the |CL| development "
"system:"
msgstr "要直接在 |CL| 开发系统上测试 autospec 创建的软件包,必须执行以下步骤:"
#: ../../guides/clear/autospec.rst:421
msgid ""
"Run :command:`make install-local` from the package's autospec directory. "
"The :command:`make install-local` command extracts the RPM directly onto "
"the filesystem of the running |CL| system:"
msgstr "在此软件包的 autospec 目录中运行 :command:`make install-local`。:command:`make install-local` 命令会将 RPM 直接解压缩到正在运行的 |CL| 系统的文件系统中:"
#: ../../guides/clear/autospec.rst:430
msgid ""
"The code that makes this possible can be viewed by searching for the "
"*install-local:* target in the `Makefile.common`_ file on GitHub."
msgstr "在 GitHub 上的 `Makefile.common`_ 文件中搜索 *install-local:* 目标,可以查看实现此操作的代码。"
#: ../../guides/clear/autospec.rst:433
msgid ""
"Check that the software is installed as expected and perform any relevant"
" tests."
msgstr "确保该软件已正常安装,然后完成所有相关测试。"
#: ../../guides/clear/autospec.rst:436
msgid ""
"After testing has been completed, the software and any related files must"
" be identified and deleted. The :command:`swupd repair --picky` command "
"can help restore the state of the :file:`/usr` directory (see :ref:`swupd"
" <swupd-guide>`) however any other files must be cleaned up manually."
msgstr "测试完成后,必须发现并删除该软件和所有相关文件。:command:`swupd repair --picky` 命令有助于还原 :file:`/usr` 目录的状态(请参阅 :ref:`swupd <swupd-guide>`),但所有其他文件均须手动清理。"
#: ../../guides/clear/autospec.rst:444
msgid "References"
msgstr "参考"
#: ../../guides/clear/autospec.rst:446
msgid ""
"Reference the `autospec README`_ for details regarding `autospec` "
"commands and options."
msgstr "请参阅 `autospec README`_,了解有关 `autospec` 命令和选项的详细信息。"
#: ../../guides/clear/autospec.rst:449
msgid "Setup environment to build source"
msgstr "设置环境以构建源代码"
#: ../../guides/clear/autospec.rst:453
msgid ""
"Setup of the workspace and tooling used for building source in |CL| is "
"mostly automated for you with a setup script. It uses tools from the "
":command:`os-clr-on-clr` bundle."
msgstr "在 |CL| 中构建源代码所需的工作空间和工具设置操作大多数可通过设置脚本自动执行。该设置脚本使用来自 :command:`os-clr-on-clr` 捆绑包的工具。"
#: ../../guides/clear/autospec.rst:457
msgid ""
"The setup script creates a workspace in the :file:`clearlinux` folder, "
"with the subfolders :file:`Makefile`, :file:`packages`, and "
":file:`projects`. The :file:`projects` folder contains the main tools "
"used for making packages in |CL| :file:`autospec` and :file:`common`."
msgstr "该设置脚本会在 :file:`clearlinux` 文件夹(其中包含 :file:`Makefile`、:file:`packages` 和 :file:`projects` 子文件夹)中创建一个工作空间。:file:`projects` 文件夹包含在 |CL| 中制作软件包的主要工具,即 :file:`autospec` 和 :file:`common`。"
#: ../../guides/clear/autospec.rst:462
msgid "Follow these steps to setup the workspace and tooling for building source:"
msgstr "按照以下步骤设置构建代码所需的工作空间和工具:"
#: ../../guides/clear/autospec.rst:464
msgid "Install the :command:`os-clr-on-clr` bundle:"
msgstr "安装 :command:`os-clr-on-clr` 捆绑包:"
#: ../../guides/clear/autospec.rst:470
msgid "Download the :file:`user-setup.sh` script:"
msgstr "下载 :file:`user-setup.sh` 脚本:"
#: ../../guides/clear/autospec.rst:476
msgid "Make :file:`user-setup.sh` executable:"
msgstr "制作 :file:`user-setup.sh` 可执行文件:"
#: ../../guides/clear/autospec.rst:482
msgid "Run the script as an unprivileged user:"
msgstr "以非特权用户的身份运行脚本:"
#: ../../guides/clear/autospec.rst:488
msgid ""
"After the script completes, log out and log in again to complete the "
"setup process."
msgstr "脚本完成后,注销并再次登录以完成设置过程。"
#: ../../guides/clear/autospec.rst:491
msgid "Set your Git user email and username for the repos on your system:"
msgstr "在系统上设置存储库的 Git 用户电子邮件和用户名:"
#: ../../guides/clear/autospec.rst:498
msgid "This global setting is used by |CL| tools that make use of Git."
msgstr "此全局设置由使用 Git 的 |CL| 工具使用。"
#: ../../guides/clear/autospec.rst:503
msgid "Related topics"
msgstr "相关主题"
#: ../../guides/clear/autospec.rst:505
msgid ":ref:`Mixer tool <mixer>`"
msgstr ":ref:`Mixer tool <mixer>`"
#~ msgid ""
#~ "The code that makes this possible "
#~ "can be viewed by searching for the"
#~ " *install:* target in the `Makefile.common"
#~ " file on GitHub`_."
#~ msgstr ""
#~ msgid ""
#~ "The code that makes this possible "
#~ "can be viewed by searching for the"
#~ " *install-local:* target in the "
#~ "`Makefile.common file on GitHub`_."
#~ msgstr ""
@@ -0,0 +1,89 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/clear/bundles.rst:4
msgid "Bundles"
msgstr "bundle 文件"
#: ../../guides/clear/bundles.rst:6
msgid ""
"Linux-based operating systems contain the code of several hundred, if not"
" thousands, of open source projects. To make this manageable, "
"distributions use a concept called \"packages\" to configure and compile "
"the source code of these projects into binaries."
msgstr "基于 Linux 的操作系统包含数百甚至数千个开源项目的代码。为了便于管理,发行版使用了一个名为 \"packages\" 的概念来配置这些项目的源代码并将其编译成二进制代码。"
#: ../../guides/clear/bundles.rst:11
msgid ""
"Many distributions then split the content of these compiled packages into"
" so-called sub-packages, which are the granularity at which these "
"distributions deploy their software. With those kinds of distributions, "
"system administrators can then install and update sub-packages "
"individually or as a set, using tools such as \"yum\" and \"apt-get.\""
msgstr "许多发行版随后将这些编译包的内容分成所谓的子包,这些子包是这些发行版部署其软件的粒度。借助这些类型的发行版,系统管理员就可以使用 \"yum\" 和 \"apt-get.\" 等工具单独或按组安装和更新子包。"
#: ../../guides/clear/bundles.rst:17
msgid ""
"The |CL-ATTR| takes a slightly different approach. While we also use the "
"concept of packages to manage compiling source code into binaries, we do "
"not use the package concept to deploy software. Instead, we provide "
"software \"bundles\" that are installed and managed using :ref:`swupd"
"<swupd-guide>`. Each bundle contains as many or as few open source "
"projects needed to provide a complete functionality."
msgstr "|CL-ATTR| 采用的方法稍有不同。虽然我们也使用包的概念来管理将源代码编译成二进制代码的事宜,但是我们不使用包的概念来部署软件。相反,我们提供软件 \"bundles\",它是使用 :ref:`swupd<swupd-guide>` 进行安装和管理的。每个捆绑包都包含或多或少的开源项目以提供完整功能。"
#: ../../guides/clear/bundles.rst:25
msgid "Related topics"
msgstr "相关主题"
#: ../../guides/clear/bundles.rst:27
msgid ":ref:`swupd-guide`"
msgstr ":ref:`swupd-guide`"
#~ msgid ""
#~ "The |CL-ATTR| takes a slightly "
#~ "different approach. While we also use"
#~ " the concept of packages to manage"
#~ " compiling source code into binaries, "
#~ "we do not use the package concept"
#~ " to deploy software. Instead, we "
#~ "provide software \"bundles\" that are "
#~ "installed and managed using :ref:`swupd"
#~ "<swupd-about>`. Each bundle contains as "
#~ "many or as few open source "
#~ "projects needed to provide a complete"
#~ " functionality."
#~ msgstr ""
#~ msgid "Next steps"
#~ msgstr ""
#~ msgid "To put this concept into practice, see the following resources:"
#~ msgstr ""
#~ msgid ":ref:`bundles`"
#~ msgstr ""
#~ msgid ":ref:`bundle-commands`"
#~ msgstr ""
#~ msgid ":ref:`compatible-kernels`"
#~ msgstr ""
@@ -0,0 +1,139 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../tooling/compatible-kernels.rst:4
msgid "Kernels"
msgstr "内核"
#: ../../tooling/compatible-kernels.rst:6
msgid ""
"The |CL-ATTR| provides the following Linux kernels with a respective "
"bundle. This document describes the specific use cases these `bundles`_ "
"serve and provides links to their source code."
msgstr "|CL-ATTR| 为下列 Linux 内核提供了各自的捆绑包。本文介绍这些 `bundles`_ 的特定用例,并提供了源代码链接。"
#: ../../tooling/compatible-kernels.rst:11
msgid "Bare metal only"
msgstr "仅限裸机"
#: ../../tooling/compatible-kernels.rst:17
msgid "Kernel native"
msgstr "原生内核"
#: ../../tooling/compatible-kernels.rst:14
msgid ""
"The *kernel-native* bundle focuses on the bare metal platforms. It is "
"optimized for fast booting and performs best on the Intel® architectures "
"described on the :ref:`supported hardware list<system-requirements>`. The"
" optimization patches are found in our `Linux`_ GitHub\\* repo."
msgstr "*kernel-native* 捆绑包侧重于裸机平台。它针对快速引导进行了优化,并在 :ref:`supported hardware list<system-requirements>` 所述的英特尔®架构上表现最佳。优化补丁可以在我们的 `Linux`_ GitHub\\* 存储库中找到。"
#: ../../tooling/compatible-kernels.rst:22
msgid "Also compatible with VMs"
msgstr "也与虚拟机兼容"
#: ../../tooling/compatible-kernels.rst:32
msgid "Kernel LTS"
msgstr "LTS 内核"
#: ../../tooling/compatible-kernels.rst:25
msgid ""
"The *kernel-lts* bundle focuses on the bare metal platforms but uses the "
"latest :abbr:`LTS (Long Term Support)` Linux kernel. It is optimized for "
"fast booting and performs best on the Intel® architectures described on "
"the :ref:`supported hardware list<system-requirements>`. Additionally, "
"this kernel includes the VirtualBox\\* kernel modules, see our "
":ref:`instructions on using Virtualbox<virtualbox-cl-installer>` for more"
" information. The optimization patches are found in our `Linux-LTS`_ "
"GitHub repo."
msgstr "*kernel-lts* 捆绑包侧重于裸机平台,但使用最新的 :abbr:`LTS (Long Term Support)` Linux 内核。它针对快速引导进行了优化,并在 :ref:`supported hardware list<system-requirements>` 所述的英特尔®架构上表现最佳。此外,该内核包括 VirtualBox\\* 内核模块,请参阅我们的 :ref:`instructions on using Virtualbox<virtualbox-cl-installer>` 了解更多信息。优化补丁可以在我们的 `Linux-LTS`_ GitHub 存储库中找到。"
#: ../../tooling/compatible-kernels.rst:35
msgid "VM only"
msgstr "仅限虚拟机"
#: ../../tooling/compatible-kernels.rst:47
msgid "Kernel KVM"
msgstr "KVM 内核"
#: ../../tooling/compatible-kernels.rst:38
msgid ""
"The *kernel-kvm* bundle focuses on the Linux :abbr:`KVM (Kernel-based "
"Virtual Machine)`. It is optimized for fast booting and performs best on "
"Virtual Machines running on the Intel® architectures described on the "
":ref:`supported hardware list<system-requirements>`. Use this kernel when"
" running |CL| as the guest OS on top of *qemu/kvm*. Use this kernel with "
"**cloud orchestrators** using *qemu/kvm* internally as their "
"**hypervisor** . This kernel can be used as a standalone |CL| VM, see our"
" :ref:`instructions on using KVM<kvm>` for more information. The "
"optimization patches are found in our `Linux-KVM`_ GitHub repo."
msgstr "*kernel-kvm* 捆绑包侧重于 Linux :abbr:`KVM (Kernel-based Virtual Machine)`。它针对快速引导进行了优化,并在运行于 :ref:`supported hardware list<system-requirements>` 所述的英特尔®架构的虚拟机上表现最佳。在 *qemu/kvm* 之上将 |CL| 作为来宾操作系统运行时,请使用此内核。在内部将 *qemu/kvm* 用作**虚拟机管理程序**时,可将此内核与云编排程序一起使用。该内核可用作独立的 |CL| 虚拟机,详情请参阅我们的 :ref:`instructions on using KVM<kvm>`。优化补丁可以在我们的 `Linux-KVM`_ GitHub 存储库中找到。"
#: ../../tooling/compatible-kernels.rst:58
msgid "Kernel Hyper-V\\*"
msgstr "Hyper-V\\* Kernel"
#: ../../tooling/compatible-kernels.rst:50
msgid ""
"The *kernel-hyperv* bundle focuses on running Linux on Microsoft\\* "
"Hyper-V. It is optimized for fast booting and performs best on Virtual "
"Machines running on the Intel® architectures described on the "
":ref:`supported hardware list<system-requirements>`. Use this kernel when"
" running |CL| as the guest OS of **Cloud Instances** in projects such as "
"Microsoft `Azure`_\\*. This kernel can be used in a standalone |CL| VM, "
"see our :ref:`instructions on using Hyper-V<hyper-v>` for more "
"information. The optimization patches are found in our `Linux-HyperV`_ "
"GitHub repo."
msgstr "*kernel-hyperv* 捆绑包侧重于在 Microsoft\\* Hyper-V 上运行 Linux。它针对快速引导进行了优化,并在运行于 :ref:`supported hardware list<system-requirements>` 所述的英特尔®架构的虚拟机上表现最佳。在 Microsoft `Azure`_\\* 等项目中将 |CL| 运行为云实例的来宾操作系统时,请使用此内核。该内核可以在独立的 |CL| 虚拟机中使用。详情请参阅我们的 :ref:`instructions on using Hyper-V<hyper-v>`。优化补丁可以在我们的 `Linux-HyperV`_ GitHub 存储库中找到。"
#: ../../tooling/compatible-kernels.rst:71
msgid "Kernel Hyper-V LTS"
msgstr "Hyper-V LTS 内核"
#: ../../tooling/compatible-kernels.rst:61
msgid ""
"The *kernel-hyperv-lts* bundle focuses on running Linux on Microsoft "
"Hyper-V but uses the latest :abbr:`LTS (Long Term Support)` Linux kernel."
" It is optimized for fast booting and performs best on Virtual Machines "
"running on the Intel® architectures described on the :ref:`supported "
"hardware list<system-requirements>`. Use this kernel when running |CL| as"
" the guest OS of **Cloud Instances** in projects such as Microsoft "
"`Azure`_. This kernel can be used in a standalone |CL| VM, see our "
":ref:`instructions on using Hyper-V<hyper-v>` for more information. The "
"optimization patches are found in our `Linux-HyperV-LTS`_ GitHub repo."
msgstr "*kernel-hyperv-lts* 捆绑包侧重于在 Microsoft Hyper-V 上运行 Linux,但使用最新的 :abbr:`LTS (Long Term Support)` Linux 内核。它针对快速引导进行了优化,并在运行于 :ref:`supported hardware list<system-requirements>` 所述的英特尔®架构的虚拟机上表现最佳。在 Microsoft `Azure`_ 等项目中将 |CL| 运行为云实例的来宾操作系统时,请使用此内核。该内核可以在独立的 |CL| 虚拟机中使用。详情请参阅我们的 :ref:`instructions on using Hyper-V<hyper-v>`。优化补丁可以在我们的 `Linux-HyperV-LTS`_ GitHub 存储库中找到。"
#~ msgid "Kernel Container"
#~ msgstr ""
#~ msgid ""
#~ "The *kernel-container* bundle contains "
#~ "the kernel used by the Intel® "
#~ "Clear Containers project. This kernel is"
#~ " optimized for fast booting and "
#~ "performs best on |CC| running on "
#~ "the Intel® architectures described on "
#~ "the :ref:`supported hardware list<system-"
#~ "requirements>`. The optimization patches are"
#~ " found in our `Linux-Container`_ "
#~ "GitHub repo."
#~ msgstr ""
@@ -0,0 +1,135 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../tooling/debug.rst:4
msgid "Debug system"
msgstr "调试系统"
#: ../../tooling/debug.rst:6
msgid ""
"|CL-ATTR| introduces a novel approach to system software debugging using "
"*clr-debug-info*. On the client side, the |CL| debug system obtains any "
"necessary debug information on-the-fly over a network during a debugging "
"session. On the server side, the system curates and compresses debug "
"information into small pieces for efficient downloading."
msgstr "|CL-ATTR| 引入了一种使用 *clr-debug-info* 进行系统软件调试的新方法。在客户端,|CL| 调试系统会在调试会话期间通过网络即时获取所有必要的调试信息。在服务器端,系统将调试信息整理并压缩为较小的数据块,方便高效下载。"
#: ../../tooling/debug.rst:12
msgid ""
"For developers, this avoids the interruption during debugging that "
"usually happens when debug information is missing. This can be especially"
" useful on systems where storage is limited."
msgstr "对于开发人员,此举可避免调试期间通常在缺少调试信息的情况下所出现的中断问题。对于存储空间有限的系统,此功能尤其实用。"
#: ../../tooling/debug.rst:22
msgid "Background"
msgstr "后台"
#: ../../tooling/debug.rst:24
msgid ""
"Software that is compiled and packaged for general usage in an operating "
"system typically only contains components that are used to execute the "
"program, such as binaries and libraries. Extra developer data, such as "
"the actual source code and symbol information, are separated and excluded"
" for efficiency."
msgstr "为在操作系统中进行一般使用而编译和封装的软件通常仅包含用于执行程序的组件,例如二进制文件和库。为提高效率,其他开发数据则会被分置并排除,例如实际的源代码和符号信息。"
#: ../../tooling/debug.rst:30
msgid ""
"The debug information helps relate binary code to human readable source "
"code lines and variables. Most of the time, this auxiliary information is"
" not needed; however without it, debugging a program results in limited "
"visibility."
msgstr "调试信息有助于将二进制代码与人类可读的源代码行和变量进行关联。多数情况下并不需要这些辅助信息;但如果缺少此类信息,调试程序便无法提供足够的可见性。"
#: ../../tooling/debug.rst:37
msgid "Usage"
msgstr "用途"
#: ../../tooling/debug.rst:39
msgid ""
"The clr-debug-info system is integrated into |CL| and seamlessly engages "
"once installed."
msgstr "clr-debug-info 系统已集成到 |CL| 并在安装后立即无缝结合。"
#: ../../tooling/debug.rst:42
msgid "Install the *dev-utils* bundle."
msgstr "安装 *dev-utils* bundle 文件。"
#: ../../tooling/debug.rst:50
msgid ""
"The *telemetrics* and *performance-tools* bundles also include clr-debug-"
"info."
msgstr "*telemetrics* 和 *performance-tools* bundle 文件也包含 clr-debug-info。"
#: ../../tooling/debug.rst:54
msgid ""
"Start a debugging session against a program using a debugger, such as "
"GDB. For example, to debug *gnome-control-center* execute the following "
"command:"
msgstr "使用调试程序(如 GDB)针对程序启动调试会话。例如,要调试 *gnome-control-center*,请执行以下命令:"
#: ../../tooling/debug.rst:62
msgid ""
"As you step through the program and debug information is needed, the "
"clr_debug_daemon obtains it in the background."
msgstr "单步执行程序且需调试信息时,clr_debug_daemon 便会在后台获取所需信息。"
#: ../../tooling/debug.rst:67
msgid "Implementation"
msgstr "实施"
#: ../../tooling/debug.rst:69
msgid ""
"The implementation of the |CL| debug system is open source and available "
"on GitHub at: https://github.com/clearlinux/clr-debug-info/"
msgstr "|CL| 调试系统的实现为开源程序且可在 GitHub 上的以下位置找到:https://github.com/clearlinux/clr-debug-info/"
#: ../../tooling/debug.rst:76
msgid "Figure 1: The communication flow of the |CL| debug system"
msgstr "图 1|CL| 调试系统的通信流程"
#: ../../tooling/debug.rst:78
msgid ""
"The |CL| debug system implements a :abbr:`FUSE (filesystem in userspace)`"
" filesystem mounted at :file:`/usr/lib/debug` and :file:`/usr/src/debug`."
" The FUSE filesystem starts automatically. You can verify its status by "
"executing :command:`systemctl status clr_debug_fuse.service`."
msgstr "|CL| 调试系统可实现在 :file:`/usr/lib/debug` 和 :file:`/usr/src/debug` 挂载的 :abbr:`FUSE (filesystem in userspace)` 文件系统。FUSE 文件系统会自动启动。可以执行 :command:`systemctl status clr_debug_fuse.service` 来验证状态。"
#: ../../tooling/debug.rst:83
msgid ""
"The *clr_debug_daemon* is responsible for fetching the appropriate "
"package debug content from the server and making it available for any "
"debugging programs that need it. It is socket activated whenever a "
"request to the local FUSE filesystem occurs. You can verify its status "
"with :command:`systemctl status clr_debug_daemon.service`."
msgstr "*clr_debug_daemon* 负责从服务器获取相应的软件包调试内容,并提供给需要它的所有调试程序。只要对本地 FUSE 文件系统发出请求,便会通过套接字将其激活。可以使用 :command:`systemctl status clr_debug_daemon.service` 来验证状态。"
#: ../../tooling/debug.rst:90
msgid ""
"|CL| hosts debuginfo content packaged for consumption by |CL| debug "
"clients at https://download.clearlinux.org/debuginfo/"
msgstr "|CL| 存储有专供 |CL| 调试客户端(位于 https://download.clearlinux.org/debuginfo/)使用而封装的调试信息内容"
#~ msgid "Debug System"
#~ msgstr ""
@@ -0,0 +1,193 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-17 11:17-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../tooling/ister.rst:4
msgid "ister.py image builder"
msgstr "ister.py image builder"
#: ../../tooling/ister.rst:6
msgid ""
"The `ister.py`_ tool is a template-based installer used by |CL-ATTR| to "
"produce images for each release. The same ister tool is available for use"
" in |CL| to create custom images based on an upstream image."
msgstr "`ister.py`_ 工具是 |CL-ATTR| 使用的一款基于模板的安装程序,可以生成每个版本的映像。|CL| 中也可以使用该款 ister 工具,可以根据上游映像定制创建映像。"
#: ../../tooling/ister.rst:15
msgid "Description"
msgstr "描述"
#: ../../tooling/ister.rst:17
msgid ""
"|CL| is a rolling release and produces an average of 10 releases per week"
" using the ister tool. With each release, we produce multiple :ref:`image "
"types for different environments <image-types>` and use cases such as "
"installers, Hyper-V, KVM, or VMWare."
msgstr "|CL| 是一个滚动发行版本,使用该款 ister 工具每周平均生成 10 个版本。针对每个版本,我们均会生成多个 :ref:`image types for different environments <image-types>` 和用例,如安装程序、Hyper-V、KVM 或 VMWare。"
#: ../../tooling/ister.rst:22
msgid ""
"Each image has a JSON configuration file that is used by ister to "
"generate the image. These JSON configuration files describe the image "
"type, partitions, version, and bundles that will be preinstalled by "
"default with the image. For each image type we produce, the corresponding"
" JSON configuration file for the image also is published."
msgstr "每个映像均有一个 JSON 配置文件。ister 使用配置文件生成映像。这些 JSON 配置文件描述了默认情况下预安装映像的映像类型、分区、版本和 bundle 文件。针对所生成的每种映像类型,同时还会发布映像的相应 JSON 配置文件。"
#: ../../tooling/ister.rst:28
msgid ""
"The :ref:`mixer<mixer>` tool also uses ister to build images for your "
"custom mix. Like upstream images, a JSON configuration file is defined "
"for the image, which ister uses to generate the image. Refer to the "
":ref:`mixer<mixer>` guide for instructions on using ister to build an "
"image for a custom mix."
msgstr ":ref:`mixer<mixer>` 工具也用 ister 为定制组合构建映像。与上游映像一样,系统会为该映像定义 ister 用于生成映像的 JSON 配置文件。请参阅 :ref:`mixer<mixer>` 指南,查看使用 ister 为定制组合构建映像的说明。"
#: ../../tooling/ister.rst:34
msgid "Examples"
msgstr "示例"
#: ../../tooling/ister.rst:37
msgid "Recreate an upstream image"
msgstr "重新创建上游映像"
#: ../../tooling/ister.rst:39
msgid ""
"The published configuration files for upstream images may be used to "
"recreate an image. Here are some examples:"
msgstr "上游映像的已发布配置文件可用于重新创建映像。部分示例如下:"
#: ../../tooling/ister.rst:42
msgid ""
"Use an older version of |CL| and the image is no longer available (only "
"after March 2017)."
msgstr "不再提供旧版 |CL| 和映像(仅 2017 年 3 月后)。"
#: ../../tooling/ister.rst:44
msgid "Customize the partitions of an image."
msgstr "定制映像的分区。"
#: ../../tooling/ister.rst:45
msgid "Customize the bundles preinstalled in an image."
msgstr "定制映像中预安装的 bundle 文件。"
#: ../../tooling/ister.rst:46
msgid "Run your own post installation script."
msgstr "运行自己的安装后脚本。"
#: ../../tooling/ister.rst:49
msgid ""
"Follow these steps to recreate an upstream image based on the image's "
"JSON configuration file:"
msgstr "按照以下步骤,根据映像的 JSON 配置文件重新创建上游映像:"
#: ../../tooling/ister.rst:52
msgid ""
"Install the :command:`os-installer` bundle. Refer to :ref:`swupd-guide` "
"for more information on installing bundles."
msgstr "安装 :command:`os-installer` bundle 文件。请参阅 :ref:`swupd-guide`,了解有关安装 bundle 文件的更多信息。"
#: ../../tooling/ister.rst:55
msgid "Download the `ister.py`_ tool and grant it sudo privileges."
msgstr "下载 `ister.py`_ 工具并为其授予 sudo 权限。"
#: ../../tooling/ister.rst:57
msgid ""
"Download the JSON configuration file for the desired image (located in "
":file:`config/image/`):"
msgstr "下载所需映像的 JSON 配置文件(位于 :file:`config/image/`):"
#: ../../tooling/ister.rst:60
msgid "`Current release`_"
msgstr "`Current release`_"
#: ../../tooling/ister.rst:61
msgid "`Previous releases`_ (only after March 2017)"
msgstr "`Previous releases`_ (仅 2017 年 3 月后)"
#: ../../tooling/ister.rst:63
msgid ""
"For a previous release, navigate to `Previous releases`_, select the "
"version you want, and find the JSON configuration file under "
":file:`/clear/config/image`. For example: "
"``https://cdn.download.clearlinux.org/releases/15700/clear/config/image/``"
msgstr "针对先前版本,请导航到 `Previous releases`_,选择所需版本,然后在 :file:`/clear/config/image` 下找到 JSON 配置文件。例如:``https://cdn.download.clearlinux.org/releases/15700/clear/config/image/``"
#: ../../tooling/ister.rst:68
msgid "Download the “PostNonChroot” script (if applicable)."
msgstr "下载“PostNonChroot”脚本(如果适用)。"
#: ../../tooling/ister.rst:70
msgid ""
"The JSON configuration file for the image may have an accompanying "
"“PostNonChroot” script that is executed at the end of the image creation "
"process. If it does, download the script and make it executable."
msgstr "此映像的 JSON 配置文件可能附带“PostNonChroot”脚本,在映像创建过程结束时执行。如果是,则下载此脚本,将其转换为可执行文件。"
#: ../../tooling/ister.rst:74
msgid "Edit the JSON configuration file as needed."
msgstr "按需编辑 JSON 配置文件。"
#: ../../tooling/ister.rst:76
msgid ""
"If your configuration file has an accompanying \"PostNonChroot\" script, "
"change the default path of the script to match your path."
msgstr "如果此配置文件附带 \"PostNonChroot\" 脚本,则将此脚本的默认路径更改为您的路径。"
#: ../../tooling/ister.rst:79
msgid "Generate the new image with the following command:"
msgstr "用以下命令生成新映像:"
#: ../../tooling/ister.rst:86
msgid "Related topics"
msgstr "相关主题"
#: ../../tooling/ister.rst:88
msgid ":ref:`mixer`"
msgstr ":ref:`mixer`"
#: ../../tooling/ister.rst:89
msgid ":ref:`bulk-provision`"
msgstr ":ref:`bulk-provision`"
#~ msgid ""
#~ "The `ister.py tool`_ is a template-"
#~ "based installer used by |CL-ATTR| "
#~ "to produce images for each release. "
#~ "The same ister tool is available "
#~ "for use in |CL| to create custom"
#~ " images based on an upstream image."
#~ msgstr ""
#~ msgid ""
#~ "Install the :command:`os-installer` bundle."
#~ " Refer to `Install a bundle`_ for "
#~ "more details."
#~ msgstr ""
#~ msgid "Download the `ister.py tool`_ and grant it sudo privileges."
#~ msgstr ""
#~ msgid "Download the JSON configuration file for the desired image:"
#~ msgstr ""
#~ msgid "`Configuration files for the current release`_"
#~ msgstr ""
File diff suppressed because it is too large Load Diff
@@ -0,0 +1,247 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../tooling/security.rst:4
msgid "OS Security"
msgstr "操作系统安全性"
#: ../../tooling/security.rst:6
msgid ""
"|CL-ATTR| aims to make systemic and layered security-conscious decisions "
"that are both performant and practical. This security philosophy is "
"rooted within the project's codebase and operating culture."
msgstr "|CL-ATTR| 旨在做出既高效又实用的系统性、分层安全决策。此安全理念根植于项目的代码库和运营文化中。"
#: ../../tooling/security.rst:14
msgid "Security in updates"
msgstr "更新方面的安全举措"
#: ../../tooling/security.rst:16
msgid ""
"The |CL| team believes in the benefits of software security through open "
"sourcing, incremental updates, and rapidly resolving known security "
"advisories."
msgstr "|CL| 团队致力于通过开源、增量更新以及快速解决已知的安全建议来提升软件安全。"
#: ../../tooling/security.rst:20
msgid "The latest Linux\\* codebase"
msgstr "最新的 Linux\\* 代码库"
#: ../../tooling/security.rst:22
msgid ""
"|CL| uses the newest version of the Linux kernel which allows the "
"operating system to leverage the latest features from the upstream Linux "
"kernel, including security fixes."
msgstr "|CL| 使用最新版本的 Linux 内核,允许操作系统利用上游 Linux 内核的最新功能,包括安全修复。"
#: ../../tooling/security.rst:27
msgid "Automated effective updating"
msgstr "自动有效更新"
#: ../../tooling/security.rst:29
msgid "|CL| is incrementally updated multiple times per day."
msgstr "|CL| 每天多次执行增量更新。"
#: ../../tooling/security.rst:31
msgid ""
"This `rolling release`_ model allows |CL| to consume the latest security "
"fixes of software packages as soon as they become available. There is no "
"waiting for major or minor releases on |CL|."
msgstr "这种 `rolling release`_ 模式便于 |CL| 在软件包的最新安全补丁一经推出就能获得应用。|CL| 不会等待主要或次要版本。"
#: ../../tooling/security.rst:35
msgid ""
"An update is not effective if it is just simply downloaded onto a system."
" It needs to be obtained *AND* ensured that the new patched copy is being"
" used; not an older copy loaded into memory. |CL| will let you know when "
"a service needs to be rebooted or do it for your automatically after a "
"software update, if desired."
msgstr "简单地将更新内容下载到系统上并不会带来多大的效果。重要的是在获得更新内容的同时,还要确保修补后的新副本得到使用,而不是将旧副本加载到内存中。更新软件后,|CL| 会告诉用户某个服务是否需要重新启动,或者在需要时自动重新启动服务。"
#: ../../tooling/security.rst:41
msgid ""
"In |CL| updates are delivered automatically, efficiently, and "
"effectively. For more information about software updates in |CL|, refer "
"to the :ref:`swupd-guide` guide."
msgstr "在 |CL| 中,更新会自动、高效且有效地交付。有关 |CL| 中软件更新的更多信息,请参阅 :ref:`swupd-guide` 指南。"
#: ../../tooling/security.rst:46
msgid "Automated CVE scanning and remediation"
msgstr "自动 CVE 扫描和修复"
#: ../../tooling/security.rst:48
msgid ""
"The sheer number of software packages and security vulnerabilities is "
"growing exponentially. Repositories of Common Vulnerabilities and "
"Exposures (CVEs) and their fixes, if known, are published by :abbr:`NIST`"
" in a National Vulnerability Database \\ |NVD|\\ and at \\ |MITRE|\\ ."
msgstr "软件包和安全漏洞的数量正呈指数级增长。:abbr:`NIST` 会在美国国家漏洞数据库 \\ |NVD|\\ 以及 \\ |MITRE|\\ 推送通用漏洞 (CVE) 存储库及其修复程序(如果已知)。"
#: ../../tooling/security.rst:53
msgid ""
"|CL| employs a proactive and measured approach to addressing known and "
"fixable :abbr:`CVEs (Common Vulnerabilities and Exposures)`. Packages are"
" automatically scanned against CVEs daily, and security patches are "
"deployed as soon as they are available."
msgstr "|CL| 采用一种主动且慎重的方法来解决已知且可修复的 :abbr:`CVEs (Common Vulnerabilities and Exposures)`。系统每天都会对照 CVE 扫描软件包,而且相应的安全补丁一经可用即会立即部署。"
#: ../../tooling/security.rst:58
msgid ""
"These combined practices minimize the amount of time |CL| systems are "
"exposed to unnecessary security risk."
msgstr "这些综合实践最大限度减少了 |CL| 系统暴露于不必要的安全风险下的时间。"
#: ../../tooling/security.rst:61
msgid "Security in software"
msgstr "软件方面的安全举措"
#: ../../tooling/security.rst:64
msgid "Minimized attack surface"
msgstr "最大限度减少攻击面"
#: ../../tooling/security.rst:66
msgid ""
"|CL| removes legacy, unneeded, or redundant standards and components as "
"much as possible to enable the use of best known security standards. "
"Below are some examples:"
msgstr "|CL| 会尽可能删除旧的、不需要的或冗余的标准和组件,以便能够使用最广为人知的安全标准。以下是一些例子:"
#: ../../tooling/security.rst:70
msgid ""
"`RC4`, `SSLv3`, `3DES`, and `SHA-1` ciphers which have had known "
"vulnerabilities, have been explicitly disabled within many |CL| packages "
"to avoid their accidental usage."
msgstr "`RC4`、`SSLv3`、`3DES` 和 `SHA-1` 密码存在已知的漏洞,已在许多 |CL| 软件包中明确禁用,以避免意外使用。"
#: ../../tooling/security.rst:74
msgid ""
"Services and subsystems which expose sensitive system information have "
"been removed such as the `finger` and `tcpwrappers`."
msgstr "暴露敏感系统信息的服务和子系统已被删除,如 `finger` 和 `tcpwrappers`。"
#: ../../tooling/security.rst:77
msgid "`SFTP` has been disabled by default due to security considerations."
msgstr "出于安全考虑,默认情况下已禁用 `SFTP`。"
#: ../../tooling/security.rst:80
msgid "Verified trust"
msgstr "经过验证的信任措施"
#: ../../tooling/security.rst:82
msgid ""
"|CL| encourages the use of secure practices such as encryption and "
"digital signature verification throughout the system and discourages "
"blind trust. Below are some examples:"
msgstr "|CL| 鼓励在整个系统中使用加密和数字签名验证等安全措施,并不鼓励盲目信任。以下是一些例子:"
#: ../../tooling/security.rst:86
msgid ""
"All update operations from swupd are transparently encrypted and checked "
"against the |CL| maintainers' public key for authenticity. More "
"information about swupd security can be found in the `Security for "
"software update in Clear Linux* OS`_ blog post."
msgstr "swupd 的所有更新操作都是透明加密的,并对照 |CL| 维护者的公钥进行真实性检查。有关 swupd 安全性的更多信息,请参阅 `Security for software update in Clear Linux* OS`_ 博客文章。"
#: ../../tooling/security.rst:91
msgid ""
"Before being built, packages available from |CL| verify checksums and "
"signatures provided by third party project codebases and maintainers."
msgstr "构建之前,可从 |CL| 获得的软件包会验证由第三方项目代码库和维护者提供的校验和和签名。"
#: ../../tooling/security.rst:94
msgid ""
"|CL| features a unified certificate store, `clrtrust`_ which comes ready "
"to work with well-known Certificate Authorities out of the box. clrtrust "
"also offers an easy to use command line interface for managing system-"
"wide chains of trust, instead of ignoring foreign certificates."
msgstr "|CL| 使用一个统一的证书存储库 `clrtrust`_,可以方便地与知名的证书颁发机构配合使用。clrtrust 还提供了一个易于使用的命令行界面来管理整个系统范围内的信任链,而不是忽略外部证书。"
#: ../../tooling/security.rst:100
msgid "Compiled with secure options"
msgstr "使用安全选项编译"
#: ../../tooling/security.rst:102
msgid ""
"While |CL| packages are optimized for performance on Intel® architecture,"
" security conscious kernel and compiler options are sensibly taken "
"advantage of. Below are some examples:"
msgstr "虽然 |CL| 软件包针对英特尔架构优化了性能,但也合理使用了强调安全的内核和编译器选项。以下是一些例子:"
#: ../../tooling/security.rst:106
msgid ""
"Kernels shipped with |CL| are signed and disallow the usage of custom "
"kernel modules to maintain verifiable system integrity."
msgstr "|CL| 附带的内核经过签名,不允许使用自定义内核模块来维护可验证的系统完整性。"
#: ../../tooling/security.rst:109
msgid ""
"`Address space layout randomization (ASLR)`_ and `Kernel address space "
"layout randomization (KASLR)`_ are kernel features which defend against "
"certain memory based attacks. More information about PIE executables can "
"be found in the `Recent GNU* C library improvements`_ blog post."
msgstr "`Address space layout randomization (ASLR)`_ 和 `Kernel address space layout randomization (KASLR)`_ 这两项内核功能可抵御某些基于内存的攻击。有关 PIE 可执行文件的更多信息可在 `Recent GNU* C library improvements`_ 博客文章中找到。"
#: ../../tooling/security.rst:116
msgid "Security in system design"
msgstr "系统设计方面的安全举措"
#: ../../tooling/security.rst:118
msgid ""
"Simple, yet effective, techniques are used throughout the |CL| system "
"design to defend against common attack vectors and enable good security "
"hygiene. Below are some examples:"
msgstr "整个 |CL| 系统设计都使用了简单却有效的技术来防御常见的攻击媒介,并实现良好的安全水平。以下是一些例子:"
#: ../../tooling/security.rst:122
msgid ""
"Full disk encryption using :abbr:`LUKS (Linux Unified Key Setup)` is "
"available during installation. Refer to `cryptsetup`_ for additional "
"information about LUKS."
msgstr "安装期间可使用 :abbr:`LUKS (Linux Unified Key Setup)` 实现全磁盘加密。有关 LUKS 的更多信息,请参阅 `cryptsetup`_。"
#: ../../tooling/security.rst:126
msgid ""
"|CL| uses the PAM cracklib module to harden user login and password "
"security resulting in:"
msgstr "|CL| 使用 PAM cracklib 模块强化用户登录和密码安全,从而使得:"
#: ../../tooling/security.rst:129
msgid ""
"No default username or root password set out of the box with |CL|, you "
"will be asked to set your own password immediately."
msgstr "|CL| 一开始并没有现成的默认用户名或 root 密码,系统会要求您立即设置自己的密码。"
#: ../../tooling/security.rst:132
msgid ""
"Simple password schemes, which are known to be easily compromised, cannot"
" be set in |CL|."
msgstr "在 |CL| 中无法设置很容易被猜出的简单密码。"
#: ../../tooling/security.rst:135
msgid ""
"A password blacklist, to avoid system passwords being set to passwords "
"which have been compromised in the past."
msgstr "将过去受过攻击的密码加入密码黑名单,并禁止将系统密码设置为黑名单中的密码。"
#: ../../tooling/security.rst:138
msgid ""
"`Tallow`_, a lightweight service which monitors and blocks suspicious SSH"
" login patterns, is installed with the :command:`openssh-server` bundle."
msgstr "使用 :command:`openssh-server` 捆绑包可安装轻量级服务 `Tallow`_,监视和阻止可疑的 SSH 登录模式。"
@@ -0,0 +1,201 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../guides/clear/stateless.rst:4
msgid "Stateless"
msgstr "无状态"
#: ../../guides/clear/stateless.rst:6
msgid ""
"In most operating systems, user data, system data, and configuration "
"files can become intermingled."
msgstr "在大多数操作系统中,用户数据、系统数据和配置文件可能会混杂在一起。"
#: ../../guides/clear/stateless.rst:14
msgid ""
"Figure 1: Without stateless, user and system files become mixed on the "
"filesystem over time."
msgstr "图 1:如果不使用无状态设计,用户和系统文件会随着时间的推移在文件系统中混杂在一起。"
#: ../../guides/clear/stateless.rst:16
msgid ""
"|CL-ATTR| has a stateless design philosophy with the goal to provide an "
":abbr:`OS (operating system)` that functions without excessive user "
"configuration or customization. Stateless in this context does *not* mean"
" ephemeral or non-persistent."
msgstr "|CL-ATTR| 使用无状态设计理念,目的是打造一个无需过多用户配置或自定义的 `OS (operating system)`。在这种情况下,无状态并不意味着短暂或不持久。"
#: ../../guides/clear/stateless.rst:25
msgid "File-level separation"
msgstr "文件级隔离"
#: ../../guides/clear/stateless.rst:27
msgid ""
"To accomplish a stateless design the Linux Filesystem Hierarchy is "
"separated between user-owned areas and |CL|-owned areas."
msgstr "为了实现无状态设计,Linux 文件系统层次结构在用户拥有的区域和 |CL| 拥有的区域之间是隔离的。"
#: ../../guides/clear/stateless.rst:35
msgid ""
"Figure 2: With stateless, user and system files are separated on the "
"filesystem."
msgstr "图 2:使用无状态设计时,用户和系统文件在文件系统上是隔离的。"
#: ../../guides/clear/stateless.rst:38
msgid "System areas"
msgstr "系统区域"
#: ../../guides/clear/stateless.rst:39
msgid ""
"File under the :file:`/usr` directory are managed by |CL| as system "
"files. Files written under the :file:`/usr` directory by users can get "
"removed through system updates with :ref:`swupd <swupd-guide>`. This "
"operating assumption allows |CL| to verify and maintain integrity of "
"system files."
msgstr ":file:`/usr` 目录下的文件由用户拥有和管理。用户在 :file:`/usr` 目录下编写的文件可以通过 :ref:`swupd <swupd-guide>` 系统更新删除。此操作假设允许 |CL| 用户清楚地识别其系统的独特配置。"
#: ../../guides/clear/stateless.rst:45
msgid "User areas"
msgstr "用户区域"
#: ../../guides/clear/stateless.rst:46
msgid ""
"Files under the :file:`/etc/`, :file:`/home`, and :file:`/var` "
"directories are owned and managed by the user. A freshly installed |CL| "
"system will only have a minimal set of files in the :file:`/etc/` "
"directory and software installed by |CL| does not write to :file:`/etc`. "
"This operating assumption allows |CL| users to clearly identify the "
"configuration that makes their system unique."
msgstr ":file:`/etc/`、:file:`/home` 和 :file:`/var` 目录下的文件由用户拥有和管理。新安装的 |CL| 系统在 :file:`/etc/` 目录中只有极少量的文件,并且 |CL| 安装的软件不会写入 :file:`/etc`。此操作假设允许 |CL| 用户清楚地识别其系统的独特配置。"
#: ../../guides/clear/stateless.rst:54
msgid "Software configuration"
msgstr "软件配置"
#: ../../guides/clear/stateless.rst:56
msgid ""
"With stateless separation, default software configurations are read in "
"order from predefined source code, |CL| provided defaults, and user-"
"provided configuration."
msgstr "在无状态隔离的情况下,默认软件配置从预定义的源代码、|CL| 提供的默认值和用户提供的配置中按顺序读取。"
#: ../../guides/clear/stateless.rst:61
msgid "Default configurations"
msgstr "默认配置"
#: ../../guides/clear/stateless.rst:63
msgid ""
"Software in |CL| provides default configuration values so that it is "
"immediately functional, whenever it is appropriate to do so."
msgstr "|CL| 中的软件会提供默认配置值,以便在适当的时候立即运行。"
#: ../../guides/clear/stateless.rst:66
msgid ""
"|CL| distributed software packages may be directly modified to include "
"default configuration values or default configuration files may be "
"provided by |CL| under :file:`/usr/share/defaults`. These files can be "
"referenced as templates for customization."
msgstr "|CL| 分布的软件包可以直接修改以包括默认配置值,或者默认配置文件可以由 |CL| 在 :file:`/usr/share/defaults` 中提供。这些文件可以作为自定义模板引用。"
#: ../../guides/clear/stateless.rst:71
msgid ""
"For example, the default configuration that Apache uses when installed "
"can be found at :file:`/usr/share/defaults/httpd/httpd.conf` directory."
msgstr "例如,Apache 安装后使用的默认配置可以在 :file:`/usr/share/defaults/httpd/httpd.conf` 目录中找到。"
#: ../../guides/clear/stateless.rst:76
msgid "Overriding configurations"
msgstr "覆盖配置"
#: ../../guides/clear/stateless.rst:78
msgid ""
"If a configuration needs to be changed, the appropriate file should be "
"modified by the user under :file:`/etc/`. If the configuration file does "
"not already exist, it can be created in the appropriate location."
msgstr "如果需要更改配置,用户应在 :file:`/etc/` 下修改适当的文件。如果配置文件不存在,可以在适当的位置创建。"
#: ../../guides/clear/stateless.rst:82
msgid ""
"User defined configuration files should contain the minimal set of "
"desired changes and rely on default configuration for the rest."
msgstr "用户定义的配置文件应该包含尽可能少的更改,其余则依赖默认配置。"
#: ../../guides/clear/stateless.rst:85
msgid "For example, a customized Apache configuration can be used instead by:"
msgstr "例如,可以使用自定义 Apache 配置,具体方式是:"
#: ../../guides/clear/stateless.rst:87
msgid "Create the destination directory for the configuration:"
msgstr "为配置创建目标目录:"
#: ../../guides/clear/stateless.rst:93
msgid "Copy the default configuration as a reference template:"
msgstr "复制默认配置作为参考模板:"
#: ../../guides/clear/stateless.rst:99
msgid "Make any desired modifications to the configurations:"
msgstr "对配置进行任何所需的修改:"
#: ../../guides/clear/stateless.rst:105
msgid "Reload the service or reboot the system to pickup any changes:"
msgstr "重新加载服务或重新启动系统以获取任何更改:"
#: ../../guides/clear/stateless.rst:111
msgid ""
"This pattern can be used to modify the configurations of other programs "
"too. The `stateless man page`_ has application-specific examples."
msgstr "这种模式也可以用来修改其他程序的配置。`stateless man page`_ 提供了特定于应用程序的示例。"
#: ../../guides/clear/stateless.rst:115
msgid "System reset"
msgstr "系统重置"
#: ../../guides/clear/stateless.rst:117
msgid ""
"Once advantage of the stateless design is that the system defaults can be"
" easily restored by simply deleting everything under :file:`/etc/` and "
":file:`/var`."
msgstr "无状态设计的一个优点是,只需删除 :file:`/etc/` 和 :file:`/var` 下的所有内容,就可以轻松恢复系统默认值。"
#: ../../guides/clear/stateless.rst:121
msgid ""
"Running the commands below effectively performs a system reset as if it "
"was just installed:"
msgstr "运行以下命令可以有效地执行系统重置,重置后系统就像刚刚安装一样:"
#: ../../guides/clear/stateless.rst:129
msgid ""
"In other Linux distributions, this can be a catastrophic action that "
"renders a system unable to boot."
msgstr "在其他 Linux 发行版中,此操作有可能造成灾难性后果,导致系统无法启动。"
#: ../../guides/clear/stateless.rst:133
msgid "Additional information"
msgstr "附加说明"
#: ../../guides/clear/stateless.rst:135
msgid "`stateless man page`_"
msgstr "`stateless man page`_"
@@ -0,0 +1,477 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../guides/clear/swupd.rst:4
msgid "swupd"
msgstr "swupd"
#: ../../guides/clear/swupd.rst:6
msgid ""
":command:`swupd` links a |CL-ATTR| installation with upstream updates and"
" software."
msgstr ":command:`swupd` 将 |CL-ATTR| 安装与上游更新和软件进行链接。"
#: ../../guides/clear/swupd.rst:14
msgid "Description"
msgstr "描述"
#: ../../guides/clear/swupd.rst:16
msgid ":command:`swupd` has two main functions:"
msgstr ":command:`swupd` 有两个主要功能:"
#: ../../guides/clear/swupd.rst:18
msgid ""
"Manage software and replace APT or YUM, by installing bundles rather than"
" packages."
msgstr "通过安装 bundle 文件而非软件包来管理软件并替换 APT 或 YUM。"
#: ../../guides/clear/swupd.rst:20
msgid "Check for system updates and install them."
msgstr "检查是否存在系统更新并进行安装。"
#: ../../guides/clear/swupd.rst:22
msgid ""
":command:`swupd` manages overlapping dependencies behind the scenes, "
"ensuring that all software is compatible across the system. It can be "
"used to verify the OS, clean cached files, and fix issues."
msgstr ":command:`swupd` 可管理后台的重叠依存关系,从而确保所有软件在整个系统中兼容。它可以验证操作系统、清理缓存文件和修复问题。"
#: ../../guides/clear/swupd.rst:26
msgid ""
":ref:`Bundles <bundles>` contain everything needed to deliver a software "
"capability. They are the smallest granularity component that is managed "
"by |CL|. A bundle comes with all of its dependencies rather than "
"downloading a cascade of package dependencies when installing a piece of "
"software."
msgstr ":ref:`Bundles <bundles>` 包含提供软件功能所需的一切。它们是 |CL| 管理的最小粒度组件。bundle 文件附带所有依存关系,而非在安装软件时下载一系列软件包依存关系。"
#: ../../guides/clear/swupd.rst:33
msgid "Versioning"
msgstr "版本管理"
#: ../../guides/clear/swupd.rst:35
msgid ""
"Using package managers to monitor software version compatibility or "
"compare multiple systems on many Linux distributions can be cumbersome."
msgstr "使用软件包管理器监控软件版本兼容性或比较大量 Linux 发行版上的多个系统可能十分麻烦。"
#: ../../guides/clear/swupd.rst:38
msgid ""
"With |CL| :command:`swupd`, versioning happens at the individual file "
"level. This means |CL| generates an entirely new OS version with any set "
"of software changes to the system, including software downgrades or "
"removals. This rolling release versioning model is similar to "
":command:`git` internal version tracking, where any of the individual "
"file commits are tracked and move the pointer forward when changed."
msgstr "借助 |CL| :command:`swupd`,则可在个别文件级别进行版本管理。也就是说,|CL| 会生成全新的操作系统版本,且附带对系统所做的所有软件更改,其中包括软件降级或删除。此滚动发布版本管理模型类似于 :command:`git` 内部版本跟踪,会跟踪所有单个文件提交并在更改时将指针前移。"
#: ../../guides/clear/swupd.rst:45
msgid ""
"A number that represents the **current** release of the OS describes the "
"versions of all the software on the OS. Each build is composed of a "
"specific set of bundles made from a particular version of packages. On a "
"daily basis, this matters to system administrators who need to determine "
"which of their systems do not have the latest security fixes, or which "
"combinations of software have been tested. Every release of the same "
"number is guaranteed to contain the same versions of software, so there's"
" no ambiguity between two systems running the same version of |CL|."
msgstr "表示操作系统当前版本的数字,描述操作系统上所有软件的版本。每个内部版本均由一组特定的 bundle 文件组成,而这些 bundle 文件则由特定版本的软件包组成。如果系统管理员日常需要确定哪些系统缺少最新安全修复程序,或哪些软件组合已经过测试,这对他们来说十分重要。对于同一数字的每个版本,均可以保证包含相同版本的软件,因此在运行同一版本的 |CL| 的两个系统之间不会产生混淆。"
#: ../../guides/clear/swupd.rst:55
msgid "Updating"
msgstr "更新中"
#: ../../guides/clear/swupd.rst:57
msgid ""
"|CL| enforces regular updating of the OS by default and automatically "
"checks for updates against a version server. The content server provides "
"the file and metadata content for all versions and can be the same as the"
" version server. The content url server provides metadata in the form of "
"*manifests*, which list and describe file contents, symlinks, and "
"directories. Additionally, the actual content is provided to clients in "
"the form of archive files."
msgstr "|CL| 默认强制定期更新操作系统,并自动对照版本服务器检查是否存在更新。内容服务器提供针对所有版本的文件和元数据内容,并可与版本服务器相同。内容 URL 服务器以清单形式提供元数据,列出并描述文件内容、符号链接和目录。此外,实际内容还会以存档文件的形式提供给客户端。"
#: ../../guides/clear/swupd.rst:65
msgid ""
"Software updates with |CL| are also efficient. Unlike package-based "
"distributions, :command:`swupd` only updates files that have changed, "
"rather than entire packages. For example, it is quite common for an OS "
"security patch to be as small as 15 KB. Using binary deltas, |CL| is able"
" to apply only what is needed."
msgstr "|CL| 的软件更新也十分高效。与基于软件包的发行版不同,:command:`swupd` 只会更新已更改的文件,而非整个软件包。例如,操作系统安全补丁大小经常只有 15 KB。通过使用二进制增量,|CL| 可只应用所需的内容。"
#: ../../guides/clear/swupd.rst:71
msgid ""
"For details on how to generate update content for |CL|, see the "
":ref:`mixer <mixer>` tool."
msgstr "有关如何为 |CL| 生成更新内容的详细信息,请参阅 :ref:`mixer <mixer>` 工具。"
#: ../../guides/clear/swupd.rst:75
msgid "How it works"
msgstr "工作原理"
#: ../../guides/clear/swupd.rst:78
msgid "Prerequisites"
msgstr "必备条件"
#: ../../guides/clear/swupd.rst:80
msgid "The device is on a well-connected network."
msgstr "设备网络连接良好。"
#: ../../guides/clear/swupd.rst:81
msgid ""
"The device is able to connect to an update server. The default server is:"
" http://update.clearlinux.org"
msgstr "设备可连接到更新服务器。默认服务器地址为:http://update.clearlinux.org"
#: ../../guides/clear/swupd.rst:85
msgid "Updates"
msgstr "更新"
#: ../../guides/clear/swupd.rst:87
msgid ""
"|CL| updates are automatic by default, but can be set to occur only on "
"demand. :command:`swupd` makes sure that regular updates are simple and "
"secure. It can also check the validity of currently installed files and "
"software, and can correct any problems."
msgstr "|CL| 更新默认自动进行,但也可设为按需进行。:command:`swupd` 可确保定期更新既简单又安全。它还可检查当前已安装文件和软件的有效性,并可更正所有问题。"
#: ../../guides/clear/swupd.rst:93
msgid "Manifests"
msgstr "清单"
#: ../../guides/clear/swupd.rst:95
msgid ""
"The |CL| software update content consists of data and metadata. The data "
"is the files that end up in the OS. The metadata contains relevant "
"information to properly provision the data to the OS file system, as well"
" as update the system and add or remove additional content to the OS."
msgstr "|CL| 软件更新内容由数据和元数据组成。数据是指操作系统中的文件。元数据包含将数据正确配置到操作系统文件系统、更新系统以及向操作系统添加或删除其他内容所需的相关信息。"
#: ../../guides/clear/swupd.rst:100
msgid ""
"The manifests are mostly long lists of hashes that describe content. Each"
" bundle gets its own manifest file. There is a master manifest file that "
"describes all manifests to tie it all together."
msgstr "清单多为用于描述内容的长哈希列表。每个 bundle 文件均有自己的清单文件。主清单文件描述了所有清单,可以将其绑定在一起。"
#: ../../guides/clear/swupd.rst:105
msgid "Fullfiles, packs, and delta packs"
msgstr "完整文件、数据包和增量包"
#: ../../guides/clear/swupd.rst:107
msgid ""
"To speed up updates and optimize content delivery, update data "
"provisioned to a system is obtained by one of the following methods:"
msgstr "要加速更新并优化内容交付,可通过以下方法获取配置到系统的更新数据:"
#: ../../guides/clear/swupd.rst:110
msgid ""
"*Fullfiles* are always generated for every file in every release. This "
"allows any |CL| to obtain the exact copy of the content for each version "
"directly. This is used if the OS verification needs to replace a single "
"file, for instance."
msgstr "在每个版本中,始终会为每个文件生成完整文件。此操作可让所有 |CL| 直接获取每个版本的精确内容副本。例如,如果操作系统验证需替换单个文件,则可使用此操作。"
#: ../../guides/clear/swupd.rst:115
msgid ""
"*Packs* are available for some releases. They combine many files to speed"
" up the creation of installation media and large updates."
msgstr "数据包可用于某些版本。它们将大量文件进行组合,从而加速安装介质制作过程,加快大型更新过程。"
#: ../../guides/clear/swupd.rst:118
msgid ""
"*Delta packs* are an optimized version of packs that only contain updates"
" (binary diffs). They cannot be used without having the original file "
"content."
msgstr "增量包是只包含更新(二进制差异)的优化版本的数据包。如果没有原始文件内容,则无法使用。"
#: ../../guides/clear/swupd.rst:122
msgid "Bundle search"
msgstr "bundle 文件搜索"
#: ../../guides/clear/swupd.rst:124
msgid ""
":command:`swupd` searches download manifest data for bundles that match "
"the term. Enter only one term, or hyphenated term, per search. Use the "
"command :command:`man swupd` to learn more."
msgstr ":command:`swupd` 可搜索下载清单数据,查找与此字词匹配的 bundle 文件。每次搜索只输入一个字词或带连字符的字词。使用命令 :command:`man swupd`,了解更多信息。"
#: ../../guides/clear/swupd.rst:128
msgid ""
"Only the base bundle is returned. Bundles can contain other bundles via "
"includes. For more details, see `Bundle Definition Files`_ and its "
"subdirectory bundles."
msgstr "系统只返回基本 bundle 文件。bundle 文件可通过 include 包含其他 bundle 文件。有关更多详细信息,请参阅 `Bundle Definition Files`_ 及其子目录 bundle 文件。"
#: ../../guides/clear/swupd.rst:132
msgid ""
"Bundles that are already installed are marked **(installed)** in search "
"results."
msgstr "已安装的 bundle 文件在搜索结果中标记为(已安装)。"
#: ../../guides/clear/swupd.rst:135
msgid "Optionally, you can review our `bundles`_ on GitHub\\*."
msgstr "您可以选择查看 GitHub\\* 上的 `bundles`_。"
#: ../../guides/clear/swupd.rst:138
msgid "Examples"
msgstr "示例"
#: ../../guides/clear/swupd.rst:141
msgid "Example 1: Disable and enable automatic updates"
msgstr "例 1:禁用和启用自动更新"
#: ../../guides/clear/swupd.rst:143
msgid ""
"|CL| updates are automatic by default, but can be set to occur only on "
"demand."
msgstr "|CL| 更新默认自动进行,但也可设为按需进行。"
#: ../../guides/clear/swupd.rst:146
msgid "Verify your current auto-update setting."
msgstr "验证当前的自动更新设置。"
#: ../../guides/clear/swupd.rst:152 ../../guides/clear/swupd.rst:164
msgid "Output:"
msgstr "输出:"
#: ../../guides/clear/swupd.rst:158
msgid "Disable automatic updates."
msgstr "禁用自动更新。"
#: ../../guides/clear/swupd.rst:174
msgid "Check manually for updates."
msgstr "手动检查是否存在更新。"
#: ../../guides/clear/swupd.rst:180
msgid "Install an update after identifying one that you need."
msgstr "确定所需的更新后对其进行安装。"
#: ../../guides/clear/swupd.rst:186
msgid "Re-enable automatic installs."
msgstr "再次启用自动安装。"
#: ../../guides/clear/swupd.rst:195
msgid "Example 2: Find and install Kata Containers\\*"
msgstr "例 2:查找并安装 Kata 容器\\*"
#: ../../guides/clear/swupd.rst:197
msgid ""
"Kata Containers is a popular container implementation. Unlike other "
"container implementations, each Kata Container has its own kernel "
"instance and runs on its own :abbr:`VM (Virtual Machine)` for improved "
"security."
msgstr "Kata 容器是一种常见的容器实现。与其他容器实现不同,每个 Kata 容器均有自己的内核实例,在自己的 :abbr:`虚拟机` 上运行,增强了安全性。"
#: ../../guides/clear/swupd.rst:202
msgid ""
"|CL| makes it very easy to install, since you only need to add one bundle"
" to use `Kata Containers`_: `containers-virt`_, despite a number of "
"dependencies. Also, check out our tutorial: :ref:`kata`."
msgstr "虽然存在大量依存关系,但由于您只需添加一个 bundle 文件便可使用 `Kata Containers`_ `containers-virt`_,因此 |CL| 大大简化了安装过程。此外,请查阅教程::ref:`kata`。"
#: ../../guides/clear/swupd.rst:206
msgid "Find the correct bundle."
msgstr "找到正确的 bundle 文件。"
#: ../../guides/clear/swupd.rst:208
msgid ""
"To return all possible matches for the search string, enter "
":command:`swupd search`, followed by 'kata':"
msgstr "要返回搜索字符串的所有潜在匹配项,请输入 :command:`swupd search`,后跟“kata”:"
#: ../../guides/clear/swupd.rst:215
msgid "The output should be similar to:"
msgstr "输出如下所示:"
#: ../../guides/clear/swupd.rst:234
msgid ""
"If your search does not produce results with a specific term, shorten the"
" search term. For example, use *kube* instead of *kubernetes*."
msgstr "如果未出现包含特定字词的搜索结果,请缩短搜索字词后重试。例如,使用 *kube* 而非 *kubernetes*。"
#: ../../guides/clear/swupd.rst:237
msgid "Add the bundle."
msgstr "添加 bundle 文件。"
#: ../../guides/clear/swupd.rst:245
msgid "To add multiple bundles, add a space followed by the bundle name."
msgstr "要添加多个 bundle 文件,请添加一个空格,后跟 bundle 文件名称。"
#: ../../guides/clear/swupd.rst:247
msgid "The output of a successful installation should be similar to:"
msgstr "成功安装的输出如下所示:"
#: ../../guides/clear/swupd.rst:266
msgid "Example 3: Verify and correct system file mismatch"
msgstr "例 3:验证并更正系统文件不匹配错误"
#: ../../guides/clear/swupd.rst:268
msgid ""
":command:`swupd` can determine whether system directories and files have "
"been added to, overwritten, removed, or modified (e.g., permissions)."
msgstr ":command:`swupd` 可确定是否已添加、覆盖、删除或修改系统目录和文件(例如权限)。"
#: ../../guides/clear/swupd.rst:275
msgid ""
"All directories that are watched by :command:`swupd` are verified "
"according to the manifest data. Hash mismatches are flagged as follows:"
msgstr ":command:`swupd` 所监控的所有目录均会根据清单数据进行验证。哈希不匹配项将按如下方式进行标记:"
#: ../../guides/clear/swupd.rst:292
msgid ""
"In this case, Python\\* packages that were installed on top of the "
"default install were flagged as mismatched. :command:`swupd` can be "
"directed to ignore or fix issues based on command line options."
msgstr "在此情况下,安装在默认安装之上的 Python\\* 软件包将被标记为不匹配。:command:`swupd` 可根据命令行选项指令来忽略或修复问题。"
#: ../../guides/clear/swupd.rst:296
msgid ""
":command:`swupd` can correct any issues it detects. Additional directives"
" can be added including a white list of directories to be ignored."
msgstr ":command:`swupd` 可更正检测到的所有问题。还可以添加其他指令,其中包括要忽略的目录的白名单。"
#: ../../guides/clear/swupd.rst:299
msgid ""
"The following command repairs issues, removes unknown items, and ignores "
"files or directories matching :file:`/usr/lib/python`:"
msgstr "以下命令可修复问题,删除未知项目,忽略匹配 :file:`/usr/lib/python` 的文件或目录:"
#: ../../guides/clear/swupd.rst:309
msgid "Quick reference"
msgstr "快速参考"
#: ../../guides/clear/swupd.rst:312
msgid "swupd info"
msgstr "swupd info"
#: ../../guides/clear/swupd.rst:312
msgid "Returns the currently installed version and update servers."
msgstr "返回当前安装的版本和更新服务器。"
#: ../../guides/clear/swupd.rst:316
msgid "swupd update <version number>"
msgstr "swupd update <version number>"
#: ../../guides/clear/swupd.rst:315
msgid ""
"Updates to a specific version or updates to latest version if no "
"arguments are used."
msgstr "如果未使用参数,则更新到特定版本或最新版本。"
#: ../../guides/clear/swupd.rst:319
msgid "swupd bundle-list [--all]"
msgstr "swupd bundle-list [--all]"
#: ../../guides/clear/swupd.rst:319
msgid "Lists installed bundles."
msgstr "列出已安装的 bundle 文件。"
#: ../../guides/clear/swupd.rst:322
msgid "swupd bundle <search term>"
msgstr "swupd bundle <search term>"
#: ../../guides/clear/swupd.rst:322
msgid "Finds a bundle that contains your search term."
msgstr "查找包含搜索字词的 bundle 文件。"
#: ../../guides/clear/swupd.rst:325
msgid "swupd bundle-add <bundle name>"
msgstr "swupd bundle-add <bundle name>"
#: ../../guides/clear/swupd.rst:325
msgid "Adds a bundle."
msgstr "添加 bundle 文件。"
#: ../../guides/clear/swupd.rst:328
msgid "swupd bundle-remove <bundle name>"
msgstr "swupd bundle-remove <bundle name>"
#: ../../guides/clear/swupd.rst:328
msgid "Removes a bundle."
msgstr "删除 bundle 文件。"
#: ../../guides/clear/swupd.rst:331
msgid "swupd --help"
msgstr "swupd --help"
#: ../../guides/clear/swupd.rst:331
msgid "Lists additional :command:`swupd` commands."
msgstr "列出其他 :command:`swupd` 命令。"
#: ../../guides/clear/swupd.rst:334
msgid "man swupd"
msgstr "man swupd"
#: ../../guides/clear/swupd.rst:334
msgid "Opens the :command:`swupd` man page."
msgstr "打开 :command:`swupd` 手册页。"
#: ../../guides/clear/swupd.rst:336
msgid "Refer to `swupd source documentation`_ on GitHub for more details."
msgstr "请参阅 GitHub 上的 `swupd source documentation`_,了解更多详细信息。"
#: ../../guides/clear/swupd.rst:339
msgid "Related topics"
msgstr "相关主题"
#: ../../guides/clear/swupd.rst:341
msgid ":ref:`autospec`"
msgstr ":ref:`autospec`"
#: ../../guides/clear/swupd.rst:342
msgid ":ref:`mixer`"
msgstr ":ref:`mixer`"
#: ../../guides/clear/swupd.rst:343
msgid ":ref:`bundles`"
msgstr ":ref:`bundles`"
#~ msgid ""
#~ "|CL| makes it very easy to "
#~ "install, since you only need to "
#~ "add `one bundle`_ to use `Kata "
#~ "Containers`_: `containers-virt`, despite a "
#~ "number of dependencies. Also, check out"
#~ " our tutorial: :ref:`kata`."
#~ msgstr ""
#~ msgid ""
#~ "Refer to :command:`swupd` `source "
#~ "documentation`_ on GitHub for more "
#~ "details."
#~ msgstr ""
File diff suppressed because it is too large Load Diff
+52
View File
@@ -0,0 +1,52 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../guides/index.rst:4
msgid "Guides"
msgstr "指南"
#: ../../guides/index.rst:6
msgid "The following guides provide step-by-step instructions on using |CL|."
msgstr "以下指南提供了使用 |CL| 的逐步说明。"
#: ../../guides/index.rst:10
msgid "As of 22 May 2019 :file:`mixin` is no longer supported."
msgstr "2019 年 5 月 22 日起将不再支持 :file:`mixin`。"
#: ../../guides/index.rst:15
msgid "Clear Linux"
msgstr "Clear Linux"
#: ../../guides/index.rst:24
msgid "Maintenance"
msgstr "维护"
#: ../../guides/index.rst:33
msgid "Network"
msgstr "网络"
#: ../../guides/index.rst:42
msgid "Kernel"
msgstr "内核"
#: ../../guides/index.rst:51
msgid "Stacks"
msgstr "堆栈"
@@ -0,0 +1,653 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../guides/kernel/kernel-development.rst:4
msgid "Kernel development"
msgstr "内核开发"
#: ../../guides/kernel/kernel-development.rst:6
msgid ""
"This guide shows how to obtain and compile a Linux\\* kernel source using"
" |CL-ATTR| development tooling."
msgstr "本指南介绍了如何使用 |CL-ATTR| 开发工具获取和编译 Linux\\* 内核源代码。"
#: ../../guides/kernel/kernel-development.rst:15
msgid "Overview"
msgstr "概述"
#: ../../guides/kernel/kernel-development.rst:17
msgid ""
"The :ref:`compatible-kernels` available in |CL| aim to be performant and "
"practical. In some cases, it may be necessary to modify the kernel to "
"suit your specific needs or test new kernel code as a developer."
msgstr "|CL| 中的 :ref:`compatible-kernels` 追求高效和实用。在某些情况下,您可能需要根据自身的具体需求修改内核,而开发人员也可能需要修改内核来测试新的内核代码。"
#: ../../guides/kernel/kernel-development.rst:21
msgid ""
"`Source RPMs (SRPMS)`_ are also available for all |CL| kernels, and can "
"be used for development instead."
msgstr "所有 |CL| 内核也提供了 `Source RPMs (SRPMS)`_,它可用于开发目的。"
#: ../../guides/kernel/kernel-development.rst:25
msgid "Request changes be included with the |CL| kernel"
msgstr "|CL| 内核中包含了请求变更"
#: ../../guides/kernel/kernel-development.rst:27
msgid ""
"If the kernel modification you need is already open source and likely to "
"be useful to others, consider submitting a request to include it in the "
"|CL| kernels. If your change request is accepted, you do not need to "
"maintain your own modified kernel."
msgstr "如果您需要的内核修改已经开源,并且可能对其他人也有用,请考虑提交一个请求,将其包含在 |CL| 内核中。如果您的变更请求被接受,则不需要维护自己修改过的内核。"
#: ../../guides/kernel/kernel-development.rst:32
msgid ""
"Make enhancement requests to the |CL| `Distribution Project`_ on "
"GitHub\\*."
msgstr "向 GitHub\\* 上的 |CL| `Distribution Project`_ 提出增强请求。"
#: ../../guides/kernel/kernel-development.rst:35
msgid "Set up kernel development environment"
msgstr "设置内核开发环境"
#: ../../guides/kernel/kernel-development.rst:37
msgid ""
"In some cases, it may be necessary to modify the kernel to suit your "
"specific needs or to test new kernel code."
msgstr "在某些情况下,您可能需要根据自身的具体需求或者为了测试新的内核代码而修改内核。"
#: ../../guides/kernel/kernel-development.rst:40
msgid "You can build and install a custom kernel; however you must:"
msgstr "您可以构建和安装自定义内核;但是,您必须:"
#: ../../guides/kernel/kernel-development.rst:42
msgid "Disable Secure Boot"
msgstr "禁用安全引导"
#: ../../guides/kernel/kernel-development.rst:43
msgid "Maintain any updates to the kernel going forward"
msgstr "在以后维护任何内核更新"
#: ../../guides/kernel/kernel-development.rst:45
msgid ""
"To create a custom kernel, start with the |CL| development environment. "
"Then make changes to the kernel, build it, and install it."
msgstr "要创建自定义内核,请先从 |CL| 开发环境开始。然后修改、构建和安装内核。"
#: ../../guides/kernel/kernel-development.rst:50
msgid "Install the |CL| development tooling framework"
msgstr "安装 |CL| 开发工具框架"
#: ../../guides/clear/autospec.rst:3
msgid ""
"Setup of the workspace and tooling used for building source in |CL| is "
"mostly automated for you with a setup script. It uses tools from the "
":command:`os-clr-on-clr` bundle."
msgstr "在 |CL| 中构建源代码所需的工作空间和工具设置操作大多数可通过设置脚本自动执行。该设置脚本使用来自 :command:`os-clr-on-clr` 捆绑包的工具。"
#: ../../guides/clear/autospec.rst:7
msgid ""
"The setup script creates a workspace in the :file:`clearlinux` folder, "
"with the subfolders :file:`Makefile`, :file:`packages`, and "
":file:`projects`. The :file:`projects` folder contains the main tools "
"used for making packages in |CL| :file:`autospec` and :file:`common`."
msgstr "该设置脚本会在 :file:`clearlinux` 文件夹(其中包含 :file:`Makefile`、:file:`packages` 和 :file:`projects` 子文件夹)中创建一个工作空间。:file:`projects` 文件夹包含在 |CL| 中制作软件包的主要工具,即 :file:`autospec` 和 :file:`common`。"
#: ../../guides/clear/autospec.rst:12
msgid "Follow these steps to setup the workspace and tooling for building source:"
msgstr "按照以下步骤设置构建代码所需的工作空间和工具:"
#: ../../guides/clear/autospec.rst:14
msgid "Install the :command:`os-clr-on-clr` bundle:"
msgstr "安装 :command:`os-clr-on-clr` 捆绑包:"
#: ../../guides/clear/autospec.rst:20
msgid "Download the :file:`user-setup.sh` script:"
msgstr "下载 :file:`user-setup.sh` 脚本:"
#: ../../guides/clear/autospec.rst:26
msgid "Make :file:`user-setup.sh` executable:"
msgstr "制作 :file:`user-setup.sh` 可执行文件:"
#: ../../guides/clear/autospec.rst:32
msgid "Run the script as an unprivileged user:"
msgstr "以非特权用户的身份运行脚本:"
#: ../../guides/clear/autospec.rst:38
msgid ""
"After the script completes, log out and log in again to complete the "
"setup process."
msgstr "脚本完成后,注销并再次登录以完成设置过程。"
#: ../../guides/clear/autospec.rst:41
msgid "Set your Git user email and username for the repos on your system:"
msgstr "在系统上设置存储库的 Git 用户电子邮件和用户名:"
#: ../../guides/clear/autospec.rst:48
msgid "This global setting is used by |CL| tools that make use of Git."
msgstr "此全局设置由使用 Git 的 |CL| 工具使用。"
#: ../../guides/kernel/kernel-development.rst:57
msgid "Clone the kernel package"
msgstr "克隆内核包"
#: ../../guides/kernel/kernel-development.rst:59
msgid ""
"Clone the existing kernel package repository from |CL| as a starting "
"point."
msgstr "首先从 |CL| 克隆现有的内核包存储库。"
#: ../../guides/kernel/kernel-development.rst:61
msgid ""
"Clone the Linux kernel package from |CL|. Using the :command:`make "
"clone_<PACKAGENAME>` command in the :file:`clearlinux/` directory clones "
"the package from the `clearlinux-pkgs`_ repo on GitHub."
msgstr "从 |CL| 克隆 Linux 内核包。在 :file:`clearlinux/` 目录下使用 :command:`make clone_<PACKAGENAME>` 命令,从 GitHub 上的 `clearlinux-pkgs`_ 存储库克隆内核包。"
#: ../../guides/kernel/kernel-development.rst:71
msgid "Navigate into the cloned package directory."
msgstr "导航到克隆的内核包目录。"
#: ../../guides/kernel/kernel-development.rst:78
msgid ""
"The \"linux\" package is the kernel that comes with |CL| in the :command"
":`kernel-native` bundle. Alternatively, you can use a different kernel "
"variant as the base for modification. For a list of kernel package names "
"which you can clone instead, see the `clearlinux-pkgs`_ repo on GitHub."
msgstr "\"linux\" 包是 :command:`kernel-native` 捆绑包中随 |CL| 附带的内核。您也可以使用不同的内核变体,并在其基础上进行修改。有关可以克隆的内核包名称列表,请参阅 GitHub 上的 `clearlinux-pkgs`_ 存储库。"
#: ../../guides/kernel/kernel-development.rst:85
msgid ""
"The latest version of the |CL| kernel package is pulled as a starting "
"point. An older version can pulled by switching to different git tag by "
"using :command:`git checkout tag/<TAG_NAME>`."
msgstr "一开始先提取 |CL| 内核包的最新版本。此外可以使用 :command:`git checkout tag/<TAG_NAME>`,并通过切换到不同的 git 标签来提取旧版本。"
#: ../../guides/kernel/kernel-development.rst:90
msgid "Change the kernel version"
msgstr "更改内核版本"
#: ../../guides/kernel/kernel-development.rst:92
msgid ""
"|CL| tends to use the latest kernel available from `kernel.org`_, the "
"Linux upstream. The kernel version that will be built can be changed in "
"the RPM SPEC file. While most packages in Clear Linux are typically "
"packaged using :ref:`autospec`, the kernel is not. This means control "
"files provided by autospec are not available and changes must be made "
"manually."
msgstr "|CL| 倾向于使用来自 Linux 上游 `kernel.org`_ 的最新内核。在 RPM SPEC 文件中可以更改将构建的内核版本。虽然 Clear Linux 中的大多数包通常使用 :ref:`autospec` 打包,但内核不是。这意味着 autospec 提供的控制文件不可用,必须手动进行更改。"
#: ../../guides/kernel/kernel-development.rst:98
#: ../../guides/kernel/kernel-development.rst:294
msgid "Open the Linux kernel package RPM SPEC file in an editor."
msgstr "在编辑器中打开 Linux 内核包 RPM SPEC 文件。"
#: ../../guides/kernel/kernel-development.rst:104
msgid ""
"Modify the Version, Release, and Source0 URL entries at the top of the "
"file to change the version of Linux kernel that will be compiled."
msgstr "修改文件顶部的 Version、Release 和 Source0 URL 条目,以更改将要编译的 Linux 内核版本。"
#: ../../guides/kernel/kernel-development.rst:107
msgid ""
"A list of current and available kernel release can be found on "
"`kernel.org`_."
msgstr "当前和可用内核版本的列表可在 `kernel.org`_ 上找到。"
#: ../../guides/kernel/kernel-development.rst:126
msgid ""
"Consider changing the Name from *linux* in the RPM spec file to easily "
"identify a modified kernel."
msgstr "考虑在 RPM 规范文件中将 Name 从 *linux* 更改为更易于识别的名称,以便轻松识别修改后的内核。"
#: ../../guides/kernel/kernel-development.rst:129
msgid ""
"Consider changing the ktarget from *native* in the RPM spec file to "
"easily identify a modified kernel."
msgstr "考虑在 RPM 规范文件中将 ktarget 从 *native* 更改为更易于识别的名称,以便轻松识别修改后的内核。"
#: ../../guides/kernel/kernel-development.rst:132
msgid "Commit and save the changes to the file."
msgstr "提交并保存对文件的更改。"
#: ../../guides/kernel/kernel-development.rst:137
msgid "Pull a copy of the Linux kernel source code"
msgstr "提取一份 Linux 内核源代码副本"
#: ../../guides/kernel/kernel-development.rst:139
msgid "Obtain a local copy of the source code to make modifications against."
msgstr "获取源代码的本地副本进行修改。"
#: ../../guides/kernel/kernel-development.rst:141
msgid ""
"Run make sources to pull the kernel source code specified in the RPM SPEC"
" file. In the example, it downloads the :file:`linux-4.20.8.tar.xz` file."
msgstr "运行源代码制作操作,提取在 RPM SPEC 文件中指定的内核源代码。本例中下载了 :file:`linux-4.20.8.tar.xz` 文件。"
#: ../../guides/kernel/kernel-development.rst:149
msgid ""
"Extract the kernel source code archive. This will create a working copy "
"of the Linux source that you can modify."
msgstr "提取内核源代码存档。这将创建一个可以修改的 Linux 源代码工作副本。"
#: ../../guides/kernel/kernel-development.rst:156
msgid ""
"Navigate to the extracted directory. In this example, it has been "
"extracted into a :file:`linux-4.20.8` directory."
msgstr "导航到提取的目录。本例中将源代码提取到了 :file:`linux-4.20.8` 目录。"
#: ../../guides/kernel/kernel-development.rst:165
msgid "Customize the Linux kernel source"
msgstr "自定义 Linux 内核源代码"
#: ../../guides/kernel/kernel-development.rst:167
msgid ""
"After the kernel sources have been obtained, customizations to the kernel"
" configuration or source code can be made for inclusion with the kernel "
"build. These customizations are optional."
msgstr "获得内核源代码后,可以自定义内核配置或源代码,将其包含在内核构建中。这些自定义是可选的。"
#: ../../guides/kernel/kernel-development.rst:172
msgid "Modify kernel configuration"
msgstr "修改内核配置"
#: ../../guides/kernel/kernel-development.rst:174
msgid ""
"The kernel source has many configuration options available to pick "
"support for different hardware and software features."
msgstr "内核源代码提供了许多配置选项,可支持不同的硬件和软件功能。"
#: ../../guides/kernel/kernel-development.rst:177
msgid ""
"These configuration values must be provided in the :file:`.config` file "
"at compile time. You will need to make modifications to the "
":file:`.config` file, and include it in the kernel package."
msgstr "编译时必须在 :file:`.config` 文件中提供这些配置值。您需要修改 :file:`.config` 文件,并将其包含在内核包中。"
#: ../../guides/kernel/kernel-development.rst:182
#: ../../guides/kernel/kernel-development.rst:238
msgid ""
"Make sure you have followed the steps to :ref:`pull-copy-kernel-source` "
"and are in the kernel source working directory."
msgstr "请确保您已经执行了 :ref:`pull-copy-kernel-source` 中的步骤,而且处于内核源代码工作目录下。"
#: ../../guides/kernel/kernel-development.rst:186
msgid ""
"If you have an existing :file:`.config` file from an old kernel, copy it "
"into the working directory as :file:`.config` for comparison. Otherwise, "
"use the |CL| kernel configuration file as template"
msgstr "如果您目前有一个来自旧内核的 :file:`.config` 文件,请将其复制到工作目录中进行比较。否则,请使用 |CL| 内核配置文件作为模板"
#: ../../guides/kernel/kernel-development.rst:195
msgid ""
"Make any desired changes to the :file:`.config` using a kernel "
"configuration tool. Below are some popular options:"
msgstr "使用内核配置工具对 :file:`.config` 执行所需的更改。以下是一些常用选项:"
#: ../../guides/kernel/kernel-development.rst:198
msgid ""
":command:`$EDITOR .config` - the .config file can be directly edited for "
"simple changes with names that are already known."
msgstr ":command:`$EDITOR .config` - 可以直接编辑 .config 文件,对已知的名称进行简单更改。"
#: ../../guides/kernel/kernel-development.rst:201
msgid ""
":command:`make config` - a text-based tool that asks questions one-by-one"
" to decide configuration options."
msgstr ":command:`make config` - 一个基于文本的工具,通过逐步提问的方式决定配置选项。"
#: ../../guides/kernel/kernel-development.rst:204
msgid ""
":command:`make menuconfig` - a terminal user interface that provides "
"menus to decide configuration options."
msgstr ":command:`make menuconfig` - 一个终端用户界面,通过提供菜单来决定配置选项。"
#: ../../guides/kernel/kernel-development.rst:207
msgid ""
":command:`make xconfig` - a graphical user interface that provides tree "
"views to decide configuration options."
msgstr ":command:`make xconfig` - 一个图形用户界面,通过提供树视图来决定配置选项。"
#: ../../guides/kernel/kernel-development.rst:211
msgid ""
"More configuration tools can be found by looking at the make help: "
":command:`make help | grep config`"
msgstr "使用 :command:`make help | grep config` 命令查看 make help 可以找到更多配置工具"
#: ../../guides/kernel/kernel-development.rst:214
msgid "Commit and save the changes to the :file:`.config` file."
msgstr "提交更改并将其保存到 :file:`.config` 文件。"
#: ../../guides/kernel/kernel-development.rst:216
msgid ""
"Copy the :file:`.config` file from the kernel source directory into the "
"kernel package directory as :file:`config` for inclusion in the build."
msgstr "将 :file:`.config` 文件从内核源代码目录复制到内核包目录,以便将 :file:`.config` 包含在构建中。"
#: ../../guides/kernel/kernel-development.rst:224
msgid "Modify kernel source code"
msgstr "修改内核源代码"
#: ../../guides/kernel/kernel-development.rst:226
msgid ""
"Changes to kernel code are applied with patch files. Patch files are "
"formatted git commits that can be applied to the main source code."
msgstr "对内核代码的更改通过补丁文件应用。补丁文件是格式化的 git 提交,可以应用于主源代码。"
#: ../../guides/kernel/kernel-development.rst:229
msgid ""
"You will need to obtain a copy of the source code, make modifications, "
"generate patch file(s), and add them to the RPM SPEC file for inclusion "
"during the kernel build."
msgstr "您需要获得源代码的副本,进行修改,生成补丁文件,然后将它们添加到 RPM SPEC 文件中,以便在内核构建期间包含在内。"
#: ../../guides/kernel/kernel-development.rst:233
msgid ""
"If you have a large number of patches or a more complex workflow, "
"consider using a patch management tool in addition to Git such as "
"`Quilt`_."
msgstr "如果有大量补丁或工作流程十分复杂,可考虑在 Git 之外使用 `Quilt`_ 之类补丁管理工具。"
#: ../../guides/kernel/kernel-development.rst:242
msgid ""
"Initialize the kernel source directory as a new git repo and create a "
"commit with all the existing source files to begin tracking changes."
msgstr "将内核源代码目录初始化为新的 git 存储库,并使用所有现有源文件创建一个提交,以开始跟踪更改。"
#: ../../guides/kernel/kernel-development.rst:252
msgid ""
"Apply patches provided by the |CL| kernel package to the kernel source in"
" the working directory."
msgstr "将 |CL| 内核包提供的补丁应用于工作目录中的内核源代码。"
#: ../../guides/kernel/kernel-development.rst:260
msgid "Make any of your desired code changes to the Linux source code files."
msgstr "对 Linux 源代码文件执行所需的代码更改。"
#: ../../guides/kernel/kernel-development.rst:263
msgid "Track and commit your changes to the local git repo."
msgstr "跟踪您的更改,并将其提交到本地 git 存储库。"
#: ../../guides/kernel/kernel-development.rst:271
msgid ""
"Generate a patch file based on your git commits. <n> represents the "
"number of local commits to create patch file. See the `git-format-patch`_"
" documentation for detailed information on using :command:`git format-"
"patch`"
msgstr "基于您的 git 提交生成补丁文件。<n>表示要创建补丁文件的本地提交数量。有关使用 :command:`git format-patch` 的详细信息,请参阅 `git-format-patch`_ 文档"
#: ../../guides/kernel/kernel-development.rst:280
msgid ""
"Copy the patch files from the patches directory in the linux source tree "
"to the RPM build directory."
msgstr "将补丁文件从 Linux 源代码树中的补丁目录复制到 RPM 构建目录。"
#: ../../guides/kernel/kernel-development.rst:288
msgid "Navigate back to the RPM build directory."
msgstr "导航回 RPM 构建目录。"
#: ../../guides/kernel/kernel-development.rst:300
msgid ""
"Locate the section of the SPEC file that contains existing patch variable"
" definitions and append your patch file name. Ensure the patch number "
"does not collide with an existing patch. In this example, the patch file "
"is called :file:`2001-my-patch-for-driver-A.patch`"
msgstr "找到包含现有补丁变量定义的 SPEC 文件部分,并附加补丁文件名。确保补丁编号不与现有补丁冲突。本例中的补丁文件名为 :file:`2001-my-patch-for-driver-A.patch`"
#: ../../guides/kernel/kernel-development.rst:323
msgid ""
"Locate the section of the SPEC file further down that contains patch "
"application and append your patch file number used in the step above. In "
"this example, patch2001 is added."
msgstr "进一步深入查找含有补丁应用程序的 SPEC 文件部分,并附加在上面步骤中使用的补丁文件编号。本例中添加了 patch2001。"
#: ../../guides/kernel/kernel-development.rst:342
msgid "Commit and save the changes to the RPM SPEC file."
msgstr "提交并保存对 RPM SPEC 文件的更改。"
#: ../../guides/kernel/kernel-development.rst:345
msgid "Modify kernel boot parameters"
msgstr "修改内核引导参数"
#: ../../guides/kernel/kernel-development.rst:346
msgid ""
"The kernel boot options are passed from the bootloader to the kernel with"
" command-line parameters."
msgstr "内核引导选项通过命令行参数从引导加载程序传递到内核。"
#: ../../guides/kernel/kernel-development.rst:349
msgid ""
"While temporary changes can be made to kernel parameters on a running "
"system or on a during boot, you can also modify the default parameters "
"that are persistent and distributed with a customized kernel."
msgstr "虽然可以在正在运行的系统上或在引导过程中对内核参数进行临时更改,但您也可以修改随自定义内核分发并持久存在的默认参数。"
#: ../../guides/kernel/kernel-development.rst:354
msgid "Open the kernel :file:`cmdline` file in an editor."
msgstr "在编辑器中打开内核 :file:`cmdline` 文件。"
#: ../../guides/kernel/kernel-development.rst:361
msgid ""
"Make any desired change to the kernel parameters. For example, you can "
"remove the :command:`quiet` parameter to see more verbose output of "
"kernel log messages during the boot process."
msgstr "对内核参数执行所需的更改。例如,您可以移除 :command:`quiet` 参数,以便在引导过程中查看更详细的内核日志消息输出。"
#: ../../guides/kernel/kernel-development.rst:365
msgid "Commit and save the changes to the :file:`cmdline` file."
msgstr "提交更改并将其保存到 :file:`cmdline` 文件。"
#: ../../guides/kernel/kernel-development.rst:367
msgid ""
"See the `kernel parameters`_ documentation for a list of available "
"parameters."
msgstr "有关可用参数的列表,请参阅 `kernel parameters`_ 文档。"
#: ../../guides/kernel/kernel-development.rst:371
msgid "Build and install the kernel"
msgstr "构建并安装内核"
#: ../../guides/kernel/kernel-development.rst:372
msgid ""
"After changes have been made to the kernel source and RPM SPEC file, the "
"kernel is ready to be compiled and packaged into an RPM."
msgstr "更改内核源代码和 RPM SPEC 文件后,内核就可以编译并打包成 RPM。"
#: ../../guides/kernel/kernel-development.rst:375
msgid ""
"The |CL| development tooling makes use of :command:`mock` environments to"
" isolate building of packages in a sanitized workspace."
msgstr "|CL| 开发工具使用 :command:`mock` 环境来在净化的工作区中隔离内核包构建工作。"
#: ../../guides/kernel/kernel-development.rst:378
msgid ""
"Start the compilation process by issuing the :command:`make build` "
"command. This process is typically resource intensive and will take a "
"while."
msgstr "发出 :command:`make build` 命令启动编译过程。此过程通常会占用大量资源,而且需要一段时间。"
#: ../../guides/kernel/kernel-development.rst:386
msgid ""
"The mock plugin `ccache`_ can be enabled to help speed up any future "
"rebuilds of the kernel package by caching compiler outputs and reusing "
"them."
msgstr "您可以启用 mock 插件 `ccache`_,通过缓存并重用编译器输出来加快日后执行的内核包重新构建速度。"
#: ../../guides/kernel/kernel-development.rst:391
msgid ""
"The result will be multiple :file:`.rpm` files in the :file:`rpms` "
"directory as output."
msgstr "编译后会在 :file:`rpms` 目录中输出多个 :file:`.rpm` 文件。"
#: ../../guides/kernel/kernel-development.rst:398
msgid ""
"The kernel RPM will be named "
":file:`linux<NAME>-<VERSION>-<RELEASE>.x86_64.rpm`"
msgstr "内核 RPM 将命名为 :file:`linux<NAME>-<VERSION>-<RELEASE>.x86_64.rpm`"
#: ../../guides/kernel/kernel-development.rst:402
msgid ""
"The kernel RPM file can be input to the :ref:`mixer` to create a custom "
"bundle and mix of |CL|."
msgstr "内核 RPM 文件可以输入到 :ref:`mixer`,以创建自定义捆绑包和 |CL| 混合版。"
#: ../../guides/kernel/kernel-development.rst:405
msgid ""
"Alternatively, the kernel RPM bundle can be installed manually on a local"
" machine for testing. This approach works well for individual development"
" or testing. For a more scalable and customizable approach, consider "
"using the :ref:`mixer` to provide a custom kernel with updates."
msgstr "内核 RPM 捆绑包也可以手动安装在本地计算机上进行测试。此方法对于个人开发或测试非常有效。如需使用可扩展性和可自定义性更好的方法,可考虑使用 :ref:`mixer` 为自定义内核提供更新。"
#: ../../guides/kernel/kernel-development.rst:410
msgid ""
"Install the kernel onto the local system by extracting the RPM with the "
":command:`rpm2cpio` command."
msgstr "使用 :command:`rpm2cpio` 命令提取 RPM,将内核安装到本地系统上。"
#: ../../guides/kernel/kernel-development.rst:418
msgid "Update the |CL| boot manager using :command:`clr-boot-manager` and reboot."
msgstr "使用 :command:`clr-boot-manager` 命令更新 |CL| 引导管理器,然后重启。"
#: ../../guides/kernel/kernel-development.rst:428
msgid "After a reboot, verify the customized kernel is running."
msgstr "重启后,确认自定义内核是否正在运行。"
#: ../../guides/kernel/kernel-development.rst:435
msgid "Related topics"
msgstr "相关主题"
#: ../../guides/kernel/kernel-development.rst:437
msgid ":ref:`kernel-modules`"
msgstr ":ref:`kernel-modules`"
#: ../../guides/kernel/kernel-development.rst:438
msgid ":ref:`mixer`"
msgstr ":ref:`mixer`"
#~ msgid ""
#~ "This document shows how to obtain "
#~ "and compile a Linux* kernel source "
#~ "using |CL-ATTR| development tooling."
#~ msgstr ""
#~ msgid ""
#~ "The `kernels available`_ in |CL| aim"
#~ " to be performant and practical. In"
#~ " some cases, it may be necessary "
#~ "to modify the kernel to suit your"
#~ " specific needs or test new kernel"
#~ " code as a developer."
#~ msgstr ""
#~ msgid ""
#~ "Source RPM files (SRPM) are also "
#~ "available for all |CL| kernels, and "
#~ "can be used for development instead. "
#~ "Select this link to view the "
#~ "latest `source RPM files`_."
#~ msgstr ""
#~ msgid "Make enhancement requests to the |CL| `distribution on GitHub`_ ."
#~ msgstr ""
#~ msgid ""
#~ "Clone the Linux kernel package from "
#~ "|CL|. Using the :command:`make "
#~ "clone_<PACKAGENAME>` command in the "
#~ ":file:`clearlinux/` directory clones the "
#~ "package from the `clearlinux-pkgs "
#~ "GitHub`_."
#~ msgstr ""
#~ msgid ""
#~ "The \"linux\" package is the kernel "
#~ "that comes with |CL| in the "
#~ "`kernel-native` bundle. Alternatively, you "
#~ "can use a different kernel variant "
#~ "as the base for modification. For "
#~ "a list of kernel package names "
#~ "which you can clone instead, see "
#~ "the `clearlinux-pkgs GitHub`_."
#~ msgstr ""
#~ msgid ""
#~ "Generate a patch file based on "
#~ "your git commits. <n> represents the "
#~ "number of local commits to create "
#~ "patch file. See the `git-format-"
#~ "patch Documentation`_ for detailed information"
#~ " on using :command:`git format-patch`"
#~ msgstr ""
#~ msgid ""
#~ "See the `Kernel parameters documentation`_ "
#~ "for a list of available parameters."
#~ msgstr ""
#~ msgid ""
#~ "The `ccache plugin for mock`_ can "
#~ "be enabled to help speed up any"
#~ " future rebuilds of the kernel "
#~ "package by caching compiler outputs and"
#~ " reusing them."
#~ msgstr ""
#~ msgid ""
#~ "This guide shows how to obtain and"
#~ " compile a Linux* kernel source using"
#~ " |CL-ATTR| development tooling."
#~ msgstr ""
#~ msgid ""
#~ "Make enhancement requests to the |CL|"
#~ " `Distribution Project`_ on GitHub."
#~ msgstr ""
#~ msgid ""
#~ "The \"linux\" package is the kernel "
#~ "that comes with |CL| in the "
#~ "`kernel-native` bundle. Alternatively, you "
#~ "can use a different kernel variant "
#~ "as the base for modification. For "
#~ "a list of kernel package names "
#~ "which you can clone instead, see "
#~ "the `clearlinux-pkgs`_ repo on GitHub."
#~ msgstr ""
#~ msgid ""
#~ "Make sure you have followed the "
#~ "steps to `Pull a copy of the "
#~ "Linux kernel source code`_ and are "
#~ "in the kernel source working directory."
#~ msgstr ""
@@ -0,0 +1,566 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/kernel/kernel-modules-dkms.rst:4
msgid "Add kernel modules with DKMS"
msgstr "使用 DKMS 添加内核模块"
#: ../../guides/kernel/kernel-modules-dkms.rst:6
msgid ""
"This guide describes how to add kernel modules with :abbr:`DKMS (Dynamic "
"Kernel Module System)`."
msgstr "本指南介绍如何使用 :abbr:`DKMS (Dynamic Kernel Module System)` 添加内核模块。"
#: ../../guides/kernel/kernel-modules-dkms.rst:14
msgid "Overview"
msgstr "概述"
#: ../../guides/kernel/kernel-modules-dkms.rst:16
msgid ""
"Certain kernel modules are enabled by default in |CL-ATTR|. To use "
"additional kernel modules that are not part of the Linux source tree, you"
" may need to build out-of-tree kernel modules. Use this guide to add "
"kernel modules with :abbr:`DKMS (Dynamic Kernel Module System)` or refer "
"to :ref:`kernel-modules`."
msgstr "某些内核模块在 |CL-ATTR| 中默认启用。要使用不属于 Linux 源代码树的其他内核模块,您可能需要构建树外内核模块。按照本指南使用 :abbr:`DKMS (Dynamic Kernel Module System)` 添加内核模块,或参阅 :ref:`kernel-modules`。"
#: ../../guides/kernel/kernel-modules-dkms.rst:22
msgid "Description"
msgstr "描述"
#: ../../guides/kernel/kernel-modules-dkms.rst:24
msgid ""
"Kernel modules are additional pieces of software capable of being "
"inserted into the Linux kernel to add functionality, such as a hardware "
"driver. Kernel modules may already be part of the Linux source tree (in-"
"tree) or may come from an external source, such as directly from a vendor"
" (out-of-tree)."
msgstr "内核模块是能够插入到 Linux 内核中以增加功能的附加软件,例如硬件驱动程序。内核模块可能已经是 Linux 源代码树的一部分(树内),也可能来自外部来源,例如直接来自供应商(树外)。"
#: ../../guides/kernel/kernel-modules-dkms.rst:29
msgid ""
":abbr:`DKMS (Dynamic Kernel Module System)` is a framework that "
"facilitates the building and installation of kernel modules. DKMS allows "
"|CL| to provide hooks that automatically rebuild modules against new "
"kernel versions."
msgstr ":abbr:`DKMS (Dynamic Kernel Module System)` 是一个便于构建和安装内核模块的框架。DKMS 允许 |CL| 提供钩子,为新版本内核自动重新构建模块。"
#: ../../guides/kernel/kernel-modules.rst:4
msgid "Kernel module availability"
msgstr "内核模块可用性"
#: ../../guides/kernel/kernel-modules.rst:6
msgid ""
"|CL| comes with many upstream kernel modules available for use. Using an "
"existing module is significantly easier to maintain and retains signature"
" verification of the |CL| kernel. For more information on |CL| security "
"practices, see the :ref:`security` page."
msgstr "|CL| 附带了许多上游内核模块以备使用。使用现有模块时,维护和保留 |CL| 内核的签名验证要容易得多。有关 |CL| 安全实践的更多信息,请参阅 :ref:`security` 页面。"
#: ../../guides/kernel/kernel-modules.rst:11
msgid ""
"Before continuing, check if the kernel module you're looking for is "
"already available in |CL| or submit a request to add the module."
msgstr "继续之前,请检查您正在寻找的内核模块是否已经在 |CL| 中可用,或者提交添加该模块的请求。"
#: ../../guides/kernel/kernel-modules.rst:16
msgid "Check if the module is already available"
msgstr "检查模块是否已经可用"
#: ../../guides/kernel/kernel-modules.rst:19
msgid ""
"You can search for kernel module file names, which end with the "
":file:`.ko` file extension, using the :command:`swupd search` command, as"
" shown in the following example. See :ref:`swupd-guide` for more "
"information."
msgstr "您可以使用 :command:`swupd search` 命令搜索以 :file:`.ko` 文件扩展名结尾的内核模块文件名,如下例所示。有关详细信息,请参阅 :ref:`swupd-guide`。"
#: ../../guides/kernel/kernel-modules.rst:29
msgid "Submit a request to add the module"
msgstr "提交添加模块的请求"
#: ../../guides/kernel/kernel-modules.rst:31
msgid ""
"If the kernel module you need is already open source (for example, in the"
" Linux upstream) and likely to be useful to others, consider submitting a"
" request to add or enable it in the |CL| kernel."
msgstr "如果您需要的内核模块已经开源(例如在 Linux 上游),并且可能对其他人也有用,可考虑提交在 |CL| 内核中添加或启用该模块的请求。"
#: ../../guides/kernel/kernel-modules.rst:35
msgid "Make enhancement requests to the |CL| 'Distribution Project'_ on GitHub."
msgstr "向 GitHub 上的 |CL| 'Distribution Project'_ 提出增强请求。"
#: ../../guides/kernel/kernel-modules-dkms.rst:38
msgid "Install DKMS"
msgstr "安装 DKMS"
#: ../../guides/kernel/kernel-modules-dkms.rst:42
msgid ""
"The :command:`kernel-native-dkms` bundle provides the :command:`dkms` "
"program and Linux kernel headers, which are required for compiling kernel"
" modules."
msgstr ":command:`kernel-native-dkms` 捆绑包提供了 :command:`dkms` 程序和 Linux 内核头文件,它们是编译内核模块所必需的。"
#: ../../guides/kernel/kernel-modules-dkms.rst:45
msgid "The :command:`kernel-native-dkms` bundle also:"
msgstr ":command:`kernel-native-dkms` 捆绑包还会:"
#: ../../guides/kernel/kernel-modules-dkms.rst:47
msgid ""
"Adds a `systemd` update trigger (:file:`/usr/lib/systemd/system/dkms-new-"
"kernel.service`) to automatically run DKMS to rebuild modules after a "
"kernel upgrade occurs with :ref:`swupd update <swupd-guide>`."
msgstr "添加 `systemd` update trigger (:file:`/usr/lib/systemd/system/dkms-new-kernel.service`),用来在使用 :ref:`swupd update <swupd-guide>` 升级内核后自动运行 DKMS 来重新构建模块。"
#: ../../guides/kernel/kernel-modules-dkms.rst:52
msgid ""
"Disables kernel module signature verification by appending a kernel "
"command-line parameter (:command:`module.sig_unenforce`) from the "
":file:`/usr/share/kernel/cmdline.d/clr-ignore-mod-sig.conf` file."
msgstr "通过附加来自 :file:`/usr/share/kernel/cmdline.d/clr-ignore-mod-sig.conf` 文件的内核命令行参数 (:command:`module.sig_unenforce`),禁用内核模块签名验证。"
#: ../../guides/kernel/kernel-modules-dkms.rst:56
msgid ""
"Adds a notification to the Message of the Day (MOTD) indicating kernel "
"module signature verification is disabled."
msgstr "向每日消息 (MOTD) 添加一条通知,指示内核模块签名验证已禁用。"
#: ../../guides/kernel/kernel-modules-dkms.rst:61
msgid ""
"We recommend that you always review the :command:`swupd update` output to"
" make sure kernel modules were successfully rebuilt against the new "
"kernel. This is especially important for systems where a successful boot "
"relies on a kernel module."
msgstr "我们建议您始终查看 :command:`swupd update` 输出,确保为新内核成功重新构建了内核模块。这对引导是否成功有赖于内核模块的系统尤其重要。"
#: ../../guides/kernel/kernel-modules-dkms.rst:66
msgid ""
"Install the :command:`kernel-native-dkms` or :command:`kernel-lts-dkms` "
"bundle:"
msgstr "安装 :command:`kernel-native-dkms` 或 :command:`kernel-lts-dkms` 捆绑包:"
#: ../../guides/kernel/kernel-modules-dkms.rst:69
msgid ""
"Determine which kernel variant is running on |CL|. Only the *native* and "
"*lts* kernels are enabled to build and load out-of-tree kernel modules "
"with DKMS."
msgstr "确定 |CL| 上运行的内核变体。只有 *native* 和 *lts* 内核能够使用 DKMS 构建和加载树外内核模块。"
#: ../../guides/kernel/kernel-modules-dkms.rst:78
msgid "Ensure *.native* or *.lts* is in the kernel name."
msgstr "确保内核名称中含有 *.native* 或 *.lts*。"
#: ../../guides/kernel/kernel-modules-dkms.rst:80
msgid ""
"Install the DKMS bundle corresponding to the installed kernel. Use "
":command:`kernel-native-dkms` for the native kernel or :command:`kernel-"
"lts-dkms` for the lts kernel."
msgstr "安装与已安装内核相对应的 DKMS 捆绑包。为 native 内核使用 :command:`kernel-native-dkms`,或者为 lts 内核使用 :command:`kernel-lts-dkms`。"
#: ../../guides/kernel/kernel-modules-dkms.rst:88
msgid "or"
msgstr "或者"
#: ../../guides/kernel/kernel-modules-dkms.rst:95
msgid "Update the |CL| bootloader and reboot."
msgstr "更新 |CL| 引导加载程序并重启。"
#: ../../guides/kernel/kernel-modules-dkms.rst:105
msgid "Build, install, and load an out-of-tree module"
msgstr "构建、安装和加载树外模块"
#: ../../guides/kernel/kernel-modules-dkms.rst:107
msgid ""
"Follow the steps in this section if you are an individual user or "
"testing, and you need an out-of-tree kernel module that is not available "
"through |CL|. For a more scalable and customizable approach, we recommend"
" using :ref:`mixer` to provide a custom kernel and updates."
msgstr "如果您是个人用户或测试人员,并且您需要 |CL| 并未提供的树外内核模块,请按照本节中的步骤操作。如需使用可扩展性和可自定义性更好的方法,我们建议使用 :ref:`mixer` 来提供自定义内核和更新。"
#: ../../guides/kernel/kernel-modules-dkms.rst:113
msgid "Prerequisites"
msgstr "必备条件"
#: ../../guides/kernel/kernel-modules-dkms.rst:115
msgid "Before you begin, you must:"
msgstr "开始之前,您必须:"
#: ../../guides/kernel/kernel-modules-dkms.rst:117
msgid ""
"Disable Secure Boot in UEFI/BIOS. The loading of new out-of-tree modules "
"modifies the signatures that Secure Boot relies on for trust."
msgstr "在 UEFI/BIOS 中禁用安全引导。加载新的树外模块会修改安全引导所依赖的信任签名。"
#: ../../guides/kernel/kernel-modules-dkms.rst:120
msgid ""
"Obtain a kernel module package in the form of source code or pre-compiled"
" binaries."
msgstr "获取以源代码或预编译二进制形式存在的内核模块包。"
#: ../../guides/kernel/kernel-modules-dkms.rst:124
msgid "Obtain kernel module source"
msgstr "获取内核模块源代码"
#: ../../guides/kernel/kernel-modules-dkms.rst:126
msgid ""
"A required :file:`dkms.conf` file inside of the kernel module's source "
"code directory informs DKMS how the kernel module should be compiled."
msgstr "内核模块源代码目录中必需的 :file:`dkms.conf` 文件将指示 DKMS 应该如何编译内核模块。"
#: ../../guides/kernel/kernel-modules-dkms.rst:129
msgid "Kernel modules may come packaged as:"
msgstr "内核模块可以打包为:"
#: ../../guides/kernel/kernel-modules-dkms.rst:131
msgid "Source code without a :file:`dkms.conf` file"
msgstr "不含 :file:`dkms.conf` 文件的源代码"
#: ../../guides/kernel/kernel-modules-dkms.rst:132
msgid "Source code with a premade :file:`dkms.conf` file"
msgstr "含预制作的 :file:`dkms.conf` 文件的源代码"
#: ../../guides/kernel/kernel-modules-dkms.rst:133
msgid ""
"Source code with a premade :file:`dkms.conf` file and precompiled module "
"binaries"
msgstr "含预制作的 :file:`dkms.conf` 文件和预编译的模块二进制的源代码"
#: ../../guides/kernel/kernel-modules-dkms.rst:135
msgid "Precompiled module binaries only (without source code)"
msgstr "只有预编译的模块二进制(不含源代码)"
#: ../../guides/kernel/kernel-modules-dkms.rst:137
msgid ""
"Of the package types listed above, only precompiled kernel module "
"binaries will not work, because |CL| requires kernel modules to be built "
"against the same kernel source tree before they can be loaded. If you are"
" only able to obtain source code without a :file:`dkms.conf` file, you "
"must manually create a :file:`dkms.conf` file, described later in this "
"document."
msgstr "在上面列出的包类型中,只有预编译的内核模块二进制文件不起作用,因为 |CL| 要求在加载内核模块之前根据同一内核源代码树进行构建。如果只能获取不含 :file:`dkms.conf` 文件的源代码,则必须手动创建 :file:`dkms.conf` 文件,本文档稍后将对此进行介绍。"
#: ../../guides/kernel/kernel-modules-dkms.rst:143
msgid "Download the kernel module's source code."
msgstr "下载内核模块的源代码。"
#: ../../guides/kernel/kernel-modules-dkms.rst:145
msgid ""
"Review the available download options. Some kernel modules provide "
"separate archives that are specifically enabled for DKMS support."
msgstr "查看可用的下载选项。一些内核模块提供单独的归档文件来专门支持 DKMS。"
#: ../../guides/kernel/kernel-modules-dkms.rst:148
msgid ""
"Review the README documentation, because it often provides required "
"information to build the module with DKMS support."
msgstr "查看自述文件,因为它通常提供在支持 DKMS 的情况下构建模块所需的信息。"
#: ../../guides/kernel/kernel-modules-dkms.rst:159
msgid "Build kernel module with an existing dkms.conf"
msgstr "使用现有的 dkms.conf 构建内核模块"
#: ../../guides/kernel/kernel-modules-dkms.rst:161
msgid ""
"If the kernel module maintainer packaged the source archive with the "
":command:`dkms mktarball` command, the entire archive can be passed to "
"the :command:`dkms ldtarball` which completes many steps for you."
msgstr "如果内核模块维护者使用 :command:`dkms mktarball` 命令打包了源代码归档文件,则整个归档文件可以传递给 :command:`dkms ldtarball`,由后者来完成许多步骤。"
#: ../../guides/kernel/kernel-modules-dkms.rst:165
msgid ""
"The archive contains the required :file:`dkms.conf` file, and may contain"
" a :file:`dkms_source_tree` directory and a :file:`dkms_binaries_only` "
"directory."
msgstr "归档文件包含必需的 :file:`dkms.conf` 文件,并可能包含 :file:`dkms_source_tree` 目录和 :file:`dkms_binaries_only` 目录。"
#: ../../guides/kernel/kernel-modules-dkms.rst:169
msgid ""
"Run the :command:`dkms ldtarball` command against the kernel module "
"archive."
msgstr "对内核模块归档文件运行 :command:`dkms ldtarball` 命令。"
#: ../../guides/kernel/kernel-modules-dkms.rst:177
msgid ""
":command:`dkms ldtarball` places the kernel module source under "
":file:`/usr/src/<MODULE-NAME>-<MODULE-VERSION>/`, builds it if necessary,"
" and adds the module into the DKMS tree."
msgstr ":command:`dkms ldtarball` 会将内核模块源代码放在 :file:`/usr/src/<MODULE-NAME>-<MODULE-VERSION>/` 下,在必要时构建它,以及将模块添加到 DKMS 树。"
#: ../../guides/kernel/kernel-modules-dkms.rst:182
msgid ""
"Verify the kernel module is detected by checking the output of the "
":command:`dkms status` command."
msgstr "检查 :command:`dkms status` 命令的输出,确认已检测到的内核模块。"
#: ../../guides/kernel/kernel-modules-dkms.rst:190
msgid "Install the kernel module."
msgstr "安装内核模块。"
#: ../../guides/kernel/kernel-modules-dkms.rst:197
msgid "Build kernel module without an existing dkms.conf"
msgstr "在没有现成的 dkms.conf 的情况下构建内核模块"
#: ../../guides/kernel/kernel-modules-dkms.rst:199
msgid ""
"If the kernel module source does not contain a :file:`dkms.conf` file or "
"the :command:`dkms ldtarball` command encounters errors, you must "
"manually create the file."
msgstr "如果内核模块源代码中不含 :file:`dkms.conf` 文件或 :command:`dkms ldtarball` 命令遇到错误,则必须手动创建该文件。"
#: ../../guides/kernel/kernel-modules-dkms.rst:203
msgid ""
"Review the kernel module README documentation for guidance on what needs "
"to be in the :file:`dkms.conf` file, including special variables that may"
" be required to build successfully."
msgstr "查看内核模块自述文件,了解 :file:`dkms.conf` 文件中需要哪些内容,包括成功构建所需的特殊变量。"
#: ../../guides/kernel/kernel-modules-dkms.rst:207
msgid "Here are some additional resources that can be used for reference:"
msgstr "以下是一些可供参考的其他资源:"
#: ../../guides/kernel/kernel-modules-dkms.rst:209
msgid ""
"DKMS manual page (:command:`man dkms`) shows detailed syntax in the "
"DKMS.CONF section."
msgstr "DKMS 手册页 (:command:`man dkms`) 会显示 DKMS.CONF 部分的详细语法。"
#: ../../guides/kernel/kernel-modules-dkms.rst:212
msgid ""
"Ubuntu community wiki entry for the `Kernel DKMS Package`_ shows an "
"example where a single package contains multiple modules."
msgstr "`Kernel DKMS Package`_ 的 Ubuntu 社区 wiki 条目会显示单个包含有多个模块的示例。"
#: ../../guides/kernel/kernel-modules-dkms.rst:215
msgid "Sample `dkms.conf`_ file in the GitHub\\* repository for the DKMS project."
msgstr "DKMS 项目 GitHub\\* 存储库中的 `dkms.conf`_ file 示例文件。"
#: ../../guides/kernel/kernel-modules-dkms.rst:219
msgid ""
":command:`AUTOINSTALL=yes` must be set in the dkms.conf for the module to"
" be automatically recompiled with |CL| updates."
msgstr "对于要在 |CL| 更新时自动重新编译的模块,必须在 dkms.conf 中设置 :command:`AUTOINSTALL=yes`。"
#: ../../guides/kernel/kernel-modules-dkms.rst:222
msgid "The instructions below show a generic example:"
msgstr "以下说明介绍了一个通用示例:"
#: ../../guides/kernel/kernel-modules-dkms.rst:224
msgid ""
"Create or modify the :file:`dkms.conf` file inside of the extracted "
"source code directory."
msgstr "在提取的源代码目录中创建或修改 :file:`dkms.conf` 文件。"
#: ../../guides/kernel/kernel-modules-dkms.rst:240
msgid ""
"This example identifies a kernel module named *custom_module* with "
"version *1.0*."
msgstr "本示例中的内核模块名称为 *custom_module*,版本为 *1.0*。"
#: ../../guides/kernel/kernel-modules-dkms.rst:243
msgid "Copy the kernel module source code into the :file:`/usr/src/` directory."
msgstr "将内核模块源代码复制到 :file:`/usr/src/` 目录中。"
#: ../../guides/kernel/kernel-modules-dkms.rst:252
msgid ""
"*<PACKAGE_NAME>* and *<PACKAGE_VERSION>* must match the entries in the "
":file:`dkms.conf` file."
msgstr "*<PACKAGE_NAME>* 和 *<PACKAGE_VERSION>* 必须与 :file:`dkms.conf` 文件中的条目匹配。"
#: ../../guides/kernel/kernel-modules-dkms.rst:255
msgid "Add the kernel module to the DKMS tree so that it is tracked by DKMS."
msgstr "将内核模块添加到 DKMS 树中,以便由 DKMS 跟踪。"
#: ../../guides/kernel/kernel-modules-dkms.rst:261
msgid ""
"Build the kernel module using DKMS. If the build encounters errors, you "
"may need to edit the :file:`dkms.conf` file."
msgstr "使用 DKMS 构建内核模块。如果构建时遇到错误,您可能需要编辑 :file:`dkms.conf` 文件。"
#: ../../guides/kernel/kernel-modules-dkms.rst:268
msgid "Install the kernel module using DKMS."
msgstr "使用 DKMS 安装内核模块。"
#: ../../guides/kernel/kernel-modules-dkms.rst:275
msgid "Load kernel module"
msgstr "加载内核模块"
#: ../../guides/kernel/kernel-modules-dkms.rst:277
msgid ""
"By default, DKMS installs modules \"in-tree\" under :file:`/lib/modules` "
"so the :command:`modprobe` command can be used to load them."
msgstr "默认情况下,DKMS 会将模块 \"in-tree\" 安装在 :file:`/lib/modules` 下,以便可以使用 :command:`modprobe` 命令加载它们。"
#: ../../guides/kernel/kernel-modules-dkms.rst:280
msgid "Load the installed module with the :command:`modprobe` command."
msgstr "使用 :command:`modprobe` 命令加载已安装的模块。"
#: ../../guides/kernel/kernel-modules-dkms.rst:286
msgid "Validate the kernel module is loaded."
msgstr "验证内核模块是否已加载。"
#: ../../guides/kernel/kernel-modules-dkms.rst:293
msgid "Examples"
msgstr "示例"
#: ../../guides/kernel/kernel-modules.rst:4
msgid "Optional: Specify module options and aliases"
msgstr "可选:指定模块选项和别名"
#: ../../guides/kernel/kernel-modules.rst:6
msgid "Use the :command:`modprobe` command to load a module and set options."
msgstr "使用 :command:`modprobe` 命令加载模块并设置选项。"
#: ../../guides/kernel/kernel-modules.rst:8
msgid ""
":command:`modprobe` may add or remove more than one module due to module "
"interdependencies. You can specify which options to use with individual "
"modules, by using configuration files under the :file:`/etc/modprobe.d` "
"directory."
msgstr ":command:`modprobe` 可能会因为模块相互依赖关系添加或移除多个模块。您可以使用 :file:`/etc/modprobe.d` 目录下的配置文件来指定各个模块要使用的选项。"
#: ../../guides/kernel/kernel-modules.rst:16
msgid ""
"All files underneath the :file:`/etc/modprobe.d` directory that end with "
"the :file:`.conf` extension specify module options to use when loading. "
"You can use :file:`.conf` files to create convenient aliases for modules "
"or to override the normal loading behavior altogether for those with "
"special requirements."
msgstr ":file:`/etc/modprobe.d` 目录下以 :file:`.conf` 扩展名结尾的所有文件会指定加载时要使用的模块选项。您可以使用 :file:`.conf` 文件为模块创建方便使用的别名,或者为有特殊要求的模块完全覆盖正常的加载行为。"
#: ../../guides/kernel/kernel-modules.rst:21
msgid "Learn more about :command:`modprobe` on the modprobe.d manual page:"
msgstr "参阅 modprobe.d 手册页详细了解 :command:`modprobe`"
#: ../../guides/kernel/kernel-modules.rst:28
msgid "Optional: Configure kernel modules to load at boot"
msgstr "可选:配置引导时要加载的内核模块"
#: ../../guides/kernel/kernel-modules.rst:30
msgid ""
"Use the :file:`/etc/modules-load.d` configuration directory to specify "
"kernel modules to load automatically at boot."
msgstr "使用 :file:`/etc/modules-load.d` 配置目录指定引导时自动加载的内核模块。"
#: ../../guides/kernel/kernel-modules.rst:37
msgid ""
"All files underneath the :file:`/etc/modules-load.d` directory that end "
"with the :file:`.conf` extension contain a list of module names of "
"aliases (one per line) to load at boot."
msgstr ":file:`/etc/modules-load.d` 目录下以 :file:`.conf` 扩展名结尾的所有文件包含引导时要加载的模块别名列表(每行一个)。"
#: ../../guides/kernel/kernel-modules.rst:41
msgid "Learn more about module loading in the modules-load.d manual page:"
msgstr "参阅 modules-load.d 手册页详细了解模块加载:"
#: ../../guides/kernel/kernel-modules-dkms.rst:300
msgid "Related topics"
msgstr "相关主题"
#: ../../guides/kernel/kernel-modules-dkms.rst:302
msgid "`Dynamic Kernel Module System (DKMS)`_"
msgstr "`Dynamic Kernel Module System (DKMS)`_"
#: ../../guides/kernel/kernel-modules-dkms.rst:304
msgid ""
"`Dell Linux Engineering Dynamic Kernel Module Support: From Theory to "
"Practice "
"<https://www.kernel.org/doc/ols/2004/ols2004v1-pages-187-202.pdf>`_"
msgstr "`Dell Linux Engineering Dynamic Kernel Module Support: From Theory to Practice <https://www.kernel.org/doc/ols/2004/ols2004v1-pages-187-202.pdf>`_"
#: ../../guides/kernel/kernel-modules-dkms.rst:306
msgid ""
"`Linux Journal: Exploring Dynamic Kernel Module Support "
"<https://www.linuxjournal.com/article/6896>`_"
msgstr "`Linux Journal: Exploring Dynamic Kernel Module Support <https://www.linuxjournal.com/article/6896>`_"
#~ msgid "Make enhancement requests to the |CL| distribution `on GitHub`_."
#~ msgstr ""
#~ msgid ""
#~ "Follow the steps in this section "
#~ "if you are an individual user or"
#~ " testing, and you need an out-"
#~ "of-tree kernel module that is not "
#~ "available through |CL|. For a more "
#~ "scalable and customizable approach, we "
#~ "recommend using the `mixer tool`_ to "
#~ "provide a custom kernel and updates."
#~ msgstr ""
#~ msgid ""
#~ "`Ubuntu community wiki`_ shows an "
#~ "example where a single package contains"
#~ " multiple modules."
#~ msgstr ""
#~ msgid ""
#~ "`Sample dkms.conf file`_ in the "
#~ "GitHub\\* repository for the DKMS "
#~ "project."
#~ msgstr ""
#~ msgid ""
#~ "`Dynamic Kernel Module System (DKMS) "
#~ "project on GitHub <https://github.com/dell/dkms>`_"
#~ msgstr ""
#~ msgid ""
#~ "Make enhancement requests to the |CL|"
#~ " `Distribution Project "
#~ "<https://github.com/clearlinux/distribution>`_ on GitHub."
#~ msgstr ""
#~ msgid ""
#~ "The *kernel-native-dkms* bundle provides"
#~ " the :command:`dkms` program and Linux "
#~ "kernel headers, which are required for"
#~ " compiling kernel modules."
#~ msgstr ""
#~ msgid "The *kernel-native-dkms* bundle also:"
#~ msgstr ""
#~ msgid ""
#~ "Adds a systemd update trigger "
#~ "(:file:`/usr/lib/systemd/system/dkms-new-kernel.service`)"
#~ " to automatically run DKMS to rebuild"
#~ " modules after a kernel upgrade "
#~ "occurs with :ref:`swupd update <swupd-"
#~ "guide>`."
#~ msgstr ""
#~ msgid ""
#~ "Follow the steps in this section "
#~ "if you are an individual user or"
#~ " testing, and you need an out-"
#~ "of-tree kernel module that is not "
#~ "available through |CL|. For a more "
#~ "scalable and customizable approach, we "
#~ "recommend using the :ref:`mixer` tool to"
#~ " provide a custom kernel and updates."
#~ msgstr ""
#~ msgid ""
#~ "Obtain a kernel module package in "
#~ "the form of source code and/or "
#~ "precompiled binaries."
#~ msgstr ""
@@ -0,0 +1,302 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/kernel/kernel-modules.rst:4
msgid "Add kernel modules manually"
msgstr "手动添加内核模块"
#: ../../guides/kernel/kernel-modules.rst:6
msgid "This guide describes how to add kernel modules manually."
msgstr "本指南介绍如何手动添加内核模块。"
#: ../../guides/kernel/kernel-modules.rst:13
msgid "Overview"
msgstr "概述"
#: ../../guides/kernel/kernel-modules.rst:15
msgid ""
"Certain kernel modules are enabled by default in |CL-ATTR|. To use "
"additional kernel modules that are not part of the Linux source tree, you"
" may need to build out-of-tree kernel modules. Use this guide to add "
"kernel modules manually, or refer to :ref:`kernel-modules-dkms`."
msgstr "某些内核模块在 |CL-ATTR| 中默认启用。要使用不属于 Linux 源代码树的其他内核模块,您可能需要构建树外内核模块。请使用本指南手动添加内核模块,或参阅 :ref:`kernel-modules-dkms`。"
#: ../../guides/kernel/kernel-modules.rst:21
msgid "Description"
msgstr "描述"
#: ../../guides/kernel/kernel-modules.rst:23
msgid ""
"Kernel modules are additional pieces of software capable of being "
"inserted into the Linux kernel to add functionality, such as a hardware "
"driver. Kernel modules may already be part of the Linux source tree (in-"
"tree) or may come from an external source, such as directly from a vendor"
" (out-of-tree)."
msgstr "内核模块是能够插入到 Linux 内核中以增加功能的附加软件,例如硬件驱动程序。内核模块可能已经是 Linux 源代码树的一部分(树内),也可能来自外部来源,例如直接来自供应商(树外)。"
#: ../../guides/kernel/kernel-modules.rst:32
msgid "Kernel module availability"
msgstr "内核模块可用性"
#: ../../guides/kernel/kernel-modules.rst:34
msgid ""
"|CL| comes with many upstream kernel modules available for use. Using an "
"existing module is significantly easier to maintain and retains signature"
" verification of the |CL| kernel. For more information on |CL| security "
"practices, see the :ref:`security` page."
msgstr "|CL| 附带了许多上游内核模块以备使用。使用现有模块时,维护和保留 |CL| 内核的签名验证要容易得多。有关 |CL| 安全实践的更多信息,请参阅 :ref:`security` 页面。"
#: ../../guides/kernel/kernel-modules.rst:39
msgid ""
"Before continuing, check if the kernel module you're looking for is "
"already available in |CL| or submit a request to add the module."
msgstr "继续之前,请检查您正在寻找的内核模块是否已经在 |CL| 中可用,或者提交添加该模块的请求。"
#: ../../guides/kernel/kernel-modules.rst:44
msgid "Check if the module is already available"
msgstr "检查模块是否已经可用"
#: ../../guides/kernel/kernel-modules.rst:47
msgid ""
"You can search for kernel module file names, which end with the "
":file:`.ko` file extension, using the :command:`swupd search` command, as"
" shown in the following example. See :ref:`swupd-guide` for more "
"information."
msgstr "您可以使用 :command:`swupd search` 命令搜索以 :file:`.ko` 文件扩展名结尾的内核模块文件名,如下例所示。有关详细信息,请参阅 :ref:`swupd-guide`。"
#: ../../guides/kernel/kernel-modules.rst:57
msgid "Submit a request to add the module"
msgstr "提交添加模块的请求"
#: ../../guides/kernel/kernel-modules.rst:59
msgid ""
"If the kernel module you need is already open source (for example, in the"
" Linux upstream) and likely to be useful to others, consider submitting a"
" request to add or enable it in the |CL| kernel."
msgstr "如果您需要的内核模块已经开源(例如在 Linux 上游),并且可能对其他人也有用,可考虑提交在 |CL| 内核中添加或启用该模块的请求。"
#: ../../guides/kernel/kernel-modules.rst:63
msgid "Make enhancement requests to the |CL| 'Distribution Project'_ on GitHub."
msgstr "向 GitHub 上的 |CL| 'Distribution Project'_ 提出增强请求。"
#: ../../guides/kernel/kernel-modules.rst:69
msgid "Build, install, and load an out-of-tree module"
msgstr "构建、安装和加载树外模块"
#: ../../guides/kernel/kernel-modules.rst:71
msgid ""
"Follow the steps in this section if you are an individual user or "
"testing, and you need an out-of-tree kernel module that is not available "
"through |CL|. For a more scalable and customizable approach, we recommend"
" using the :ref:`mixer` to provide a custom kernel and updates."
msgstr "如果您是个人用户或测试人员,并且您需要 |CL| 并未提供的树外内核模块,请按照本节中的步骤操作。如需使用可扩展性和可自定义性更好的方法,我们建议使用 :ref:`mixer` 来提供自定义内核和更新。"
#: ../../guides/kernel/kernel-modules.rst:78
msgid "Prerequisites"
msgstr "必备条件"
#: ../../guides/kernel/kernel-modules.rst:80
msgid "Before you begin, you must:"
msgstr "开始之前,您必须:"
#: ../../guides/kernel/kernel-modules.rst:82
msgid "Disable Secure Boot."
msgstr "禁用安全引导。"
#: ../../guides/kernel/kernel-modules.rst:83
msgid "Disable kernel module integrity checking."
msgstr "禁用内核模块完整性检查。"
#: ../../guides/kernel/kernel-modules.rst:84
msgid "Have a kernel module package in the form of source code."
msgstr "有一个以源代码形式存在的内核模块包。"
#: ../../guides/kernel/kernel-modules.rst:85
msgid "Rebuild the module against new versions of the Linux kernel."
msgstr "针对新版本 Linux 内核重新构建模块。"
#: ../../guides/kernel/kernel-modules.rst:89
msgid ""
"Any time the kernel is upgraded on your Clear Linux system, you must "
"rebuild your out-of-tree modules."
msgstr "每当在 Clear Linux 系统上升级内核时,您都必须重新构建树外模块。"
#: ../../guides/kernel/kernel-modules.rst:94
msgid "Build and install kernel module"
msgstr "构建和安装内核模块"
#: ../../guides/kernel/kernel-modules.rst:96
msgid ""
"Determine which kernel variant is running on |CL|. In the example below, "
"the *native* kernel is in use."
msgstr "确定 |CL| 上正在运行的内核变体。下面的示例中使用了原生内核。"
#: ../../guides/kernel/kernel-modules.rst:104
msgid ""
"Install the kernel dev bundle corresponding to the installed kernel. The "
"kernel dev bundle contains the kernel headers, which are required for "
"compiling kernel modules. For example:"
msgstr "安装与已安装内核相对应的内核开发捆绑包。内核开发捆绑包含编译内核模块所需的内核头文件。例如:"
#: ../../guides/kernel/kernel-modules.rst:108
msgid ":command:`linux-dev` for developing against the native kernel."
msgstr ":command:`linux-dev` 用于针对原生内核进行开发。"
#: ../../guides/kernel/kernel-modules.rst:109
msgid ":command:`linux-lts-dev` for developing against the LTS kernel."
msgstr ":command:`linux-lts-dev` 用于针对 LTS 内核进行开发。"
#: ../../guides/kernel/kernel-modules.rst:115
msgid ""
"Follow instructions from the kernel module source code to compile the "
"kernel module. For example:"
msgstr "按照内核模块源代码中的说明编译内核模块。例如:"
#: ../../guides/kernel/kernel-modules.rst:128
msgid "Load kernel module"
msgstr "加载内核模块"
#: ../../guides/kernel/kernel-modules.rst:130
msgid ""
"Disable Secure Boot in your system's UEFI settings, if you have enabled "
"it. The loading of new out-of-tree modules modifies the signatures that "
"Secure Boot relies on for trust."
msgstr "如果安全引导已启用,请在系统的 UEFI 设置中禁用安全引导。加载新的树外模块会修改安全引导所依赖的信任签名。"
#: ../../guides/kernel/kernel-modules.rst:134
msgid ""
"Disable signature checking for the kernel by modifying the kernel boot "
"parameters and reboot the system."
msgstr "修改内核引导参数禁用内核签名检查,然后重启系统。"
#: ../../guides/kernel/kernel-modules.rst:137
msgid ""
"All kernel modules from |CL| have been signed to enforce kernel security."
" However, out-of-tree modules break this chain of trust so this mechanism"
" needs to be disabled."
msgstr "|CL| 中的所有内核模块都已签名以加强内核安全。但是,树外模块打破了信任链,因此需要禁用该机制。"
#: ../../guides/kernel/kernel-modules.rst:146
msgid ""
"Update the boot manager and reboot the system to implement the changed "
"kernel parameters."
msgstr "更新引导管理器并重启系统,以实现修改后的内核参数。"
#: ../../guides/kernel/kernel-modules.rst:156
msgid ""
"If successful, the :command:`clr-boot-manager update` command does not "
"return any console output."
msgstr "如果修改成功,:command:`clr-boot-manager update` 命令不会返回任何控制台输出。"
#: ../../guides/kernel/kernel-modules.rst:159
msgid ""
"After rebooting, manually load out-of-tree modules using the "
":command:`insmod` command."
msgstr "重启后,使用 :command:`insmod` 命令手动加载树外模块。"
#: ../../guides/kernel/kernel-modules.rst:167
msgid "Examples"
msgstr "示例"
#: ../../guides/kernel/kernel-modules.rst:172
msgid "Optional: Specify module options and aliases"
msgstr "可选:指定模块选项和别名"
#: ../../guides/kernel/kernel-modules.rst:174
msgid "Use the :command:`modprobe` command to load a module and set options."
msgstr "使用 :command:`modprobe` 命令加载模块并设置选项。"
#: ../../guides/kernel/kernel-modules.rst:176
msgid ""
":command:`modprobe` may add or remove more than one module due to module "
"interdependencies. You can specify which options to use with individual "
"modules, by using configuration files under the :file:`/etc/modprobe.d` "
"directory."
msgstr ":command:`modprobe` 可能会因为模块相互依赖关系添加或移除多个模块。您可以使用 :file:`/etc/modprobe.d` 目录下的配置文件来指定各个模块要使用的选项。"
#: ../../guides/kernel/kernel-modules.rst:184
msgid ""
"All files underneath the :file:`/etc/modprobe.d` directory that end with "
"the :file:`.conf` extension specify module options to use when loading. "
"You can use :file:`.conf` files to create convenient aliases for modules "
"or to override the normal loading behavior altogether for those with "
"special requirements."
msgstr ":file:`/etc/modprobe.d` 目录下以 :file:`.conf` 扩展名结尾的所有文件会指定加载时要使用的模块选项。您可以使用 :file:`.conf` 文件为模块创建方便使用的别名,或者为有特殊要求的模块完全覆盖正常的加载行为。"
#: ../../guides/kernel/kernel-modules.rst:189
msgid "Learn more about :command:`modprobe` on the modprobe.d manual page:"
msgstr "参阅 modprobe.d 手册页详细了解 :command:`modprobe`"
#: ../../guides/kernel/kernel-modules.rst:196
msgid "Optional: Configure kernel modules to load at boot"
msgstr "可选:配置引导时要加载的内核模块"
#: ../../guides/kernel/kernel-modules.rst:198
msgid ""
"Use the :file:`/etc/modules-load.d` configuration directory to specify "
"kernel modules to load automatically at boot."
msgstr "使用 :file:`/etc/modules-load.d` 配置目录指定引导时自动加载的内核模块。"
#: ../../guides/kernel/kernel-modules.rst:205
msgid ""
"All files underneath the :file:`/etc/modules-load.d` directory that end "
"with the :file:`.conf` extension contain a list of module names of "
"aliases (one per line) to load at boot."
msgstr ":file:`/etc/modules-load.d` 目录下以 :file:`.conf` 扩展名结尾的所有文件包含引导时要加载的模块别名列表(每行一个)。"
#: ../../guides/kernel/kernel-modules.rst:209
msgid "Learn more about module loading in the modules-load.d manual page:"
msgstr "参阅 modules-load.d 手册页详细了解模块加载:"
#: ../../guides/kernel/kernel-modules.rst:219
msgid "Related topic"
msgstr "相关主题"
#: ../../guides/kernel/kernel-modules.rst:221
msgid ":ref:`kernel-modules-dkms`"
msgstr ":ref:`kernel-modules-dkms`"
#~ msgid "Make enhancement requests to the |CL| distribution `on GitHub`_."
#~ msgstr ""
#~ msgid ""
#~ "Follow the steps in this section "
#~ "if you are an individual user or"
#~ " testing, and you need an out-"
#~ "of-tree kernel module that is not "
#~ "available through |CL|. For a more "
#~ "scalable and customizable approach, we "
#~ "recommend using the `mixer tool`_ to "
#~ "provide a custom kernel and updates."
#~ msgstr ""
#~ msgid ""
#~ "Make enhancement requests to the |CL|"
#~ " `Distribution Project "
#~ "<https://github.com/clearlinux/distribution>`_ on GitHub."
#~ msgstr ""
#~ msgid "`linux-dev` for developing against the native kernel."
#~ msgstr ""
#~ msgid "`linux-lts-dev` for developing against the LTS kernel."
#~ msgstr ""
@@ -0,0 +1,208 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/maintenance/architect-lifecycle.rst:4
msgid "Architect the life-cycle of |CL-ATTR|"
msgstr "设计 |CL-ATTR| 生命周期"
#: ../../guides/maintenance/architect-lifecycle.rst:6
msgid ""
"This guide describes the basic, recommended infrastructure and workflow "
"for maintaining a |CL-ATTR| derivative."
msgstr "本指南介绍了推荐的基本基础设施以及维护 |CL-ATTR| 衍生版的工作流程。"
#: ../../guides/maintenance/architect-lifecycle.rst:14
msgid "Prerequisites"
msgstr "必备条件"
#: ../../guides/maintenance/architect-lifecycle.rst:16
msgid ""
"A repository with software RPM artifacts and a CI/CD system with a |CL| "
"machine for building `mixes`"
msgstr "一个包含软件 RPM 对象的存储库,以及一个含有 |CL| 计算机的 CI/CD 系统,用于构建 `mixes`"
#: ../../guides/maintenance/architect-lifecycle.rst:19
msgid "Experience using :ref:`mixer <mixer>` to create a |CL|-based distro"
msgstr "具备使用 :ref:`mixer <mixer>` 创建基于 |CL| 的发行版的经验"
#: ../../guides/maintenance/architect-lifecycle.rst:21
msgid ""
"Experience using :ref:`swupd <swupd-guide>` for maintaining the |CL| "
"build environment"
msgstr "具备使用 :ref:`swupd <swupd-guide>` 维护 |CL| 构建环境的经验"
#: ../../guides/maintenance/architect-lifecycle.rst:24
msgid "Familiarity with |CL| architecture and reuse of its content in releases"
msgstr "熟悉 |CL| 架构,以及如何在不同版本中重复使用其内容"
#: ../../guides/maintenance/architect-lifecycle.rst:27
msgid "Description"
msgstr "描述"
#: ../../guides/maintenance/architect-lifecycle.rst:29
msgid "Maintaining a |CL| derivative requires:"
msgstr "维护 |CL| 衍生版需要:"
#: ../../guides/maintenance/architect-lifecycle.rst:31
msgid "Monitoring upstream |CL| for new releases"
msgstr "监控上游 |CL| 新版本"
#: ../../guides/maintenance/architect-lifecycle.rst:32
msgid "Building software packages and staging"
msgstr "构建软件包和模拟环境"
#: ../../guides/maintenance/architect-lifecycle.rst:33
msgid "Employing CI/CD automation for building releases"
msgstr "采用 CI/CD 自动化来构建版本"
#: ../../guides/maintenance/architect-lifecycle.rst:34
msgid "Integrating Quality Assurance for testing and validation"
msgstr "集成质量保证以开展测试和验证"
#: ../../guides/maintenance/architect-lifecycle.rst:36
msgid ""
"Coordinated infrastructure is deployed to automate the life-cycle of your"
" |CL| derivative. We divide deployment of this infrastucture in two "
"parts: *Content Workflow*; and *Release Workflow*, shown in Figure 1."
msgstr "部署协调基础设施,将 |CL| 衍生版的生命周期自动化。我们将该基础设施的部署分为两部分,即内容工作流程*和*版本工作流程,如图 1 所示。"
#: ../../guides/maintenance/architect-lifecycle.rst:44
msgid "Figure 1: Architect the life-cycle"
msgstr "图 1:设计生命周期"
#: ../../guides/maintenance/architect-lifecycle.rst:47
msgid "Content Workflow"
msgstr "内容工作流程"
#: ../../guides/maintenance/architect-lifecycle.rst:49
msgid ""
"The Content Workflow (Figure 1) orchestrates the processes used to manage"
" the creation of content for the distribution. This includes everything "
"from detecting a new release in a custom software repository to "
"generating RPM package files. The RPM files serve as intermediary "
"artifacts that track software dependencies and provide file-level data "
"consumed in a Release Workflow. The `Watcher Pipeline`_ checks |CL| and "
"a content provider, such as Koji, to determine if a new release is "
"necessary."
msgstr "内容工作流程(图 1)编排用于管理分发内容创建的各个流程。这包括从在自定义软件库中检测新版本到生成 RPM 包文件在内的一切工作。RPM 文件充当中间对象,负责跟踪各个软件依赖项,并提供版本工作流程中使用的文件级数据。`Watcher Pipeline`_ 检查 |CL| 和内容提供商,如 Koji,以确定是否需要新版本。"
#: ../../guides/maintenance/architect-lifecycle.rst:58
msgid "Release Workflow"
msgstr "版本工作流程"
#: ../../guides/maintenance/architect-lifecycle.rst:60
msgid ""
"The Release Workflow (Figure 1) gathers the content of the RPMs and "
"ensures it can be consumed by :ref:`mixer <mixer>`. A content web server "
"hosts the |CL| derivative, to which targets connect for updating their "
"OSes. As an integral part of this toolchain, the `Release Pipeline`_ "
"enables these derivatives to incorporate |CL| content into their own "
"custom content. The Watcher Pipeline triggers the Release Pipeline to "
"create new releases."
msgstr "版本工作流程(图 1)收集 RPM 的内容,并确保其可由 :ref:`mixer <mixer>` 使用。内容 Web 服务器托管 |CL| 衍生版,目标系统会连接到该服务器来更新它们的操作系统。作为该工具链的组成部分,`Release Pipeline`_ 允许这些衍生版将 |CL| 内容整合到自己的自定义内容中。Watcher Pipeline 会触发 Release Pipeline 创建新版本。"
#: ../../guides/maintenance/architect-lifecycle.rst:69
msgid "Implementation"
msgstr "实施"
#: ../../guides/maintenance/architect-lifecycle.rst:71
msgid ""
"The |CL| Distro Factory manages the Release Workflow. For detailed "
"information about Distro Factory deployment, refer to the `clr-distro-"
"factory`_ GitHub\\* repo."
msgstr "|CL| 发行版工厂管理版本工作流程。有关发行版工厂部署的详细信息,请参阅 `clr-distro-factory`_ GitHub\\* 存储库。"
#~ msgid ""
#~ "Distro factory implements the *Release "
#~ "workflow*. To get started on a "
#~ "full implementation, visit |CL| `Distro "
#~ "factory documentation`_."
#~ msgstr ""
#~ msgid ""
#~ "This guide provides DevOps with a "
#~ "model to architect the life-cycle "
#~ "of a |CL| derivative that integrates "
#~ "custom software and content using "
#~ "distinct workflows."
#~ msgstr ""
#~ msgid "This guide provides the foundation of the recommended infrastructure."
#~ msgstr ""
#~ msgid ""
#~ "Coordinated infrastructure is deployed to "
#~ "automate the life-cycle of your "
#~ "|CL| derivative. We divide deployment of"
#~ " this infrastucture in two parts: "
#~ "*Content Workflow*; and *Release Workflow*,"
#~ " shown in Figure 1. Distro Factory"
#~ " manages the *Release Workflow* while "
#~ "capturing the requirements for maintaining "
#~ "a long-term release cadence."
#~ msgstr ""
#~ msgid "Content workflow"
#~ msgstr ""
#~ msgid ""
#~ "The *Content Workflow* (Figure 1) "
#~ "orchestrates the processes used to "
#~ "manage the creation of content for "
#~ "the distribution. This includes everything "
#~ "from detecting a new release in a"
#~ " custom software repository to generating"
#~ " RPM package files. The RPM files "
#~ "serve as intermediary artifacts that "
#~ "track software dependencies and provide "
#~ "file-level data consumed in a "
#~ "*Release Workflow*. The `Watcher Pipeline`_"
#~ " checks |CL| and a content provider,"
#~ " such as Koji, to determine if "
#~ "a new release is necessary."
#~ msgstr ""
#~ msgid "Release workflow"
#~ msgstr ""
#~ msgid ""
#~ "The *Release Workflow* (Figure 1) "
#~ "gathers the content of the RPMs "
#~ "and ensures it can be consumed by"
#~ " :ref:`mixer <mixer>`. A content web "
#~ "server hosts the |CL| derivative, to "
#~ "which targets connect for updating their"
#~ " OSes. As an integral part of "
#~ "this toolchain, the *Release Pipeline* "
#~ "enables these derivatives to incorporate "
#~ "|CL| content into their own custom "
#~ "content. The *Watcher Pipeline* triggers "
#~ "the `Release Pipeline`_ to create new"
#~ " releases."
#~ msgstr ""
#~ msgid ""
#~ "Distro factory implements the *Release "
#~ "workflow*. To get started on a "
#~ "full implementation, visit |CL| `Distro "
#~ "Factory`_ documentation."
#~ msgstr ""
@@ -0,0 +1,319 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/maintenance/assign-static-ip.rst:4
msgid "Assign a static IP address"
msgstr "分配静态 IP 地址"
#: ../../guides/maintenance/assign-static-ip.rst:7
msgid ""
"This guide explains how to assign a static IP address. This may be "
"helpful in scenarios such as a network with no DHCP server."
msgstr "本指南介绍如何分配静态 IP 地址。在网络中并无 DHCP 服务器等情况下,此举可能会有帮助。"
#: ../../guides/maintenance/assign-static-ip.rst:15
msgid "Identify which program is managing the interface"
msgstr "确定哪个程序正在管理接口"
#: ../../guides/maintenance/assign-static-ip.rst:17
msgid ""
"New installations of |CL-ATTR| use NetworkManager as the default network "
"interface manager for all network connections."
msgstr "全新安装的 |CL-ATTR| 使用 NetworkManager 作为所有网络连接的默认网络接口管理器。"
#: ../../guides/maintenance/assign-static-ip.rst:22
msgid ""
"The cloud |CL| images continue to use `systemd-networkd` to manage "
"network connections."
msgstr "云 |CL| 映像继续使用 `systemd-networkd` 来管理网络连接。"
#: ../../guides/maintenance/assign-static-ip.rst:25
msgid ""
"In earlier |CL| versions, `systemd-network` was used to manage Ethernet "
"interfaces and NetworkManager was used for wireless interfaces."
msgstr "在较早的 |CL| 版本中,`systemd-network` 用于管理以太网接口,而 NetworkManager 用于管理无线接口。"
#: ../../guides/maintenance/assign-static-ip.rst:29
msgid ""
"Before defining a configuration for assigning a static IP address, verify"
" which program is managing the network interface."
msgstr "定义分配静态 IP 地址的配置之前,请确认哪个程序正在管理网络接口。"
#: ../../guides/maintenance/assign-static-ip.rst:32
msgid ""
"Check the output of :command:`nmcli device` to see if NetworkManager is "
"managing the device."
msgstr "检查 :command:`nmcli device` 的输出,确认 NetworkManager 是否正在管理设备。"
#: ../../guides/maintenance/assign-static-ip.rst:39
msgid ""
"If the STATE column for the device shows *connected* or *disconnected*, "
"the network configuration is being managed by NetworkManager, then use "
"the instructions for :ref:`using NetworkManager <nm-static-ip>`."
msgstr "如果设备的 STATE 列显示 *connected* 或 *disconnected*,则网络配置由 NetworkManager 管理,此时请按照 :ref:`使用 NetworkManager <nm-static-ip>` 中的说明执行操作。"
#: ../../guides/maintenance/assign-static-ip.rst:43
msgid ""
"If the STATE column for the device shows *unmanaged*, then check if the "
"device is being managed by systemd-networkd."
msgstr "如果设备的 STATE 列显示 *unmanaged*,则检查设备是否由 systemd-networkd 管理。"
#: ../../guides/maintenance/assign-static-ip.rst:47
msgid ""
"Check the output of :command:`networkctl list` to see if `systemd-"
"networkd` is managing the device."
msgstr "检查 :command:`networkctl list` 的输出,确认 `systemd-networkd` 是否正在管理设备。"
#: ../../guides/maintenance/assign-static-ip.rst:54
msgid ""
"If the SETUP column for the device shows *configured*, the network "
"configuration is being managed by `systemd-networkd`, then use the "
"instructions for :ref:`using systemd-networkd <networkd-static-ip>`."
msgstr "如果设备的 SETUP 列显示 *configured*,则网络配置由 `systemd-networkd` 管理,此时请按照 :ref:`使用 systemd-networkd <networkd-static-ip>` 中的说明执行操作。"
#: ../../guides/maintenance/assign-static-ip.rst:62
msgid "Using NetworkManager"
msgstr "使用 NetworkManager"
#: ../../guides/maintenance/assign-static-ip.rst:64
msgid ""
"Network connections managed by NetworkManager are stored as files with "
"the :file:`.nmconnection` file extension in the "
":file:`/etc/NetworkManager/system-connections/` directory."
msgstr "由 NetworkManager 管理的网络连接在 :file:`/etc/NetworkManager/system-connections/` 目录中存储为扩展名为 :file:`.nmconnection` 的文件。"
#: ../../guides/maintenance/assign-static-ip.rst:68
msgid ""
"A few tools exists to aid to manipulate network connections managed by "
"NetworkManager:"
msgstr "有些工具可协助处理由 NetworkManager 管理的网络连接:"
#: ../../guides/maintenance/assign-static-ip.rst:71
msgid "nmcli - a command-line tool"
msgstr "nmcli - 命令行工具"
#: ../../guides/maintenance/assign-static-ip.rst:73
msgid ""
"nmtui - a text user interface that provides a pseudo graphical menu in "
"the terminal"
msgstr "nmtui - 在终端中提供伪图形菜单的文本用户界面"
#: ../../guides/maintenance/assign-static-ip.rst:76
msgid "nm-connection-editor - a graphical user interface"
msgstr "nm-connection-editor - 图形用户界面"
#: ../../guides/maintenance/assign-static-ip.rst:78
msgid ""
"The method below uses the command line tool nmcli to modify network "
"connection."
msgstr "下面的方法使用命令行工具 nmcli 修改网络连接。"
#: ../../guides/maintenance/assign-static-ip.rst:82
msgid "Identify the existing connection name:"
msgstr "找出现有的连接名称:"
#: ../../guides/maintenance/assign-static-ip.rst:88
msgid "Sample output:"
msgstr "示例输出:"
#: ../../guides/maintenance/assign-static-ip.rst:95
msgid ""
"If a connection does not exist, create it with the :command:`nmcli "
"connection add` command."
msgstr "如果不存在连接,请使用 :command:`nmcli connection add` 命令创建一个连接。"
#: ../../guides/maintenance/assign-static-ip.rst:99
msgid ""
"Modify the connection to use a static IP address. Replace the variables "
"in brackets with the appropriate values. Replace *[CONNECTION_NAME]* with"
" the NAME from the command above."
msgstr "修改连接以使用静态 IP 地址。使用合适的值替换括号中的变量。将 *[CONNECTION_NAME]* 替换为上面命令中的 NAME。"
#: ../../guides/maintenance/assign-static-ip.rst:112
msgid ""
"See the `nmcli developer page "
"<https://developer.gnome.org/NetworkManager/stable/nmcli.html>`_ for more"
" configuration options. For advanced configurations, the "
":file:`/etc/NetworkManager/system-connections/*.nmconnection`. can be "
"edited directly."
msgstr "有关更多配置选项,请参阅 `nmcli developer page <https://developer.gnome.org/NetworkManager/stable/nmcli.html>`_。执行高级配置时,可以直接编辑 :file:`/etc/NetworkManager/system-connections/*.nmconnection`。"
#: ../../guides/maintenance/assign-static-ip.rst:118
msgid "Restart the NetworkManager server to reload the DNS servers:"
msgstr "重启 NetworkManager 服务器以重新加载 DNS 服务器:"
#: ../../guides/maintenance/assign-static-ip.rst:125
#: ../../guides/maintenance/assign-static-ip.rst:179
msgid "Verify your static IP address details have been set:"
msgstr "确认静态 IP 地址详细信息是否已设置:"
#: ../../guides/maintenance/assign-static-ip.rst:136
msgid "Using systemd-networkd"
msgstr "使用 systemd-networkd"
#: ../../guides/maintenance/assign-static-ip.rst:138
msgid ""
"Network connections managed by systemd-networkd are stored as files with "
"the :file:`.network` file extension the :file:`/etc/systemd/network/` "
"directory."
msgstr "由 systemd-networkd 管理的网络连接在 :file:`/etc/systemd/network/` 目录中存储为扩展名为 :file:`.network` 的文件。"
#: ../../guides/maintenance/assign-static-ip.rst:141
msgid ""
"Files to manipulate network connections managed by systemd-networkd must "
"be created manually."
msgstr "用来处理由 systemd-networkd 管理的网络连接的文件必须手动创建。"
#: ../../guides/maintenance/assign-static-ip.rst:144
msgid ""
"Create the :file:`/etc/systemd/network` directory if it does not already "
"exist:"
msgstr "如果 :file:`/etc/systemd/network` 目录尚不存在,请创建该目录:"
#: ../../guides/maintenance/assign-static-ip.rst:150
msgid ""
"Create a :file:`.network` file and add the following content. Replace the"
" variables in brackets with the appropriate values. Replace "
"*[INTERFACE_NAME]* with LINK from the output of the :command:`networkctl "
"list` command that was run previously."
msgstr "创建一个 :file:`.network` 文件并添加以下内容。使用合适的值替换括号中的变量。将 *[INTERFACE_NAME]* 替换为之前运行的 :command:`networkctl list` 命令输出中的 LINK。"
#: ../../guides/maintenance/assign-static-ip.rst:168
msgid ""
"See the `systemd-network man page "
"<https://www.freedesktop.org/software/systemd/man/systemd.network.html>`_"
" for more configuration options."
msgstr "有关更多配置选项,请参阅 `systemd-network man page <https://www.freedesktop.org/software/systemd/man/systemd.network.html>`_。"
#: ../../guides/maintenance/assign-static-ip.rst:172
msgid "Restart the `systemd-networkd` service:"
msgstr "重启 `systemd-networkd` 服务:"
#~ msgid ""
#~ "By default, your |CL-ATTR| system "
#~ "automatically gets an IP address from"
#~ " your network via DHCP. If you "
#~ "do not have a DHCP server on "
#~ "your network or simply want to use"
#~ " a static IP address, follow the "
#~ "steps in this guide."
#~ msgstr ""
#~ msgid ""
#~ "New installations of |CL| use "
#~ "NetworkManager as the default network "
#~ "interface manager for all network "
#~ "connections."
#~ msgstr ""
#~ msgid ""
#~ "The *cloud* |CL| images continue to "
#~ "use systemd-networkd to manage network"
#~ " connections."
#~ msgstr ""
#~ msgid ""
#~ "In earlier |CL| versions, systemd-"
#~ "network was used to manage Ethernet "
#~ "interfaces and NetworkManager was used "
#~ "for wireless interfaces."
#~ msgstr ""
#~ msgid ""
#~ "Before defining a configuration for "
#~ "assigning a static IP address, you "
#~ "should verify which program is managing"
#~ " the network interface."
#~ msgstr ""
#~ msgid ""
#~ "If the STATE column for the device"
#~ " shows *connected* or *disconnected*, the"
#~ " network configuration is being managed "
#~ "by NetworkManager and the instructions "
#~ "for :ref:`using NetworkManager <nm-static-"
#~ "ip>` should be used."
#~ msgstr ""
#~ msgid ""
#~ "If the STATE column for the device"
#~ " shows *unmanaged*, check to see if"
#~ " the device is being managed by "
#~ "systemd-networkd"
#~ msgstr ""
#~ msgid ""
#~ "Check the output of :command:`networkctl "
#~ "list` to see if systemd-networkd "
#~ "is managing the device."
#~ msgstr ""
#~ msgid ""
#~ "If the SETUP column for the device"
#~ " shows *configured*, the network "
#~ "configuration is being managed by "
#~ "systemd-networkd and the instructions for"
#~ " :ref:`using systemd-networkd <networkd-"
#~ "static-ip>` should be used."
#~ msgstr ""
#~ msgid ""
#~ "The method below uses the command "
#~ "line tool *nmcli* to modify network "
#~ "connection."
#~ msgstr ""
#~ msgid "The output will look like this:"
#~ msgstr ""
#~ msgid ""
#~ "If a connection does not exist, it"
#~ " will need to be created with "
#~ ":command:`nmcli connection add`."
#~ msgstr ""
#~ msgid ""
#~ "Modify the connection to use a "
#~ "static IP address. Replace the variables"
#~ " in brackets with the appropriate "
#~ "values. *[CONNECTION_NAME]* should be replaced"
#~ " with the NAME from the command "
#~ "above."
#~ msgstr ""
#~ msgid ""
#~ "Create the :file:`/etc/systemd/network` directory"
#~ " if it doesn't exist already:"
#~ msgstr ""
#~ msgid ""
#~ "Create a :file:`.network` file and add"
#~ " the following content. Replace the "
#~ "variables in brackets with the "
#~ "appropriate values. *[INTERFACE_NAME]* should "
#~ "be replaced with LINK from the "
#~ "output of :command:`networkctl list` ran "
#~ "previously."
#~ msgstr ""
#~ msgid "Restart the systemd-networkd service:"
#~ msgstr ""
@@ -0,0 +1,364 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-05 12:07-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../guides/maintenance/bulk-provision.rst:4
msgid "Bulk provision"
msgstr "批量供应"
#: ../../guides/maintenance/bulk-provision.rst:6
msgid ""
"This guide explains how to perform a bulk provision of |CL-ATTR| using a "
"combination of the |CL| installer, Ister, and :abbr:`ICIS (Ister Cloud "
"Init Service)`."
msgstr "本指南介绍如何组合使用 |CL| 安装程序、Ister 和 :abbr:`ICIS (Ister Cloud Init Service)` 来批量供应 |CL-ATTR|。"
#: ../../guides/maintenance/bulk-provision.rst:15
msgid "Overview"
msgstr "概述"
#: ../../guides/maintenance/bulk-provision.rst:17
msgid "To configure a bulk provision:"
msgstr "要配置批量供应,请执行以下操作:"
#: ../../guides/maintenance/bulk-provision.rst:19
msgid "Define Ister configuration files to customize the installation process"
msgstr "定义 Ister 配置文件以自定义安装过程"
#: ../../guides/maintenance/bulk-provision.rst:20
msgid "Define cloud-init\\* files to customize the installation instance"
msgstr "定义 cloud-init\\* 文件以自定义安装实例"
#: ../../guides/maintenance/bulk-provision.rst:21
msgid ""
"Host the configuration files in ICIS to allow Ister to use them during "
"the installation"
msgstr "在 ICIS 中托管配置文件,以便 Ister 在安装过程中使用它们"
#: ../../guides/maintenance/bulk-provision.rst:24
msgid ""
"Figure 1 depicts the flow of information between a PXE server and a PXE "
"client that needs to be set up to perform a bulk provision."
msgstr "图 1 描述了为执行批量供应而需要设置的 PXE 服务器和 PXE 客户端之间的信息流。"
#: ../../guides/maintenance/bulk-provision.rst:30
msgid "Figure 1: Bulk provision information flow"
msgstr "图 1:批量供应信息流"
#: ../../guides/maintenance/bulk-provision.rst:33
msgid "Prerequisites"
msgstr "必备条件"
#: ../../guides/maintenance/bulk-provision.rst:35
msgid ""
"Before performing a bulk provision, verify you have a PXE server capable "
"of performing network boots of |CL|. Please refer to our :ref:`guide on "
"how to perform an iPXE boot<ipxe-install>` using :abbr:`NAT (network "
"address translation)` for details."
msgstr "执行批量供应之前,请确认您的 PXE 服务器能够从网络引导 |CL|。有关详细信息,请参阅我们的 :ref:`如何执行 iPEX 引导的指南<ipxe-install>` (使用 :abbr:`NAT (network address translation)`)。"
#: ../../guides/maintenance/bulk-provision.rst:40
msgid ""
"Because a bulk provision relies on a reboot, ensure the following "
"preparations have been made:"
msgstr "由于批量供应依赖于重新引导,请确保已经做好以下准备:"
#: ../../guides/maintenance/bulk-provision.rst:43
msgid "No existing disks are bootable."
msgstr "没有可引导的现有磁盘。"
#: ../../guides/maintenance/bulk-provision.rst:44
msgid ""
"The network boot option must come immediately after the disk boot option "
"on any computer performing the installation."
msgstr "在执行安装的计算机上,网络引导选项必须紧跟在磁盘引导选项之后。"
#: ../../guides/maintenance/bulk-provision.rst:48
msgid "Configuration"
msgstr "配置"
#: ../../guides/maintenance/bulk-provision.rst:50
msgid ""
"Install ICIS by following the getting started guide on the `ICIS`_ "
"GitHub\\* repository."
msgstr "按照 `ICIS`_ GitHub\\* 存储库中的入门指南安装 ICIS。"
#: ../../guides/maintenance/bulk-provision.rst:53
msgid ""
"Create an Ister installation file and save it to the :file:`static/ister`"
" directory within the web hosting directory for ICIS. The installation "
"file is a JSON block and provides Ister with the steps it needs to "
"perform an installation. The file outlines what partitions, file systems,"
" and mount points Ister should set up. Lastly, the file outlines which "
"bundles to install. See our :ref:`bundles` document for the list of "
"available bundles. The following example shows the contents of an Ister "
"installation file:"
msgstr "创建一个 Ister 安装文件,并将其保存到 ICIS Web 托管目录下的 :file:`static/ister` 目录。该安装文件是一个 JSON 块,它为 Ister 提供了执行安装所需的步骤。该文件概述了 Ister 应该设置哪些分区、文件系统和挂载点。最后,该文件概述了要安装的捆绑包。有关可用捆绑包的列表,请参阅我们的 :ref:`bundles` 文档。以下示例显示了 Ister 安装文件的内容:"
#: ../../guides/maintenance/bulk-provision.rst:92
msgid ""
"Every Ister installation file hosted on ICIS must contain the the "
"`IsterCloudInitSvc` parameter as well as the :command:`os-cloudguest` "
"bundle. These entries allow Ister to customize an instance of of an "
"install."
msgstr "ICIS 上托管的每个 Ister 安装文件都必须包含 `IsterCloudInitSvc` 参数以及 :command:`os-cloudguest` 捆绑包。这些条目允许 Ister 自定义安装实例。"
#: ../../guides/maintenance/bulk-provision.rst:97
msgid ""
"Create an Ister configuration file to define the location of the Ister "
"installation file. Save it to the :file:`static/ister` directory within "
"the web hosting directory of ICIS. The following example shows an Ister "
"configuration file:"
msgstr "创建一个 Ister 配置文件来定义 Ister 安装文件的位置。将其保存到 ICIS Web 托管目录下的 :file:`static/ister` 目录。以下示例显示了一个 Ister 配置文件:"
#: ../../guides/maintenance/bulk-provision.rst:106
msgid ""
"Modify the iPXE boot script by adding a kernel parameter to the command "
"line for booting the network image. Add the kernel parameter `isterconf` "
"with the location of the Ister configuration file hosted on ICIS as the "
"kernel parameter value. The following example shows an iPXE boot script "
"with the `isterconf` parameter:"
msgstr "向引导网络映像的命令行添加一个内核参数来修改 iPXE 引导脚本。添加内核参数 `isterconf`,并将 ICIS 托管的 Ister 配置文件的位置作为内核参数值。以下示例显示了带有 `isterconf` 参数的 iPXE 引导脚本:"
#: ../../guides/maintenance/bulk-provision.rst:121
msgid ""
"After the network image of |CL| boots, Ister inspects the parameters used"
" during boot in :file:`/proc/cmdline` to find the location of the Ister "
"configuration file."
msgstr "|CL| 网络映像引导后,Ister 会在 :file:`/proc/cmdline` 中检查引导期间使用的参数以找到 Ister 配置文件的位置。"
#: ../../guides/maintenance/bulk-provision.rst:125
msgid ""
"Write a cloud-init document to customize the instance of the installation"
" according to your requirements. The `cloud-init`_ documentation provides"
" a guide on how to write a cloud-init document. The guide covers the "
"customization options provided by cloud-init after an installation."
msgstr "编写 cloud-init 文档,根据您的需求自定义安装实例。`cloud-init`_ 文档提供了如何编写 cloud-init 文档的指南。本指南涵盖了安装后 cloud-init 提供的自定义选项。"
#: ../../guides/maintenance/bulk-provision.rst:130
msgid ""
"Save the cloud-init document to the :file:`static/roles` directory within"
" the web hosting directory for ICIS with the name of a role you would "
"like to create. For example, a role may be \"database\", \"web\", or "
"\"ciao\"."
msgstr "将 cloud-init 文档保存到 ICIS Web 托管目录下的 :file:`static/roles` 目录,并使用要创建的角色的名称。例如,角色可以是 \"database\"、\"web\" 或 \"ciao\"。"
#: ../../guides/maintenance/bulk-provision.rst:134
msgid ""
"After creating the roles, also known as cloud-init files, assign roles to"
" MAC addresses of PXE clients. To do so, modify the :file:`config.txt` "
"file in the :file:`static` directory within the web hosting directory of "
"ICIS. The following example shows an example assignment:"
msgstr "创建角色(也称为 cloud-init 文件)后,将角色分配给 PXE 客户端的 MAC 地址。为此,请修改 ICIS Web 托管目录下 :file:`static` 目录中的 :file:`config.txt` 文件。以下示例显示了一个分配示例:"
#: ../../guides/maintenance/bulk-provision.rst:144
msgid ""
"If MAC addresses of PXE clients are not listed within the "
":file:`config.txt` file, a default role for those MAC address may be "
"defined as follows:"
msgstr "如果 PXE 客户端的 MAC 地址未列在 :file:`config.txt` 文件中,则会按如下方式为这些 MAC 地址定义默认角色:"
#: ../../guides/maintenance/bulk-provision.rst:153
msgid "Verify the following URLs are accessible on your local network:"
msgstr "确认在您的本地网络上是否可以访问以下 URL:"
#: ../../guides/maintenance/bulk-provision.rst:155
msgid "\\http://192.168.1.1:60000/icis/static/ister/ister.conf"
msgstr "\\http://192.168.1.1:60000/icis/static/ister/ister.conf"
#: ../../guides/maintenance/bulk-provision.rst:156
msgid "\\http://192.168.1.1:60000/icis/static/ister/ister.json"
msgstr "\\http://192.168.1.1:60000/icis/static/ister/ister.json"
#: ../../guides/maintenance/bulk-provision.rst:157
msgid "\\http://192.168.1.1:60000/icis/get_config/<MAC address>"
msgstr "\\http://192.168.1.1:60000/icis/get_config/<MAC address>"
#: ../../guides/maintenance/bulk-provision.rst:158
msgid "\\http://192.168.1.1:60000/icis/get_role/<role>"
msgstr "\\http://192.168.1.1:60000/icis/get_role/<role>"
#: ../../guides/maintenance/bulk-provision.rst:159
msgid "\\http://192.168.1.1:60000/ipxe/ipxe_boot_script.txt"
msgstr "\\http://192.168.1.1:60000/ipxe/ipxe_boot_script.txt"
#: ../../guides/maintenance/bulk-provision.rst:161
msgid "Power on the PXE client and watch it boot and install |CL|."
msgstr "打开 PXE 客户端的电源,观看它引导并安装 |CL|。"
#: ../../guides/maintenance/bulk-provision.rst:163
msgid "Power-cycle the PXE client and watch it customize the |CL| installation."
msgstr "关闭再开启 PXE 客户端的电源,观看它自定义 |CL| 安装。"
#: ../../guides/maintenance/bulk-provision.rst:165
msgid ""
"**Congratulations!** You have successfully performed a bulk provision of "
"|CL|."
msgstr "祝贺您!您已成功执行 |CL| 的批量供应。"
#~ msgid ""
#~ "Install **ICIS** by following the "
#~ "getting started guide on the `ICIS "
#~ "GitHub repository`_."
#~ msgstr ""
#~ msgid ""
#~ "Write a cloud-init document to "
#~ "customize the instance of the "
#~ "installation according to your requirements."
#~ " The `cloud-init Read the Docs`_ "
#~ "provides a guide on how to write"
#~ " a cloud-init document. The guide "
#~ "covers the customization options provided "
#~ "by cloud-init after an installation."
#~ msgstr ""
#~ msgid ""
#~ "The |CL-ATTR| can be automatically "
#~ "provisioned in bulk using a combination"
#~ " of the |CL| installer, **Ister**, "
#~ "and :abbr:`ICIS (Ister Cloud Init "
#~ "Service)`. This guide covers how to "
#~ "perform a bulk provision of |CL| "
#~ "using **Ister** and **ICIS**."
#~ msgstr ""
#~ msgid ""
#~ "To configure a bulk provision, Ister "
#~ "configuration files and cloud-init files"
#~ " must be defined. Hosting the "
#~ "configuration files in **ICIS** allows "
#~ "**Ister** to use them during the "
#~ "installation. The Ister configuration files"
#~ " allow us to customize the "
#~ "installation process. The cloud-init\\* "
#~ "files allow us to customize the "
#~ "instance of the installation."
#~ msgstr ""
#~ msgid ""
#~ "Install **ICIS** by following the "
#~ "getting started guide on the `ICIS`_ "
#~ "GitHub repository."
#~ msgstr ""
#~ msgid ""
#~ "Create an Ister installation file and"
#~ " save it to the :file:`static/ister` "
#~ "directory within the web hosting "
#~ "directory for **ICIS**. The installation "
#~ "file is a JSON block and provides"
#~ " **Ister** with the steps it needs"
#~ " to perform an installation. The file"
#~ " outlines what partitions, file systems,"
#~ " and mount points **Ister** should "
#~ "set up. Lastly, the file outlines "
#~ "which bundles to install. See our "
#~ ":ref:`bundles` document for the list of"
#~ " available bundles. The following example"
#~ " shows the contents of an Ister "
#~ "installation file:"
#~ msgstr ""
#~ msgid ""
#~ "Every Ister installation file hosted on"
#~ " **ICIS** must contain the the "
#~ "``IsterCloudInitSvc`` parameter as well as "
#~ "the ``os-cloudguest`` bundle. These "
#~ "entries allow **Ister** to customize an"
#~ " instance of of an install."
#~ msgstr ""
#~ msgid ""
#~ "Create an Ister configuration file to"
#~ " define the location of the Ister "
#~ "installation file. Save it to the "
#~ ":file:`static/ister` directory within the web"
#~ " hosting directory of **ICIS**. The "
#~ "following example shows an Ister "
#~ "configuration file:"
#~ msgstr ""
#~ msgid ""
#~ "Modify the iPXE boot script by "
#~ "adding a kernel parameter to the "
#~ "command line for booting the network "
#~ "image. Add the kernel parameter "
#~ "``isterconf`` with the location of the"
#~ " Ister configuration file hosted on "
#~ "**ICIS** as the kernel parameter value."
#~ " The following example shows an iPXE"
#~ " boot script with the ``isterconf`` "
#~ "parameter:"
#~ msgstr ""
#~ msgid ""
#~ "After the network image of |CL| "
#~ "boots, **Ister** inspects the parameters "
#~ "used during boot in :file:`/proc/cmdline` "
#~ "to find the location of the Ister"
#~ " configuration file."
#~ msgstr ""
#~ msgid ""
#~ "Save the cloud-init document to "
#~ "the :file:`static/roles` directory within the"
#~ " web hosting directory for **ICIS** "
#~ "with the name of a role you "
#~ "would like to create. For example, "
#~ "a role may be \"database\", \"web\", "
#~ "or \"ciao\"."
#~ msgstr ""
#~ msgid ""
#~ "After creating the roles, also known "
#~ "as cloud-init files, assign roles "
#~ "to MAC addresses of PXE clients. "
#~ "To do so, modify the :file:`config.txt`"
#~ " file in the ``static`` directory "
#~ "within the web hosting directory of "
#~ "**ICIS**. The following example shows "
#~ "one such assignment:"
#~ msgstr ""
#~ msgid "``http://192.168.1.1:60000/icis/static/ister/ister.conf``"
#~ msgstr ""
#~ msgid "``http://192.168.1.1:60000/icis/static/ister/ister.json``"
#~ msgstr ""
#~ msgid "``http://192.168.1.1:60000/icis/get_config/<MAC address>``"
#~ msgstr ""
#~ msgid "``http://192.168.1.1:60000/icis/get_role/<role>``"
#~ msgstr ""
#~ msgid "``http://192.168.1.1:60000/ipxe/ipxe_boot_script.txt``"
#~ msgstr ""
@@ -0,0 +1,316 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/maintenance/cpu-performance.rst:4
msgid "CPU Power and Performance"
msgstr "CPU 功率和性能"
#: ../../guides/maintenance/cpu-performance.rst:6
msgid "This guide explains the CPU power and performance mechanisms in |CL-ATTR|."
msgstr "本指南介绍 |CL-ATTR| 中的 CPU 功率和性能机制。"
#: ../../guides/maintenance/cpu-performance.rst:13
msgid "Overview"
msgstr "概述"
#: ../../guides/maintenance/cpu-performance.rst:15
msgid ""
"Modern x86 :abbr:`CPUs (central processing units)` employ a number of "
"features and technologies to balance performance, energy, and thermal "
"efficiencies."
msgstr "现代 x86 :abbr:`CPUs (central processing units)` 采用多种功能和技术来平衡性能、能耗和热效率。"
#: ../../guides/maintenance/cpu-performance.rst:18
msgid ""
"By default, |CL| prioritizes maximum CPU performance with the philosophy "
"that the faster the program finishes execution, the faster the CPU can "
"return to a low energy idle state. It is important to understand and "
"evaluate all of these technologies when troubleshooting or considering "
"changing the defaults."
msgstr "默认情况下,|CL| 优先考虑发挥 CPU 最佳性能,其理念是程序执行得越快,CPU 就能越快返回低功耗空闲状态。排除故障或考虑更改默认值时,了解和评估所有这些技术至关重要。"
#: ../../guides/maintenance/cpu-performance.rst:28
msgid "CPU power saving mechanisms"
msgstr "CPU 节能机制"
#: ../../guides/maintenance/cpu-performance.rst:30
msgid ""
"C-states and P-states are both CPU power saving mechanisms that are "
"entered under different operating conditions. The tradeoff is a slightly "
"longer time to exit these states when the CPU is needed once again."
msgstr "C 状态和 P 状态都属于 CPU 节能机制,CPU 会在不同工况下进入这些机制。权衡的结果是,当再次需要用到 CPU 时,退出这些状态的时间会稍微长一点。"
#: ../../guides/maintenance/cpu-performance.rst:37
msgid "C-states (idle states)"
msgstr "C 状态(空闲状态)"
#: ../../guides/maintenance/cpu-performance.rst:39
msgid ""
"C-states are hardware sleep states that are entered when it is determined"
" that the CPU is idle and not executing instructions."
msgstr "C 状态是硬件睡眠状态,当系统确定 CPU 空闲且未执行指令时便会进入该状态。"
#: ../../guides/maintenance/cpu-performance.rst:42
msgid ""
"C-states aim to reduce power utilization by increasingly reducing clock "
"frequency, voltages, and features in each state."
msgstr "在 C 状态下,系统通过不断降低每个状态下的时钟频率、电压和功能来降低功耗。"
#: ../../guides/maintenance/cpu-performance.rst:45
msgid ""
"Although C-states can typically be limited or disabled in a system's UEFI"
" or BIOS configuration, these settings are overridden when the "
"`intel_idle driver`_ is in use."
msgstr "虽然在系统的 UEFI 或 BIOS 配置中通常可以限制或禁用 C 状态,但使用 `intel_idle driver`_ 时,这些设置会被覆盖。"
#: ../../guides/maintenance/cpu-performance.rst:49
msgid "To view the current cpuidle driver run this command in a terminal:"
msgstr "要查看当前的 cpuidle 驱动程序,请在终端中运行以下命令:"
#: ../../guides/maintenance/cpu-performance.rst:55
msgid ""
"For troubleshooting, C-states can be limited with a kernel command line "
"boot parameter by adding :command:`processor.max_cstate=N "
"intel_idle.max_cstate=N` or completely disabled with "
":command:`idle=poll`."
msgstr "故障排除时,可以通过添加 :command:`processor.max_cstate=N intel_idle.max_cstate=N` 来使用内核命令行引导参数限制 C 状态,或者使用 :command:`idle=poll` 完全禁用 C 状态。"
#: ../../guides/maintenance/cpu-performance.rst:61
msgid ""
":command:`processor.max_cstate=0` is changed to "
":command:`processor.max_cstate=1` by the kernel to be a valid value."
msgstr "内核会将 :command:`processor.max_cstate=0` 改为 :command:`processor.max_cstate=1`,以使其成为有效值。"
#: ../../guides/maintenance/cpu-performance.rst:64
msgid ""
":command:`intel_idle.max_cstate=0` disables the Intel Idle driver, not "
"set it to C-state 0."
msgstr ":command:`intel_idle.max_cstate=0` 会禁用英特尔 Idle 空闲驱动程序,而不是将其设置为 C 状态 0。"
#: ../../guides/maintenance/cpu-performance.rst:70
msgid "P-states (performance states)"
msgstr "P 状态(性能状态)"
#: ../../guides/maintenance/cpu-performance.rst:72
msgid ""
"P-states, also known as *Intel SpeedStep® technology* on Intel processors"
" or *Cool'n'Quiet* on AMD processors, are states entered while the CPU is"
" active and executing instructions."
msgstr "P 状态(在英特尔处理器上也称为 Intel SpeedStep® 技术,而在 AMD 处理器上也称为 Cool'n'Quiet)是 CPU 处于活动中且正在执行指令时进入的状态。"
#: ../../guides/maintenance/cpu-performance.rst:76
msgid ""
"P-states aim to reduce power utilization by adjusting CPU clock frequency"
" and voltages based on CPU demand."
msgstr "P 状态会根据 CPU 需求调整 CPU 时钟频率和电压,以此来降低功耗。"
#: ../../guides/maintenance/cpu-performance.rst:79
msgid ""
"P-states can typically be limited or disabled in a system's firmware "
"(UEFI/BIOS)."
msgstr "在系统固件 (UEFI/BIOS) 中通常可以限制或禁用 P 状态。"
#: ../../guides/maintenance/cpu-performance.rst:82
msgid "Turbo boost"
msgstr "睿频加速技术"
#: ../../guides/maintenance/cpu-performance.rst:84
msgid ""
"`Intel® Turbo Boost Technology`_, found on some modern Intel CPUs, allows"
" core(s) on a processor to temporarily operate at a higher than rated CPU"
" clock frequency to accommodate demanding workloads if the CPU is under "
"defined power and thermal thresholds."
msgstr "部分现代英特尔 CPU 上采用了 `英特尔® 睿频加速技术`_,该技术可在 CPU 未超出指定功率和热阈值时,支持处理器上的核心暂时以高于额定 CPU 时钟频率的频率工作。"
#: ../../guides/maintenance/cpu-performance.rst:89
msgid ""
"Turbo boost is an extension of P-states. As such, changing or limiting "
"C-states or P-states impact the ability of a process to enter Turbo "
"boost."
msgstr "睿频加速技术是对 P 状态的扩展。因此,改变或限制 C 状态或 P 状态会影响 CPU 使用睿频加速技术。"
#: ../../guides/maintenance/cpu-performance.rst:92
msgid ""
"Turbo boost can be disabled in a system's UEFI or BIOS. Turbo boost can "
"also be disabled within |CL| with the command:"
msgstr "睿频加速技术可以在系统的 UEFI 或 BIOS 中禁用。睿频加速技术也可以在 |CL| 中使用以下命令禁用:"
#: ../../guides/maintenance/cpu-performance.rst:100
msgid "Linux CPU clock frequency scaling"
msgstr "Linux CPU 时钟频率缩放"
#: ../../guides/maintenance/cpu-performance.rst:102
msgid ""
"The CPUFreq subsystem in Linux allows the OS to control :ref:`C-states <c"
"-states-section>` and :ref:`P-states <P-states-section>` via CPU drivers "
"and governors that provide algorithms that define how and when to enter "
"these states."
msgstr "Linux 中的 CPUFreq 子系统允许操作系统通过 CPU 驱动程序和调速程序控制 :ref:`C-states <c-states-section>` 和 :ref:`P-states <P-states-section>`,因为这些驱动程序和调速程序提供了相应算法,可以定义如何以及何时进入这些状态。"
#: ../../guides/maintenance/cpu-performance.rst:108
msgid "Scaling driver"
msgstr "缩放驱动程序"
#: ../../guides/maintenance/cpu-performance.rst:110
msgid ""
"Linux uses the `Intel P-state driver`_, :command:`intel_pstate`, for "
"modern Intel processors from the Sandy Bridge generation or newer. Other "
"processors may default to the :command:`acpi-cpufreq*` driver which reads"
" values from the systems UEFI or BIOS."
msgstr "对于 Sandy Bridge 这一代或更新一代的现代英特尔处理器,Linux 使用 `Intel P-state driver`_ 和 :command:`intel_pstate`。对于其他处理器,可能默认使用从系统 UEFI 或 BIOS 读取值的 :command:`acpi-cpufreq*` 驱动程序。"
#: ../../guides/maintenance/cpu-performance.rst:115
msgid ""
"To view the current CPU frequency scaling driver run this command in a "
"terminal:"
msgstr "要查看当前的 CPU 频率缩放驱动程序,请在终端中运行以下命令:"
#: ../../guides/maintenance/cpu-performance.rst:122
msgid "Scaling governor"
msgstr "缩放调速程序"
#: ../../guides/maintenance/cpu-performance.rst:124
msgid ""
"|CL| sets the CPU governor to *performance* which calls for the CPU to "
"operate at maximum clock frequency. In other words, P-state P0. While "
"this may sound wasteful at first, it is important to remember that power "
"utilization does not increase significantly simply because of a locked "
"clock frequency without a workload."
msgstr "|CL| 将 CPU 调速程序设置为性能,要求 CPU 以最大时钟频率运行。换句话说,CPU 进入 P 状态 P0。虽然这一开始听起来可能有点浪费,但请记住,在没有工作负载的情况下锁定时钟频率并不会导致功耗显著增加。"
#: ../../guides/maintenance/cpu-performance.rst:130
msgid ""
"To view the current CPU frequency scaling governor run this command in a "
"terminal:"
msgstr "要查看当前的 CPU 频率缩放调速程序,请在终端中运行以下命令:"
#: ../../guides/maintenance/cpu-performance.rst:136
msgid "To change the CPU frequency scaling governor:"
msgstr "要更改 CPU 频率缩放调速程序:"
#: ../../guides/maintenance/cpu-performance.rst:138
msgid "Disable |CL| enforcement of certain power and performance settings:"
msgstr "禁止 |CL| 强制使用某些功率和性能设置:"
#: ../../guides/maintenance/cpu-performance.rst:144
msgid ""
"Change the governor. In the example below, the governor is set to "
"*performance*:"
msgstr "更改调速程序。在以下示例中,调速程序设置为性能:"
#: ../../guides/maintenance/cpu-performance.rst:151
msgid ""
"The list of all governors can be found in the Linux kernel documentation "
"on `CPUFreq Governors`_."
msgstr "所有调速程序的列表可以在有关 `CPUFreq Governors`_ 的 Linux 内核文档中找到。"
#: ../../guides/maintenance/cpu-performance.rst:156
msgid ""
"The intel_pstate driver only supports *performance* and *powersave* "
"governors."
msgstr "intel_pstate 驱动程序仅支持性能和节能调速程序。"
#: ../../guides/maintenance/cpu-performance.rst:159
msgid "Thermal management"
msgstr "散热管理"
#: ../../guides/maintenance/cpu-performance.rst:161
msgid ""
"`thermald`_ is a Linux thermal management daemon used to prevent the "
"overheating of platforms. When temperature thresholds are exceeded, "
"thermald forces a C-state by inserting CPU sleep cycles and adjusts "
"available cooling methods. This can be especially desirable for laptops."
msgstr "`thermald`_ 是一个用于防止平台过热的 Linux 散热管理守护程序。当超过温度阈值时,thermald 会通过插入 CPU 睡眠循环强制 CPU 进入 C 状态,并调整可用的散热方法。这对笔记本电脑来说尤其有效。"
#: ../../guides/maintenance/cpu-performance.rst:166
msgid ""
"By default, thermald is disabled in |CL| and starts automatically if "
"battery power is detected. thermald can be manually enabled using the "
"systemd service by running the command:"
msgstr "默认情况下,thermald 在 |CL| 中被禁用。如果检测到电池供电,它会自动启动。通过运行以下命令,可以使用 systemd 服务手动启用 thermald"
#: ../../guides/maintenance/cpu-performance.rst:175
msgid "For more information, see the thermald man page:"
msgstr "有关详细信息,请参阅 thermald 手册页:"
#: ../../guides/maintenance/cpu-performance.rst:181
msgid ""
"`ThermalMonitor`_ is a GUI application that can visually graph and log "
"temperatures from thermald. To use ThermalMonitor, add the :command"
":`desktop-apps-extras` bundle and add your user account to the power "
"group:"
msgstr "`ThermalMonitor`_ 是一个 GUI 应用程序,可以直观地绘制和记录来自 thermald 的温度数据。要使用 ThermalMonitor,请添加 :command:`desktop-apps-extras` 捆绑包,并将您的用户帐户添加到 power 组:"
#: ../../guides/maintenance/cpu-performance.rst:194
msgid ""
"After adding a new group, you must log out and log back in for the new "
"group to take effect."
msgstr "添加新组后,您必须注销并重新登录,然后新组才能生效。"
#~ msgid ""
#~ "The list of all governors can be"
#~ " found in the `Linux kernel "
#~ "documentation on CPUFreq Governors`_."
#~ msgstr ""
#~ msgid ""
#~ "P-states, also known as *SpeedStep* on"
#~ " Intel processors or *Cool'n'Quiet* on "
#~ "AMD processors, are states entered while"
#~ " the CPU is active and executing "
#~ "instructions."
#~ msgstr ""
#~ msgid ""
#~ "`Turbo Boost technology`_, found on some"
#~ " modern Intel CPUs, allows core(s) on"
#~ " a processor to temporarily operate "
#~ "at a higher than rated CPU clock"
#~ " frequency to accommodate demanding "
#~ "workloads if the CPU is under "
#~ "defined power and thermal thresholds."
#~ msgstr ""
#~ msgid ""
#~ "Linux uses the `Intel P-state driver`_,"
#~ " *intel_pstate*, for modern Intel "
#~ "processors from the Sandy Bridge "
#~ "generation or newer. Other processors "
#~ "may default to the *acpi-cpufreq* "
#~ "driver which reads values from the "
#~ "systems UEFI or BIOS."
#~ msgstr ""
#~ msgid ""
#~ "`ThermalMonitor`_ is a GUI application "
#~ "that can visually graph and log "
#~ "temperatures from thermald. To use "
#~ "ThermalMonitor, add the desktop-apps-"
#~ "extras bundle and add your user "
#~ "account to the power group:"
#~ msgstr ""
#~ msgid ""
#~ "After adding a new group you must"
#~ " log out and log back in for"
#~ " the new group to take affect."
#~ msgstr ""
@@ -0,0 +1,603 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/deploy-at-scale.rst:4
msgid "Deploy at Scale"
msgstr "大规模部署"
#: ../../guides/deploy-at-scale.rst:6
msgid ""
"This guide describes deployment considerations and strategies when "
"deploying |CL-ATTR| at scale in your environment."
msgstr "本指南介绍在您的环境中大规模部署 |CL-ATTR| 时的部署注意事项和部署策略。"
#: ../../guides/deploy-at-scale.rst:14
msgid "Overview"
msgstr "概述"
#: ../../guides/deploy-at-scale.rst:16
msgid ""
"In this guide the term *endpoint* refers to a system targeted for |CL| "
"installation, whether that is a datacenter system or unit deployed in "
"field."
msgstr "在本指南中,“端点”指的是安装 |CL| 的目标系统,而不论它是数据中心系统还是现场部署的单元。"
#: ../../guides/deploy-at-scale.rst:21
msgid ""
"This guide is not a replacement or blueprint for designing your own IT "
"operating environment."
msgstr "本指南并不能取代您自己的 IT 操作环境设计方案,也不能用作您的 IT 操作环境设计蓝图。"
#: ../../guides/deploy-at-scale.rst:24
msgid ""
"Implementation details for a scale deployment are beyond the scope of "
"this guide."
msgstr "大规模部署的实施细节超出了本指南的讨论范围。"
#: ../../guides/deploy-at-scale.rst:27
msgid ""
"Your |CL| deployment should complement your existing environment and "
"available tools. It is assumed core IT dependencies of your environment, "
"such as your network, are healthy and scaled to suit the deployment."
msgstr "您的 |CL| 部署应该作为您的现有环境和可用工具的有益补充。本指南假设您的环境中的核心 IT 基础设施(如网络)运行状况良好,并可根据部署需要加以扩展。"
#: ../../guides/deploy-at-scale.rst:32
msgid "Pick a usage and update strategy"
msgstr "选择使用和更新策略"
#: ../../guides/deploy-at-scale.rst:34
msgid ""
"Different business scenarios call for different deployment methodologies."
" |CL| offers the flexibility to continue consuming the upstream |CL| "
"distribution or the option to fork away from the |CL| distribution and "
"act as your own :abbr:`OSV (Operating System Vendor)`."
msgstr "不同的业务场景需要不同的部署方法。|CL| 十分灵活,既可继续使用上游 |CL| 发行版,也可在 |CL| 发行版的基础上分叉,让您自己成为 :abbr:`OSV (Operating System Vendor)`。"
#: ../../guides/deploy-at-scale.rst:39
msgid "Below is an overview of some considerations."
msgstr "以下概述了一些注意事项。"
#: ../../guides/deploy-at-scale.rst:42
msgid "Create your own Linux distribution (mix)"
msgstr "创建您自己的 Linux 发行版(混合版)"
#: ../../guides/deploy-at-scale.rst:44
msgid ""
"This approach forks away from the |CL| upstream and has you act as your "
"own :abbr:`OSV (Operating System Vendor)` by leveraging the :ref:`mixer` "
"process to create customized images based on |CL|. This is a level of "
"responsibility that requires having more infrastructure and processes to "
"adopt. In return, this approach *offers you a high degree of control and "
"customization*. Consider:"
msgstr "此方法是指利用 :ref:`mixer` 过程在 |CL| 基础上创建自定义映像,从而在上游 |CL| 的基础上分叉,让您自己成为 :abbr:`OSV (Operating System Vendor)`。此举需要采用更多基础设施和过程, 但回报是您可以对 Linux 发行版拥有极高的掌控和定制能力。注意事项:"
#: ../../guides/deploy-at-scale.rst:50
msgid ""
"Development systems that generate bundles and updates should have "
"sufficient performance for the task and be separate from the swupd update"
" webservers that serve update content to production machines."
msgstr "生成捆绑包和更新的开发系统应该有足够的性能来完成任务,并独立于为生产计算机提供更新内容的 swupd 更新 Web 服务器。"
#: ../../guides/deploy-at-scale.rst:54
msgid ""
"swupd update webservers that serve update content to production machines "
"should be appropriately scaled. Specific implementation details for a "
"scalable, resilient web server are beyond the scope of this document."
msgstr "为生产计算机提供更新内容的 swupd 更新 Web 服务器应该进行适当扩展。可扩展的弹性 Web 服务器的具体实现细节超出了本文的讨论范围。"
#: ../../guides/deploy-at-scale.rst:58
msgid "(See :ref:`mixer` for more information about update servers.)"
msgstr "(有关更新服务器的更多信息,请参阅 :ref:`mixer`。)"
#: ../../guides/deploy-at-scale.rst:61
msgid "Adopt an agile methodology"
msgstr "采用敏捷方法"
#: ../../guides/deploy-at-scale.rst:63
msgid ""
"The cloud, and other scaled deployments, are all about flexibility and "
"speed. It only makes sense that any |CL| deployment strategy should "
"follow suit."
msgstr "云部署和其他大规模部署的关键在于灵活性和速度。任何 |CL| 部署策略都应该遵循这两项要求。"
#: ../../guides/deploy-at-scale.rst:66
msgid ""
"Manually rebuilding your own bundles or mix for every release is not "
"sustainable at a large scale. A |CL| deployment pipeline should be agile "
"enough to validate and produce new versions with speed. Whether or not "
"those updates actually make their way to your production can be separate "
"business decision. However this *ability to frequently roll new versions*"
" of software to your endpoints is an important prerequisite."
msgstr "对大规模部署来说,为每个版本手动重建您自己的捆绑包或混合版是不可持续的。|CL| 部署流程应该足够敏捷,能够快速验证和快速生成新版本。是否将这些更新实际应用到生产环境属于独立的业务决策。但是,是否有能力将新版本软件频繁滚动推出到端点是一个重要的先决条件。"
#: ../../guides/deploy-at-scale.rst:73
msgid ""
"You own the validation and lifecycle of the OS and should treat it like "
"any other software development lifecycle. Below are some pointers:"
msgstr "您应负责验证操作系统并确定操作系统的生命周期,而且应该像对待任何其他软件开发生命周期一样对待它。以下是一些建议:"
#: ../../guides/deploy-at-scale.rst:76
msgid ""
"Thoroughly understand the custom software packages that you will need to "
"integrate with |CL| and maintain along with their dependencies."
msgstr "充分了解您需要与 |CL| 集成并维护的自定义软件包及其依赖关系。"
#: ../../guides/deploy-at-scale.rst:79
msgid ""
"Setup a path to production for building |CL| based images. At minimum "
"this should include:"
msgstr "为构建基于 |CL| 的映像设置生产路径。这至少应包括:"
#: ../../guides/deploy-at-scale.rst:82
msgid ""
"A development clr-on-clr environment to test building packages and "
"bundles for |CL| systems."
msgstr "一个开发 clr-on-clr 环境,用于测试 |CL| 系统的构建包和捆绑包。"
#: ../../guides/deploy-at-scale.rst:85
msgid "A pre-production environment to deploy |CL| versions to before production"
msgstr "一个生产前环境,用于在生产前部署 |CL| 版本"
#: ../../guides/deploy-at-scale.rst:88
msgid ""
"Employ a continuous integration and continuous deployment (CI/CD) "
"philosophy in order to:"
msgstr "采用持续集成和持续部署 (CI/CD) 理念,以便:"
#: ../../guides/deploy-at-scale.rst:91
msgid ""
"Automatically pull custom packages as they are updated from their "
"upstream projects or vendors."
msgstr "在上游项目或供应商推出更新时,自动提取自定义软件包。"
#: ../../guides/deploy-at-scale.rst:94
msgid ""
"Generate |CL| bundles and potentially bootable images with your "
"customizations, if any."
msgstr "根据您的自定义设置(如果有的话),生成 |CL| 捆绑包和可引导映像(如果需要的话)。"
#: ../../guides/deploy-at-scale.rst:97
msgid ""
"Measure against metrics and indicators which are relevant to your "
"business (e.g. performance, power, etc) from release to release."
msgstr "根据与业务有关的度量和指标(例如性能、功率等),评估不同版本的表现。"
#: ../../guides/deploy-at-scale.rst:100
msgid ""
"Integrate with your organization's governance processes, such as change "
"control."
msgstr "与您所在组织的治理流程(例如变更控制)集成。"
#: ../../guides/deploy-at-scale.rst:104
msgid "Versioning infrastructure"
msgstr "版本控制基础设施"
#: ../../guides/deploy-at-scale.rst:106
msgid ""
"|CL| version numbers are very important as they apply to the whole "
"infrastructure stack from OS components to libraries and applications."
msgstr "|CL| 版本号非常重要,因为它们适用于从操作系统组件到库和应用程序在内的整个基础设施堆栈。"
#: ../../guides/deploy-at-scale.rst:109
msgid ""
"Good record keeping is important, so you should keep a detailed registry "
"and history of previously deployed versions and their contents."
msgstr "妥善保存记录很重要,因此您应该维护一个详细的登记表,记录下以前部署的各个版本及其内容。"
#: ../../guides/deploy-at-scale.rst:112
msgid ""
"With a glance at the |CL| version numbers deployed, you should be able to"
" tell if your Clear systems are patched against a particular security "
"vulnerability or incorporate a critical new feature."
msgstr "只要看一眼所部署的 |CL| 版本号,您就应该知道您的 Clear Linux OS 是否为特定安全漏洞打上了补丁或者是否纳入了重要的新功能。"
#: ../../guides/deploy-at-scale.rst:117
msgid "Pick an image distribution strategy"
msgstr "选择映像分发策略"
#: ../../guides/deploy-at-scale.rst:119
msgid ""
"Once you have decided on a usage and update strategy, you should "
"understand *how* |CL| will be deployed to your endpoints. In a large "
"scale deployment, interactive installers should be avoided in favor of "
"automated installations or prebuilt images."
msgstr "定下了使用和更新策略后,您就应该知道 |CL| 将如何部署到您的端点。在大规模部署中,应该避免使用交互式安装程序,而是倾向于使用自动化安装或预构建映像。"
#: ../../guides/deploy-at-scale.rst:124
msgid ""
"There are many well-known ways to install an operating system at scale. "
"Each have their own benefits, and one may lend itself easier in your "
"environment depending on the resources available to you."
msgstr "大规模安装操作系统有许多广为人知的方法。每种方法都有其优势,但根据您的环境中可用的资源不同,有的方法在您的环境中可能更容易使用。"
#: ../../guides/deploy-at-scale.rst:128
msgid "See the available :ref:`image-types`."
msgstr "请参阅可用的 :ref:`image-types`。"
#: ../../guides/deploy-at-scale.rst:130
msgid "Below are some common ways to install |CL| to systems at scale:"
msgstr "以下是大规模安装 |CL| 的一些常见方法:"
#: ../../guides/deploy-at-scale.rst:133
msgid "Bare metal"
msgstr "裸机"
#: ../../guides/deploy-at-scale.rst:135
msgid ""
"Preboot Execution Environments (PXE) or other out-of-band booting options"
" are one way to distribute |CL| to physical bare metal systems on a LAN."
msgstr "将 |CL| 分发到 LAN 上物理裸机系统的一种方式是使用预引导执行环境 (PXE) 或其他带外引导选项。"
#: ../../guides/deploy-at-scale.rst:138
msgid ""
"This option works well if your customizations are fairly small in size "
"and infrastructure can be stateless."
msgstr "如果您的自定义软件包非常小,并且使用的是无状态基础设施,那么这种分发方式可取得不错的效果。"
#: ../../guides/deploy-at-scale.rst:141
msgid ""
"The |CL| `Downloads`_ page offers a live image that can be deployed as a "
"PXE boot server if one doesn't already exist in your environment. Also "
"see documentation on how to :ref:`bare-metal-install-server`."
msgstr "如果您的环境中并没有可供部署的映像,您可以访问 |CL| `Downloads`_ 页面下载一个实时映像,并将其部署为 PXE 引导服务器。另请参阅关于如何 :ref:`bare-metal-install-server` 的文档。"
#: ../../guides/deploy-at-scale.rst:146
msgid "Cloud instances or virtual machines"
msgstr "云实例或虚拟机"
#: ../../guides/deploy-at-scale.rst:148
msgid ""
"Image templates in the form of cloneable disks are an effective way to "
"distribute |CL| for virtual machine environments, whether on-premises or "
"hosted by a Cloud Solution Provider (CSP)."
msgstr "无论是在内部部署环境中还是在云解决方案提供商 (CSP) 托管环境中,可克隆磁盘形式的映像模板都是在虚拟机环境中分发 |CL| 的有效方法。"
#: ../../guides/deploy-at-scale.rst:152
msgid ""
"When used in concert with cloud VM migration features, this can be a good"
" option for allowing your applications a degree of high availability and "
"workload mobility; VMs can be restarted on a cluster of hypervisor host "
"or moved between datacenters transparently."
msgstr "与云虚拟机迁移功能配合使用时,此分发方式效果极佳,可实现极高的应用程序可用性和工作负载移动性;届时,虚拟机可以在虚拟机管理程序主机集群上重启,也可以在数据中心之间无缝迁移。"
#: ../../guides/deploy-at-scale.rst:157
msgid ""
"The |CL| `Downloads`_ page offers example prebuilt VM images and is "
"readily available on popular CSPs. Also see documentation on how to :ref"
":`virtual-machine-install`."
msgstr "|CL| `Downloads`_ 页面提供了预构建虚拟机映像示例,它可以在主流 CSP 的云环境中即刻部署。另请参阅有关如何 :ref:`virtual-machine-install` 的文档。"
#: ../../guides/deploy-at-scale.rst:162
msgid "Containers"
msgstr "容器"
#: ../../guides/deploy-at-scale.rst:164
msgid ""
"Containerization platforms allow images to be pulled from a repository "
"and deployed repeatedly as isolated containers."
msgstr "容器化平台支持从存储库中提取映像,然后将其作为独立的容器反复部署。"
#: ../../guides/deploy-at-scale.rst:167
msgid ""
"Containers with a |CL| image can be a good option to blueprint and ship "
"your application, including all its dependencies, as an artifact while "
"allowing you or your customers to dynamically orchestrate and scale "
"applications."
msgstr "含有 |CL| 映像的容器是一个不错的分发方式,它可以将应用程序(包括其所有依赖项)设计为蓝图,然后作为对象进行分发,同时也支持您或您的客户动态编排和扩展应用程序。"
#: ../../guides/deploy-at-scale.rst:172
msgid ""
"|CL| is capable of running a Docker host, has a container image which can"
" be pulled from DockerHub, or can be built as a customized container. For"
" more information visit the `Containers`_ page."
msgstr "|CL| 能够运行 Docker 主机,具有可以从 DockerHub 中提取的容器映像,或者可以构建为自定义容器。有关详细信息,请访问 `Containers`_ 页面。"
#: ../../guides/deploy-at-scale.rst:177
msgid "Considerations with stateless systems"
msgstr "有关无状态系统的注意事项"
#: ../../guides/deploy-at-scale.rst:179
msgid ""
"An important |CL| concept is statelessness and partitioning of system "
"data from user data. This concept can change the way you think about an "
"at scale deployment."
msgstr "|CL| 的一个重要概念是无状态以及区分用户数据和系统数据。此概念可能会改变您对大规模部署的认识。"
#: ../../guides/deploy-at-scale.rst:184
msgid "Backup strategy"
msgstr "备份策略"
#: ../../guides/deploy-at-scale.rst:186
msgid ""
"A |CL| system and its infrastructure should be considered a commodity and"
" be easily reproducible. Avoid focusing on backing up the operating "
"system itself or default values."
msgstr "|CL| 系统及其基础设施应被视为一种商品,而且这种商品很容易复制。避免将注意力放在备份操作系统本身或默认值上,"
#: ../../guides/deploy-at-scale.rst:190
msgid ""
"Instead, focus on backing up what's important and unique - the "
"application and data. In other words, only focus on backing up critical "
"areas like :file:`/home`, :file:`/etc`, and :file:`/var`."
msgstr "而是应该将注意力放在备份重要且独特的应用程序和数据上。换句话说,只关注备份关键区域,如 :file:`/home`、:file:`/etc` 和 :file:`/var`。"
#: ../../guides/deploy-at-scale.rst:195
msgid "Meaningful logging & telemetry"
msgstr "日志记录和遥测十分有用"
#: ../../guides/deploy-at-scale.rst:197
msgid ""
"Offload logging and telemetry from endpoints to external servers, so it "
"is persistent and can be accessed on another server when an issue occurs."
msgstr "将日志记录和遥测数据从端点分流到外部服务器,从而确保它们持久存在,而且在发生问题时便于从另一台服务器访问。"
#: ../../guides/deploy-at-scale.rst:200
msgid ""
"Remote syslogging in |CL| is available through the `systemd-journal-"
"remote.service`_"
msgstr "|CL| 中的远程系统日志记录可通过 `systemd-journal-remote.service`_ 获得"
#: ../../guides/deploy-at-scale.rst:203
msgid ""
"|CL| offers a :ref:`telem-guide`, which can be a powerful tool for a "
"large deployment to quickly crowdsource issues of interest. Take "
"advantage of this feature with careful consideration of the target "
"audience and the kind of data that would be valuable, and expose events "
"appropriately."
msgstr "|CL| 提供了 :ref:`telem-guide`,这是一个强大的工具,可用于在大规模部署时以众包的方式快速解决相关问题。利用此功能时需要仔细考虑目标受众以及哪些类型的数据是有价值的,还要适当地公开事件。"
#: ../../guides/deploy-at-scale.rst:209
msgid ""
"Like any web server, the telemetry server should be appropriately scaled "
"and resilient. Specific implementation details for a scalable, resilient "
"web server are beyond the scope of this document."
msgstr "像任何 Web 服务器一样,遥测服务器也应该可以适当地扩展并具有适当的弹性。可扩展的弹性 Web 服务器的具体实现细节超出了本文的讨论范围。"
#: ../../guides/deploy-at-scale.rst:214
msgid "Orchestration and configuration management"
msgstr "编排和配置管理"
#: ../../guides/deploy-at-scale.rst:216
msgid ""
"In cloud environments, where systems can be ephemeral, being able to "
"configure and maintain generic instances is valuable."
msgstr "在云环境中,系统的生命周期可能很短暂,因此是否有能力配置和维护通用实例十分重要。"
#: ../../guides/deploy-at-scale.rst:219
msgid ""
"|CL| offers an efficient cloud-init style solution, `micro-config-"
"drive`_, through the *os-cloudguest* bundles which allow you to configure"
" many Day 1 tasks such as setting hostname, creating users, or placing "
"SSH keys in an automated way at boot. For more information on automating "
"configuration during deployment of |CL| endpoints see the :ref:`bulk-"
"provision` guide."
msgstr "|CL| 通过 *os-cloudguest* 捆绑包提供了一个高效的云初始化解决方案 `micro-config-drive`_,支持在引导时自动执行许多上线第一天任务,例如设置主机名、创建用户或放置 SSH 密钥。有关在 |CL| 端点部署期间自动配置的更多信息,请参阅 :ref:`bulk-provision` 指南。"
#: ../../guides/deploy-at-scale.rst:226
msgid ""
"A configuration management tool is useful for maintaining consistent "
"system and application-level configuration. Ansible\\* is offered through"
" the *sysadmin-hostmgmt* bundle as a configuration management and "
"automation tool."
msgstr "配置管理工具对于维护一致的系统和应用程序级配置非常有用。*sysadmin-hostmgmt* 捆绑包提供了 Ansible\\* 作为配置管理和自动化工具。"
#: ../../guides/deploy-at-scale.rst:232
msgid "Cloud-native applications"
msgstr "云原生应用程序"
#: ../../guides/deploy-at-scale.rst:234
msgid ""
"An Infrastructure OS can design for good behavior, but it is ultimately "
"up to applications to make agile design choices. Applications deployed on"
" |CL| should aim to be host-aware but not depend on any specific host to "
"run. References should be relative and dynamic when possible."
msgstr "基础设施操作系统可以将各种操作和行为都设计得井井有条,但设计是否敏捷最终还是取决于应用程序。部署在 |CL| 上的应用程序应该能够识别主机,但不依赖于任何特定的主机来运行。如果条件允许,应该使用相对和动态引用。"
#: ../../guides/deploy-at-scale.rst:239
msgid ""
"The application architecture should incorporate an appropriate tolerance "
"for infrastructure outages. Don't just keep stateless design as a noted "
"feature. Continuously test its use; Automate its use by redeploying |CL| "
"and application on new hosts. This naturally minimizes configuration "
"drift, challenges your monitoring systems, and business continuity plans."
msgstr "应用程序架构应该针对基础设施中断具有适当的容错能力。不要仅仅将无状态设计作为一个显著特征。持续测试其使用情况;通过在新主机上反复部署 |CL| 和应用程序来将其使用自动化。这自然会最大限度减少配置偏差,并给监控系统和业务连续性计划带来挑战。"
#~ msgid ""
#~ "Development systems which are generating "
#~ "bundles and updates should be "
#~ "sufficiently performant for the task and"
#~ " separate from the swupd update "
#~ "webservers which are serving update "
#~ "content to production machines."
#~ msgstr ""
#~ msgid ""
#~ "swupd update webservers which are "
#~ "serving update content to production "
#~ "machines (see `mixer process`_ for more"
#~ " information) should be appropriately "
#~ "scaled."
#~ msgstr ""
#~ msgid ""
#~ "|CL| offers a `native telemetry "
#~ "solution`_ which can be a powerful "
#~ "tool for a large deployment to "
#~ "quickly crowdsource issues of interest. "
#~ "Take advantage of this feature with "
#~ "careful consideration of the target "
#~ "audience and the kind of data that"
#~ " would be valuable, and expose events"
#~ " appropriately."
#~ msgstr ""
#~ msgid ""
#~ "Once you are comfortable with |CL-"
#~ "ATTR| :ref:`concepts <concepts>`, your next"
#~ " step as a system administrator is"
#~ " to understand how to deploy |CL| "
#~ "at scale in your environment."
#~ msgstr ""
#~ msgid ""
#~ "In this document the term *endpoint* "
#~ "refers to a system targeted for "
#~ "|CL| installation, whether that is a "
#~ "datacenter system or unit deployed in"
#~ " field."
#~ msgstr ""
#~ msgid ""
#~ "This is not a replacement or "
#~ "blueprint for designing your own IT "
#~ "operating environment."
#~ msgstr ""
#~ msgid ""
#~ "Your |CL| deployment should complement "
#~ "the existing environment and available "
#~ "tools. It is assumed foundational core"
#~ " IT dependencies of your environment, "
#~ "such as your network, are healthy "
#~ "and scaled to suit the deployment."
#~ msgstr ""
#~ msgid "Pick a |CL| usage and update strategy"
#~ msgstr ""
#~ msgid ""
#~ "This approach forks away from the "
#~ "|CL| upstream and has you act as"
#~ " your own :abbr:`OSV (Operating System "
#~ "Vendor)` by leveraging the `mixer "
#~ "process`_ to create customized images "
#~ "based on |CL|. This is a level "
#~ "of responsibility that requires having "
#~ "more infrastructure and processes to "
#~ "adopt. In return, this approach *offers"
#~ " you a high degree of control "
#~ "and customization*."
#~ msgstr ""
#~ msgid ""
#~ "Development systems that generate bundles "
#~ "and updates should have sufficient "
#~ "performance for the task and separate"
#~ " from the swupd update webservers "
#~ "that serve update content to production"
#~ " machines."
#~ msgstr ""
#~ msgid ""
#~ "swupd update webservers that serve "
#~ "update content to production machines "
#~ "(see `mixer process`_ for more "
#~ "information) should be appropriately scaled."
#~ msgstr ""
#~ msgid ""
#~ "Your swupd update server is just "
#~ "like any other web application. |WEB-"
#~ "SERVER-SCALE|"
#~ msgstr ""
#~ msgid "Versioning Infrastructure"
#~ msgstr ""
#~ msgid "Baremetal"
#~ msgstr ""
#~ msgid ""
#~ "Preboot Execution Environments (PXE) or "
#~ "other out-of-band booting options "
#~ "are one way to distribute |CL| to"
#~ " physical baremetal systems on a LAN."
#~ msgstr ""
#~ msgid ""
#~ "The |CL| `downloads page`_ offers a "
#~ "live image that can be deployed as"
#~ " a PXE boot server if one "
#~ "doesn't already exist in your "
#~ "environment. Also see documentation on "
#~ "how to :ref:`bare-metal-install-server`."
#~ msgstr ""
#~ msgid "Cloud Instances or Virtual Machines"
#~ msgstr ""
#~ msgid ""
#~ "The |CL| `downloads page`_ offers "
#~ "example prebuilt VM images and is "
#~ "readily available on popular CSPs. Also"
#~ " see documentation on how to :ref"
#~ ":`virtual-machine-install`."
#~ msgstr ""
#~ msgid ""
#~ "|CL| is capable of running a "
#~ "Docker host, has a container image "
#~ "which can be pulled from DockerHub, "
#~ "or can be built as a customized"
#~ " container. For more information visit "
#~ "the `containers page`_."
#~ msgstr ""
#~ msgid ""
#~ "Instead, focus on backing up what's "
#~ "important and unique - the application"
#~ " and data. In other words, only "
#~ "focus on backing up critical areas "
#~ "like `/home`, `/etc`, and `/var`."
#~ msgstr ""
#~ msgid "Meaningful Logging & Telemetry"
#~ msgstr ""
#~ msgid ""
#~ "Remote syslogging in |CL| is available"
#~ " through the `systemd journal-remote "
#~ "service`_"
#~ msgstr ""
#~ msgid ""
#~ "Your telemetry server is just like "
#~ "any other web application. |WEB-"
#~ "SERVER-SCALE|"
#~ msgstr ""
#~ msgid "Orchestration and Configuration Management"
#~ msgstr ""
#~ msgid ""
#~ "|CL| offers an efficient cloud-init "
#~ "style solution, `micro-config-drive`_, "
#~ "through the *os-cloudguest* bundles "
#~ "which allow you to configure many "
#~ "Day 1 tasks such as setting "
#~ "hostname, creating users, or placing SSH"
#~ " keys in an automated way at "
#~ "boot. For more information on automating"
#~ " configuration during deployment of |CL|"
#~ " endpoints see the `documentation on "
#~ "bulk provisioning`_ ."
#~ msgstr ""
@@ -0,0 +1,287 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/maintenance/developer-workstation.rst:4
msgid "Developer Workstation"
msgstr "开发人员工作站"
#: ../../guides/maintenance/developer-workstation.rst:6
msgid ""
"This guide helps you find the minimum set of bundles needed to start your"
" |CL-ATTR| development project."
msgstr "本指南帮助您确定启动您的 |CL-ATTR| 开发项目所需的最小捆绑包集。"
#: ../../guides/maintenance/developer-workstation.rst:9
msgid ""
"Before continuing, review the :ref:`swupd <swupd-guide>` guide to learn "
"more about the swupd tool and how |CL| simplifies software versioning "
"compared to other Linux\\* distributions."
msgstr "继续之前,请阅读 :ref:`swupd <swupd-guide>` 指南,详细了解 swupd 工具以及 |CL| 相比其他 Linux\\* 发行版如何简化了软件版本控制。"
#: ../../guides/maintenance/developer-workstation.rst:18
msgid "Workstation Setup"
msgstr "工作站设置"
#: ../../guides/maintenance/developer-workstation.rst:20
msgid ""
"After installing the minimum set of bundles required to get started, you "
"can add more bundles relevant to your specific use case."
msgstr "安装了启动项目所需的最小捆绑包集后,您可以添加更多与您的特定用例相关的捆绑包。"
#: ../../guides/maintenance/developer-workstation.rst:23
msgid ""
"To run any process required for |CL| development, you can add the large "
"bundle :ref:`*os-clr-on-clr* <enable-user-space>`. However, given how "
"many packages this bundle contains, you may want to deploy a leaner OS "
"with only bundles relevant to your project."
msgstr "要运行 |CL| 开发所需的任何进程,您可以添加大型捆绑包 :ref:`*os-clr-on-clr* <enable-user-space>`。但是,考虑到该捆绑包含有大量软件包,您可能希望部署一个更精简的操作系统,只包含与您的项目相关的捆绑包。"
#: ../../guides/maintenance/developer-workstation.rst:28
msgid ""
"Use Table 1, *Developer Profiles*, to identify the *minimum required "
"bundles* to get started developing based on your role or project. While "
"your role may not neatly fit in one of these categories, consider Table 1"
" as a starting point."
msgstr "使用表 1 开发人员配置文件,根据您的角色或项目确定开始开发所需的最少捆绑包。虽然您的角色不一定与表中的类别完全吻合,但不妨在表 1 的基础上确定所需的捆绑包。"
#: ../../guides/maintenance/developer-workstation.rst:33
msgid "**Table 1. Developer Profiles**"
msgstr "**表 1.开发人员配置文件**"
#: ../../guides/maintenance/developer-workstation.rst:37
msgid "|CL| Bundle"
msgstr "|CL| 捆绑包"
#: ../../guides/maintenance/developer-workstation.rst:38
msgid "*Internet of Things (IoT)*"
msgstr "*物联网 (IoT)**"
#: ../../guides/maintenance/developer-workstation.rst:39
msgid "*System Administrator*"
msgstr "*系统管理员*"
#: ../../guides/maintenance/developer-workstation.rst:40
msgid "*Client/Cloud/Web Developer*"
msgstr "*客户端/云/Web 开发人员*"
#: ../../guides/maintenance/developer-workstation.rst:42
msgid ":command:`editors`"
msgstr ":command:`editors`"
#: ../../guides/maintenance/developer-workstation.rst:43
#: ../../guides/maintenance/developer-workstation.rst:44
#: ../../guides/maintenance/developer-workstation.rst:45
#: ../../guides/maintenance/developer-workstation.rst:48
#: ../../guides/maintenance/developer-workstation.rst:49
#: ../../guides/maintenance/developer-workstation.rst:50
#: ../../guides/maintenance/developer-workstation.rst:53
#: ../../guides/maintenance/developer-workstation.rst:54
#: ../../guides/maintenance/developer-workstation.rst:55
#: ../../guides/maintenance/developer-workstation.rst:59
#: ../../guides/maintenance/developer-workstation.rst:60
#: ../../guides/maintenance/developer-workstation.rst:64
#: ../../guides/maintenance/developer-workstation.rst:65
#: ../../guides/maintenance/developer-workstation.rst:69
#: ../../guides/maintenance/developer-workstation.rst:70
#: ../../guides/maintenance/developer-workstation.rst:73
#: ../../guides/maintenance/developer-workstation.rst:74
#: ../../guides/maintenance/developer-workstation.rst:75
#: ../../guides/maintenance/developer-workstation.rst:80
msgid "✓"
msgstr "✓"
#: ../../guides/maintenance/developer-workstation.rst:47
msgid ":command:`network-basic`"
msgstr ":command:`network-basic`"
#: ../../guides/maintenance/developer-workstation.rst:52
msgid ":command:`openssh-server`"
msgstr ":command:`openssh-server`"
#: ../../guides/maintenance/developer-workstation.rst:57
msgid ":command:`webserver-basic`"
msgstr ":command:`webserver-basic`"
#: ../../guides/maintenance/developer-workstation.rst:62
msgid ":command:`application-server`"
msgstr ":command:`application-server`"
#: ../../guides/maintenance/developer-workstation.rst:67
msgid ":command:`database-basic`"
msgstr ":command:`database-basic`"
#: ../../guides/maintenance/developer-workstation.rst:72
msgid ":command:`desktop-autostart`"
msgstr ":command:`desktop-autostart`"
#: ../../guides/maintenance/developer-workstation.rst:77
msgid ":command:`dev-utils`"
msgstr ":command:`dev-utils`"
#: ../../guides/maintenance/developer-workstation.rst:83
msgid "swupd search"
msgstr "swupd 搜索"
#: ../../guides/maintenance/developer-workstation.rst:85
msgid ""
"We recommend learning about :ref:`swupd <swupd-guide>`, to learn the "
"commands to search for and add bundles relevant to your project."
msgstr "我们建议您学习 :ref:`swupd <swupd-guide>`,了解搜索和添加与您的项目相关的捆绑包所需的命令。"
#: ../../guides/maintenance/developer-workstation.rst:88
msgid ""
"The guide provides an :ref:`example <swupd-guide-example-install-bundle>`"
" that shows you how to:"
msgstr "本指南提供了一个 :ref:`example <swupd-guide-example-install-bundle>`,向您展示如何:"
#: ../../guides/maintenance/developer-workstation.rst:91
msgid "Use swupd to search for bundles"
msgstr "使用 swupd 搜索捆绑包"
#: ../../guides/maintenance/developer-workstation.rst:92
msgid "Use swupd to add bundles"
msgstr "使用 swupd 添加捆绑包"
#: ../../guides/maintenance/developer-workstation.rst:95
msgid "Core Concepts"
msgstr "核心概念"
#: ../../guides/maintenance/developer-workstation.rst:97
msgid ""
"We recommend that you understand these core concepts in |CL| *before* "
"developing your project."
msgstr "我们建议您在开发项目之前先了解 |CL| 中的这些核心概念。"
#: ../../guides/maintenance/developer-workstation.rst:100
msgid ":ref:`Software update <swupd-guide>`"
msgstr ":ref:`Software update <swupd-guide>`"
#: ../../guides/maintenance/developer-workstation.rst:101
msgid ":ref:`Mixer <mixer>`"
msgstr ":ref:`Mixer <mixer>`"
#: ../../guides/maintenance/developer-workstation.rst:102
msgid ":ref:`Autospec <autospec>`"
msgstr ":ref:`Autospec <autospec>`"
#: ../../guides/maintenance/developer-workstation.rst:105
msgid "Other resources for developers"
msgstr "开发人员可用的其他资源"
#: ../../guides/maintenance/developer-workstation.rst:107
msgid "`Developer Tooling Framework`_ for |CL|"
msgstr "适用于 |CL| 的 `Developer Tooling Framework`_"
#: ../../guides/maintenance/developer-workstation.rst:108
msgid "`Bundle Definition Files`_"
msgstr "`Bundle Definition Files`_"
#~ msgid "`Bundle definition files`_"
#~ msgstr ""
#~ msgid ""
#~ "*Developer Workstation* helps you find "
#~ "the :ref:`bundles-about` you need to "
#~ "start your |CL-ATTR| development "
#~ "project."
#~ msgstr ""
#~ msgid ""
#~ "Before continuing, we recommend that you"
#~ " learn how to use :ref:`swupd "
#~ "<swupd-guide>`. Visit our :ref:`swupd-"
#~ "about` page to understand how |CL| "
#~ "simplifies software versioning compared to "
#~ "other Linux\\* distributions."
#~ msgstr ""
#~ msgid ""
#~ "This guide helps you understand the "
#~ "minimum bundles required to get started."
#~ " After installing them, you can add"
#~ " more bundles relevant to your use"
#~ " case. To run any process required"
#~ " for |CL| development, you can add"
#~ " the large bundle :ref:`*os-clr-"
#~ "on-clr* <enable-user-space>`. However, "
#~ "given how many packages this bundle "
#~ "contains, you may want instead to "
#~ "deploy a leaner OS with only those"
#~ " bundles relevant to your project. "
#~ "Developer Workstation responds to this "
#~ "need."
#~ msgstr ""
#~ msgid ""
#~ "Use Table 1, *Developer Profiles*, to"
#~ " identify the *minimum required bundles*"
#~ " to get started developing based on"
#~ " your role or project. While your "
#~ "role may not neatly fit in one "
#~ "of these categories, consider using "
#~ "Table 1 as a starting point."
#~ msgstr ""
#~ msgid "`editors`"
#~ msgstr ""
#~ msgid "`network-basic`"
#~ msgstr ""
#~ msgid "`openssh-server`"
#~ msgstr ""
#~ msgid "`webserver-basic`"
#~ msgstr ""
#~ msgid "`application-server`"
#~ msgstr ""
#~ msgid "`database-basic`"
#~ msgstr ""
#~ msgid "`desktop-autostart`"
#~ msgstr ""
#~ msgid "`dev-utils`"
#~ msgstr ""
#~ msgid "`swupd` search"
#~ msgstr ""
#~ msgid "Use `swupd` to search for bundles"
#~ msgstr ""
#~ msgid "Use `swupd` to add bundles"
#~ msgstr ""
#~ msgid ":ref:`Bundles <bundles-about>`"
#~ msgstr ""
#~ msgid ":ref:`Software update <swupd-about>`"
#~ msgstr ""
#~ msgid ":ref:`Mixer <mixer-about>`"
#~ msgstr ""
#~ msgid ":ref:`Autospec <autospec-about>`"
#~ msgstr ""
@@ -0,0 +1,281 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: 2019-08-02 16:09-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:4
msgid "Download, verify, and decompress a |CL-ATTR| image on Linux"
msgstr "在 Linux 上下载、验证和解压缩 |CL-ATTR| 映像"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:6
msgid ""
"This guide describes the types of |CL| images available, where to "
"download them, how to verify the integrity of an image, and how to "
"decompress it."
msgstr "本指南介绍可用 |CL| 映像的类型、从哪里下载它们、如何验证映像的完整性以及如何解压缩映像。"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:9
msgid "Instructions for other operating systems are available:"
msgstr "适用于其他操作系统的说明如下:"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:11
msgid ":ref:`download-verify-decompress-mac`"
msgstr ":ref:`download-verify-decompress-mac`"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:12
msgid ":ref:`download-verify-decompress-windows`"
msgstr ":ref:`download-verify-decompress-windows`"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:15
msgid "Image types"
msgstr "映像类型"
#: ../../reference/image-types.rst:3
msgid ""
"|CL-ATTR| offers many types of `images`_ for different platforms and "
"environments."
msgstr "|CL-ATTR| 为不同平台和环境提供多种类型的 `images`_。"
#: ../../reference/image-types.rst:7
msgid "The naming convention of a |CL| image filename is:"
msgstr "|CL| 映像文件名的命名约定是:"
#: ../../reference/image-types.rst:13
msgid "The *[version number]* field specifies the version number."
msgstr "*[version number]* 字段指定版本号。"
#: ../../reference/image-types.rst:15
msgid ""
"The *[image type]* field specifies the type of image and its "
"corresponding file format."
msgstr "*[image type]* 字段指定映像类型及其相应的文件格式。"
#: ../../reference/image-types.rst:18
msgid ""
"The *[compression type]* field specifies the compression type. Two types "
"of compressions are used: GNU\\* zip (*.gz*) and XZ (*.xz*)."
msgstr "*[compression type]* 字段指定压缩类型。使用的压缩类型有两种:GNU\\* zip (*.gz*) 和 XZ (*.xz*)。"
#: ../../reference/image-types.rst:23
msgid ""
"Table 1 lists the currently available images that are platform "
"independent. Table 2 lists the currently available images that are "
"platform specific."
msgstr "表 1 列出了当前可用的独立于平台的映像。表 2 列出了当前可用的特定于平台的映像。"
#: ../../reference/image-types.rst:26
msgid "Table 1: Types of platform-independent |CL| images"
msgstr "表 1:独立于平台的 |CL| 映像类型"
#: ../../reference/image-types.rst:30 ../../reference/image-types.rst:43
msgid "Image Type"
msgstr "映像类型"
#: ../../reference/image-types.rst:31 ../../reference/image-types.rst:44
msgid "Description"
msgstr "描述"
#: ../../reference/image-types.rst:33
msgid "live-desktop.img or live-desktop.iso"
msgstr "live-desktop.img 或 live-desktop.iso"
#: ../../reference/image-types.rst:34
msgid "Image for booting to GNOME\\* desktop to preview or install the OS."
msgstr "用于引导至 GNOME\\* 桌面进行预览或安装操作系统的映像。"
#: ../../reference/image-types.rst:36
msgid "live-server.img or live-server.iso"
msgstr "live-server.img 或 live-server.iso"
#: ../../reference/image-types.rst:37
msgid "Image for booting to server command prompt to preview or install the OS."
msgstr "用于引导至服务器命令提示符进行预览或安装操作系统的映像。"
#: ../../reference/image-types.rst:39
msgid "Table 2: Types of platform-specific |CL| images"
msgstr "表 2:特定于平台的 |CL| 映像类型"
#: ../../reference/image-types.rst:46
msgid "aws.img"
msgstr "aws.img"
#: ../../reference/image-types.rst:47
msgid "Image suitable for use with Amazon\\* AWS\\*."
msgstr "适用于 Amazon\\* AWS\\* 的映像。"
#: ../../reference/image-types.rst:49
msgid "azure.vhd"
msgstr "azure.vhd"
#: ../../reference/image-types.rst:50
msgid "Virtual Hard Disk for use on Microsoft\\* Azure\\* cloud platform."
msgstr "适用于 Microsoft\\* Azure\\* 云平台的虚拟硬盘。"
#: ../../reference/image-types.rst:52
msgid "azure-docker.vhd"
msgstr "azure-docker.vhd"
#: ../../reference/image-types.rst:53
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with "
"Docker\\* pre-installed."
msgstr "适用于预装 Docker\\* 的 Microsoft Azure 云平台的虚拟硬盘。"
#: ../../reference/image-types.rst:55
msgid "azure-machine-learning.vhd"
msgstr "azure-machine-learning.vhd"
#: ../../reference/image-types.rst:56
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with the "
"`machine-learning-basic` bundle installed."
msgstr "适用于安装 `machine-learning-basic` 捆绑包 的 Microsoft Azure 云平台的虚拟硬盘。"
#: ../../reference/image-types.rst:58
msgid "cloudguest.img"
msgstr "cloudguest.img"
#: ../../reference/image-types.rst:59
msgid ""
"Image with generic cloud guest virtual machine (VM) requirements "
"installed."
msgstr "安装了通用云来宾虚拟机 (VM) 的映像。"
#: ../../reference/image-types.rst:61
msgid "gce.tar"
msgstr "gce.tar"
#: ../../reference/image-types.rst:62
msgid "Image with the Google Compute Engine (GCE) specific kernel."
msgstr "带有 Google 计算引擎 (GCE) 特定内核的映像。"
#: ../../reference/image-types.rst:64
msgid "hyperv.vhdx"
msgstr "hyperv.vhdx"
#: ../../reference/image-types.rst:65
msgid ""
"Virtual Hard Disk for use with Microsoft Hyper-V\\* hypervisor. Includes "
"`optimized kernel`_ for Hyper-V."
msgstr "与 Microsoft Hyper-V\\* 虚拟机管理程序一起使用的虚拟硬盘。包括针对 Hyper-V `optimized kernel`_"
#: ../../reference/image-types.rst:67
msgid "kvm.img"
msgstr "kvm.img"
#: ../../reference/image-types.rst:68
msgid ""
"Image for booting in a simple VM with start_qemu.sh. Includes `optimized "
"kernel`_ for KVM."
msgstr "用于使用 start_qemu.sh 在简单虚拟机中引导的映像。包括针对 KVM `optimized kernel`_。"
#: ../../reference/image-types.rst:71
msgid "kvm-legacy.img"
msgstr "kvm-legacy.img"
#: ../../reference/image-types.rst:72
msgid ""
"Image for booting in a simple VM using legacy BIOS, if using "
"start_qemu.sh make sure to remove -bios parameter."
msgstr "用于使用传统 BIOS 在简单虚拟机中引导的映像;如果使用 start_qemu.sh,请确保移除 -bios 参数。"
#: ../../reference/image-types.rst:74
msgid "pxe.tar"
msgstr "pxe.tar"
#: ../../reference/image-types.rst:75
msgid "Image suitable for use with PXE server."
msgstr "适用于 PXE 服务器的映像。"
#: ../../reference/image-types.rst:77
msgid "vmware.vmdk"
msgstr "vmware.vmdk"
#: ../../reference/image-types.rst:78
msgid ""
"Virtual Machine Disk for VMware\\* platforms inclduing Player, "
"Workstation, and ESXi."
msgstr "面向包括 Player、Workstation 和 ESXi 在内的 VMware\\* 平台的虚拟机磁盘。"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:23
msgid "Verify the integrity of the |CL| image"
msgstr "确认 |CL| 映像的完整性。"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:25
msgid ""
"Before you use a downloaded |CL| image, verify its integrity. This action"
" eliminates the small chance of a corrupted image due to download issues."
" To support verification, each released |CL| image has a corresponding "
"SHA512 checksum file designated with the suffix `-SHA512SUMS`."
msgstr "在使用下载的 |CL| 映像之前,请确认其完整性。本操作消除了由于下载错误导致的罕见映像损坏。为支持确认,每个释放的 |CL| 映像均有一个相应的 SHA512 校验和 (checksum) 文件,其指定后缀为 `-SHA512SUMS`。"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:30
msgid "Download the corresponding SHA512 checksum file of your |CL| image."
msgstr "下载与您的 |CL| 映像相应的 SHA512 校验和文件。"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:31
#: ../../guides/maintenance/download-verify-decompress-linux.rst:57
msgid "Start a terminal emulator."
msgstr "启动一个终端模拟器。"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:32
msgid "Go to the directory with the downloaded image and checksum files."
msgstr "转到含有下载映像和校验和文件的目录。"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:33
msgid ""
"Verify the integrity of the image and compare it to its original checksum"
" with the command:"
msgstr "验证映像的完整性,并使用以下命令将其与原始校验和进行比较:"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:40
msgid ""
"If the checksum of the downloaded image is different than the original "
"checksum, a warning is displayed with a message indicating the computed "
"checksum does **not** match. Otherwise, the name of the image is printed "
"on the screen followed by `OK`."
msgstr "如果下载的映像的校验和不同于原始校验和,则会显示一条警告消息,指示计算的校验和**不**匹配。如果校验和匹配,映像的名称会打印在屏幕上,而且后跟 `OK`。"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:45
msgid ""
"For a more in-depth discussion of image verification including checking "
"the certificate see :ref:`image-content-validation`."
msgstr "有关映像验证(包括检查证书)的更深入讨论,请参阅 :ref:`image-content-validation`。"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:51
msgid "Decompress the |CL| image"
msgstr "解压 |CL| 映像"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:53
msgid ""
"Released |CL| images are compressed with either GNU zip (*.gz*) or XZ "
"(*.xz*). The compression type depends on the target platform or "
"environment. To decompress the image, follow these steps:"
msgstr "释放的 |CL| 映像以 GNU zip (*.gz*) 或 XZ (*.xz*) 格式压缩。压缩类型取决于目标平台或环境。要解压映像,应遵循这些步骤:"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:58
msgid "Go to the directory with the downloaded image."
msgstr "转到下载映像所在的目录。"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:60
msgid "To decompress an XZ image, enter:"
msgstr "要解压 XZ 映像,输入:"
#: ../../guides/maintenance/download-verify-decompress-linux.rst:66
msgid "To decompress a GZ image, enter:"
msgstr "要解压 GZ 映像,输入:"
@@ -0,0 +1,272 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: 2019-08-02 16:09-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:4
msgid "Download, verify, and decompress a |CL-ATTR| image on macOS\\*"
msgstr "在 macOS\\* 上下载、验证和解压缩 |CL-ATTR| 映像"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:6
msgid ""
"This guide describes the types of |CL| images available, where to "
"download them, how to verify the integrity of an image, and how to "
"decompress it."
msgstr "本指南介绍可用 |CL| 映像的类型、从哪里下载它们、如何验证映像的完整性以及如何解压缩映像。"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:9
msgid "Instructions for other operating systems are available:"
msgstr "适用于其他操作系统的说明如下:"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:11
msgid ":ref:`download-verify-decompress-linux`"
msgstr ":ref:`download-verify-decompress-linux`"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:12
msgid ":ref:`download-verify-decompress-windows`"
msgstr ":ref:`download-verify-decompress-windows`"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:15
msgid "Image types"
msgstr "映像类型"
#: ../../reference/image-types.rst:3
msgid ""
"|CL-ATTR| offers many types of `images`_ for different platforms and "
"environments."
msgstr "|CL-ATTR| 为不同平台和环境提供多种类型的 `images`_。"
#: ../../reference/image-types.rst:7
msgid "The naming convention of a |CL| image filename is:"
msgstr "|CL| 映像文件名的命名约定是:"
#: ../../reference/image-types.rst:13
msgid "The *[version number]* field specifies the version number."
msgstr "*[version number]* 字段指定版本号。"
#: ../../reference/image-types.rst:15
msgid ""
"The *[image type]* field specifies the type of image and its "
"corresponding file format."
msgstr "*[image type]* 字段指定映像类型及其相应的文件格式。"
#: ../../reference/image-types.rst:18
msgid ""
"The *[compression type]* field specifies the compression type. Two types "
"of compressions are used: GNU\\* zip (*.gz*) and XZ (*.xz*)."
msgstr "*[compression type]* 字段指定压缩类型。使用的压缩类型有两种:GNU\\* zip (*.gz*) 和 XZ (*.xz*)。"
#: ../../reference/image-types.rst:23
msgid ""
"Table 1 lists the currently available images that are platform "
"independent. Table 2 lists the currently available images that are "
"platform specific."
msgstr "表 1 列出了当前可用的独立于平台的映像。表 2 列出了当前可用的特定于平台的映像。"
#: ../../reference/image-types.rst:26
msgid "Table 1: Types of platform-independent |CL| images"
msgstr "表 1:独立于平台的 |CL| 映像类型"
#: ../../reference/image-types.rst:30 ../../reference/image-types.rst:43
msgid "Image Type"
msgstr "映像类型"
#: ../../reference/image-types.rst:31 ../../reference/image-types.rst:44
msgid "Description"
msgstr "描述"
#: ../../reference/image-types.rst:33
msgid "live-desktop.img or live-desktop.iso"
msgstr "live-desktop.img 或 live-desktop.iso"
#: ../../reference/image-types.rst:34
msgid "Image for booting to GNOME\\* desktop to preview or install the OS."
msgstr "用于引导至 GNOME\\* 桌面进行预览或安装操作系统的映像。"
#: ../../reference/image-types.rst:36
msgid "live-server.img or live-server.iso"
msgstr "live-server.img 或 live-server.iso"
#: ../../reference/image-types.rst:37
msgid "Image for booting to server command prompt to preview or install the OS."
msgstr "用于引导至服务器命令提示符进行预览或安装操作系统的映像。"
#: ../../reference/image-types.rst:39
msgid "Table 2: Types of platform-specific |CL| images"
msgstr "表 2:特定于平台的 |CL| 映像类型"
#: ../../reference/image-types.rst:46
msgid "aws.img"
msgstr "aws.img"
#: ../../reference/image-types.rst:47
msgid "Image suitable for use with Amazon\\* AWS\\*."
msgstr "适用于 Amazon\\* AWS\\* 的映像。"
#: ../../reference/image-types.rst:49
msgid "azure.vhd"
msgstr "azure.vhd"
#: ../../reference/image-types.rst:50
msgid "Virtual Hard Disk for use on Microsoft\\* Azure\\* cloud platform."
msgstr "适用于 Microsoft\\* Azure\\* 云平台的虚拟硬盘。"
#: ../../reference/image-types.rst:52
msgid "azure-docker.vhd"
msgstr "azure-docker.vhd"
#: ../../reference/image-types.rst:53
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with "
"Docker\\* pre-installed."
msgstr "适用于预装 Docker\\* 的 Microsoft Azure 云平台的虚拟硬盘。"
#: ../../reference/image-types.rst:55
msgid "azure-machine-learning.vhd"
msgstr "azure-machine-learning.vhd"
#: ../../reference/image-types.rst:56
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with the "
"`machine-learning-basic` bundle installed."
msgstr "适用于安装 `machine-learning-basic` 捆绑包 的 Microsoft Azure 云平台的虚拟硬盘。"
#: ../../reference/image-types.rst:58
msgid "cloudguest.img"
msgstr "cloudguest.img"
#: ../../reference/image-types.rst:59
msgid ""
"Image with generic cloud guest virtual machine (VM) requirements "
"installed."
msgstr "安装了通用云来宾虚拟机 (VM) 的映像。"
#: ../../reference/image-types.rst:61
msgid "gce.tar"
msgstr "gce.tar"
#: ../../reference/image-types.rst:62
msgid "Image with the Google Compute Engine (GCE) specific kernel."
msgstr "带有 Google 计算引擎 (GCE) 特定内核的映像。"
#: ../../reference/image-types.rst:64
msgid "hyperv.vhdx"
msgstr "hyperv.vhdx"
#: ../../reference/image-types.rst:65
msgid ""
"Virtual Hard Disk for use with Microsoft Hyper-V\\* hypervisor. Includes "
"`optimized kernel`_ for Hyper-V."
msgstr "与 Microsoft Hyper-V\\* 虚拟机管理程序一起使用的虚拟硬盘。包括针对 Hyper-V `optimized kernel`_"
#: ../../reference/image-types.rst:67
msgid "kvm.img"
msgstr "kvm.img"
#: ../../reference/image-types.rst:68
msgid ""
"Image for booting in a simple VM with start_qemu.sh. Includes `optimized "
"kernel`_ for KVM."
msgstr "用于使用 start_qemu.sh 在简单虚拟机中引导的映像。包括针对 KVM `optimized kernel`_。"
#: ../../reference/image-types.rst:71
msgid "kvm-legacy.img"
msgstr "kvm-legacy.img"
#: ../../reference/image-types.rst:72
msgid ""
"Image for booting in a simple VM using legacy BIOS, if using "
"start_qemu.sh make sure to remove -bios parameter."
msgstr "用于使用传统 BIOS 在简单虚拟机中引导的映像;如果使用 start_qemu.sh,请确保移除 -bios 参数。"
#: ../../reference/image-types.rst:74
msgid "pxe.tar"
msgstr "pxe.tar"
#: ../../reference/image-types.rst:75
msgid "Image suitable for use with PXE server."
msgstr "适用于 PXE 服务器的映像。"
#: ../../reference/image-types.rst:77
msgid "vmware.vmdk"
msgstr "vmware.vmdk"
#: ../../reference/image-types.rst:78
msgid ""
"Virtual Machine Disk for VMware\\* platforms inclduing Player, "
"Workstation, and ESXi."
msgstr "面向包括 Player、Workstation 和 ESXi 在内的 VMware\\* 平台的虚拟机磁盘。"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:23
msgid "Verify the integrity of the |CL| image"
msgstr "确认 |CL| 映像的完整性。"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:25
msgid ""
"Before you use a downloaded |CL| image, verify its integrity. This action"
" eliminates the small chance of a corrupted image due to download issues."
" To support verification, each released |CL| image has a corresponding "
"SHA512 checksum file designated with the suffix `-SHA512SUMS`."
msgstr "在使用下载的 |CL| 映像之前,请确认其完整性。本操作消除了由于下载错误导致的罕见映像损坏。为支持确认,每个释放的 |CL| 映像均有一个相应的 SHA512 校验和 (checksum) 文件,其指定后缀为 `-SHA512SUMS`。"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:30
msgid "Download the corresponding SHA512 checksum file of your |CL| image."
msgstr "下载与您的 |CL| 映像相应的 SHA512 校验和文件。"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:31
#: ../../guides/maintenance/download-verify-decompress-mac.rst:51
msgid "Start the Terminal app."
msgstr "启动终端应用程序。"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:32
msgid "Go to the directory with the downloaded image and checksum files."
msgstr "转到含有下载映像和校验和文件的目录。"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:33
msgid ""
"Verify the integrity of the image and compare it to its original checksum"
" with the command:"
msgstr "验证映像的完整性,并使用以下命令将其与原始校验和进行比较:"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:40
msgid ""
"If the checksum of the downloaded image is different than the original "
"checksum, the differences will be displayed. Otherwise, an empty output "
"indicates a match and your downloaded image is good."
msgstr "如果下载的映像的校验和与原始校验和不同,将显示差异。否则,空输出表示校验和匹配,说明下载的映像完好。"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:45
msgid "Decompress the |CL| image"
msgstr "解压 |CL| 映像"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:47
msgid ""
"We compress all released |CL| images by default with either GNU zip "
"(`.gz`) or xz (`.xz`). The compression type we use depends on the target "
"platform or environment. To decompress the image, follow these steps:"
msgstr "默认情况下,我们使用 GNU zip (`.gz`) 或 xz (`.xz`) 压缩所有发布的 |CL| 映像。我们使用的压缩类型取决于目标平台或环境。要解压映像,应遵循这些步骤:"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:52
msgid "Go to the directory with the downloaded image."
msgstr "转到下载映像所在的目录。"
#: ../../guides/maintenance/download-verify-decompress-mac.rst:53
msgid ""
"Use the :command:`gunzip` command to decompress either compression type. "
"For example:"
msgstr "使用 :command:`gunzip` command 命令解压缩任一种压缩类型。例如:"
@@ -0,0 +1,276 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: 2019-08-02 16:09-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:4
msgid "Download, verify, and decompress a |CL-ATTR| image on Windows\\*"
msgstr "在 Windows\\* 上下载、验证和解压缩 |CL-ATTR| 映像"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:6
msgid ""
"This guide describes the types of |CL-ATTR| images available, where to "
"download them, how to verify the integrity of an image, and how to "
"decompress it."
msgstr "本指南介绍可用 |CL-ATTR| 映像的类型、从哪里下载它们、如何验证映像的完整性以及如何解压缩映像。"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:9
msgid "Instructions for other operating systems are available:"
msgstr "适用于其他操作系统的说明如下:"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:11
msgid ":ref:`download-verify-decompress-linux`"
msgstr ":ref:`download-verify-decompress-linux`"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:12
msgid ":ref:`download-verify-decompress-mac`"
msgstr ":ref:`download-verify-decompress-mac`"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:15
msgid "Image types"
msgstr "映像类型"
#: ../../reference/image-types.rst:3
msgid ""
"|CL-ATTR| offers many types of `images`_ for different platforms and "
"environments."
msgstr "|CL-ATTR| 为不同平台和环境提供多种类型的 `images`_。"
#: ../../reference/image-types.rst:7
msgid "The naming convention of a |CL| image filename is:"
msgstr "|CL| 映像文件名的命名约定是:"
#: ../../reference/image-types.rst:13
msgid "The *[version number]* field specifies the version number."
msgstr "*[version number]* 字段指定版本号。"
#: ../../reference/image-types.rst:15
msgid ""
"The *[image type]* field specifies the type of image and its "
"corresponding file format."
msgstr "*[image type]* 字段指定映像类型及其相应的文件格式。"
#: ../../reference/image-types.rst:18
msgid ""
"The *[compression type]* field specifies the compression type. Two types "
"of compressions are used: GNU\\* zip (*.gz*) and XZ (*.xz*)."
msgstr "*[compression type]* 字段指定压缩类型。使用的压缩类型有两种:GNU\\* zip (*.gz*) 和 XZ (*.xz*)。"
#: ../../reference/image-types.rst:23
msgid ""
"Table 1 lists the currently available images that are platform "
"independent. Table 2 lists the currently available images that are "
"platform specific."
msgstr "表 1 列出了当前可用的独立于平台的映像。表 2 列出了当前可用的特定于平台的映像。"
#: ../../reference/image-types.rst:26
msgid "Table 1: Types of platform-independent |CL| images"
msgstr "表 1:独立于平台的 |CL| 映像类型"
#: ../../reference/image-types.rst:30 ../../reference/image-types.rst:43
msgid "Image Type"
msgstr "映像类型"
#: ../../reference/image-types.rst:31 ../../reference/image-types.rst:44
msgid "Description"
msgstr "描述"
#: ../../reference/image-types.rst:33
msgid "live-desktop.img or live-desktop.iso"
msgstr "live-desktop.img 或 live-desktop.iso"
#: ../../reference/image-types.rst:34
msgid "Image for booting to GNOME\\* desktop to preview or install the OS."
msgstr "用于引导至 GNOME\\* 桌面进行预览或安装操作系统的映像。"
#: ../../reference/image-types.rst:36
msgid "live-server.img or live-server.iso"
msgstr "live-server.img 或 live-server.iso"
#: ../../reference/image-types.rst:37
msgid "Image for booting to server command prompt to preview or install the OS."
msgstr "用于引导至服务器命令提示符进行预览或安装操作系统的映像。"
#: ../../reference/image-types.rst:39
msgid "Table 2: Types of platform-specific |CL| images"
msgstr "表 2:特定于平台的 |CL| 映像类型"
#: ../../reference/image-types.rst:46
msgid "aws.img"
msgstr "aws.img"
#: ../../reference/image-types.rst:47
msgid "Image suitable for use with Amazon\\* AWS\\*."
msgstr "适用于 Amazon\\* AWS\\* 的映像。"
#: ../../reference/image-types.rst:49
msgid "azure.vhd"
msgstr "azure.vhd"
#: ../../reference/image-types.rst:50
msgid "Virtual Hard Disk for use on Microsoft\\* Azure\\* cloud platform."
msgstr "适用于 Microsoft\\* Azure\\* 云平台的虚拟硬盘。"
#: ../../reference/image-types.rst:52
msgid "azure-docker.vhd"
msgstr "azure-docker.vhd"
#: ../../reference/image-types.rst:53
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with "
"Docker\\* pre-installed."
msgstr "适用于预装 Docker\\* 的 Microsoft Azure 云平台的虚拟硬盘。"
#: ../../reference/image-types.rst:55
msgid "azure-machine-learning.vhd"
msgstr "azure-machine-learning.vhd"
#: ../../reference/image-types.rst:56
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with the "
"`machine-learning-basic` bundle installed."
msgstr "适用于安装 `machine-learning-basic` 捆绑包 的 Microsoft Azure 云平台的虚拟硬盘。"
#: ../../reference/image-types.rst:58
msgid "cloudguest.img"
msgstr "cloudguest.img"
#: ../../reference/image-types.rst:59
msgid ""
"Image with generic cloud guest virtual machine (VM) requirements "
"installed."
msgstr "安装了通用云来宾虚拟机 (VM) 的映像。"
#: ../../reference/image-types.rst:61
msgid "gce.tar"
msgstr "gce.tar"
#: ../../reference/image-types.rst:62
msgid "Image with the Google Compute Engine (GCE) specific kernel."
msgstr "带有 Google 计算引擎 (GCE) 特定内核的映像。"
#: ../../reference/image-types.rst:64
msgid "hyperv.vhdx"
msgstr "hyperv.vhdx"
#: ../../reference/image-types.rst:65
msgid ""
"Virtual Hard Disk for use with Microsoft Hyper-V\\* hypervisor. Includes "
"`optimized kernel`_ for Hyper-V."
msgstr "与 Microsoft Hyper-V\\* 虚拟机管理程序一起使用的虚拟硬盘。包括针对 Hyper-V `optimized kernel`_"
#: ../../reference/image-types.rst:67
msgid "kvm.img"
msgstr "kvm.img"
#: ../../reference/image-types.rst:68
msgid ""
"Image for booting in a simple VM with start_qemu.sh. Includes `optimized "
"kernel`_ for KVM."
msgstr "用于使用 start_qemu.sh 在简单虚拟机中引导的映像。包括针对 KVM `optimized kernel`_。"
#: ../../reference/image-types.rst:71
msgid "kvm-legacy.img"
msgstr "kvm-legacy.img"
#: ../../reference/image-types.rst:72
msgid ""
"Image for booting in a simple VM using legacy BIOS, if using "
"start_qemu.sh make sure to remove -bios parameter."
msgstr "用于使用传统 BIOS 在简单虚拟机中引导的映像;如果使用 start_qemu.sh,请确保移除 -bios 参数。"
#: ../../reference/image-types.rst:74
msgid "pxe.tar"
msgstr "pxe.tar"
#: ../../reference/image-types.rst:75
msgid "Image suitable for use with PXE server."
msgstr "适用于 PXE 服务器的映像。"
#: ../../reference/image-types.rst:77
msgid "vmware.vmdk"
msgstr "vmware.vmdk"
#: ../../reference/image-types.rst:78
msgid ""
"Virtual Machine Disk for VMware\\* platforms inclduing Player, "
"Workstation, and ESXi."
msgstr "面向包括 Player、Workstation 和 ESXi 在内的 VMware\\* 平台的虚拟机磁盘。"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:23
msgid "Verify the integrity of the |CL| image"
msgstr "确认 |CL| 映像的完整性。"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:25
msgid ""
"Before you use a downloaded |CL| image, verify its integrity. This action"
" eliminates the small chance of a corrupted image due to download issues."
" To support verification, each released |CL| image has a corresponding "
"SHA512 checksum file designated with the suffix `-SHA512SUMS`."
msgstr "在使用下载的 |CL| 映像之前,请确认其完整性。本操作消除了由于下载错误导致的罕见映像损坏。为支持确认,每个释放的 |CL| 映像均有一个相应的 SHA512 校验和 (checksum) 文件,其指定后缀为 `-SHA512SUMS`。"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:30
msgid "Download the corresponding SHA512 checksum file of your |CL| image."
msgstr "下载与您的 |CL| 映像相应的 SHA512 校验和文件。"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:31
msgid "Start Command Prompt."
msgstr "启动命令提示符。"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:32
msgid "Go to the directory with the downloaded image and checksum files."
msgstr "转到含有下载映像和校验和文件的目录。"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:33
msgid "Get the SHA512 checksum of the image with the command:"
msgstr "利用该命令获取该映像的 SHA512 校验和:"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:39
msgid ""
"Manually compare the output with the original checksum value shown in the"
" downloaded checksum file and make sure they match."
msgstr "手动比较该结果与所下载校验和文件中所示的原始校验和值,确保它们相匹配。"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:43
msgid "Decompress the |CL| image"
msgstr "解压 |CL| 映像"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:45
msgid ""
"Released |CL| images are compressed with either GNU zip (*.gz*) or XZ "
"(*.xz*). The compression type depends on the target platform or "
"environment. To decompress the image, follow these steps:"
msgstr "释放的 |CL| 映像以 GNU zip (*.gz*) 或 XZ (*.xz*) 格式压缩。压缩类型取决于目标平台或环境。要解压映像,应遵循这些步骤:"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:49
msgid "Download and install `7-Zip`_."
msgstr "下载并安装 `7-Zip`_。"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:50
msgid "Go to the directory with the downloaded image and right-click it."
msgstr "转到含有下载映像的目录并右键点击它。"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:51
msgid ""
"From the pop-up menu, select :guilabel:`7-Zip` and select "
":guilabel:`Extract Here` as shown in Figure 1."
msgstr "从弹出菜单中选择 :guilabel:`7-Zip`,然后选择 :guilabel:`Extract Here`,如图 1 所示。"
#: ../../guides/maintenance/download-verify-decompress-windows.rst:58
msgid "Figure 1: Windows 7-Zip extract file."
msgstr "图 1Windows 7-Zip 提取文件。"
@@ -0,0 +1,430 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-09-06 11:29-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0152\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh_Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=1; plural=0\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/download-verify-decompress.rst:4
msgid "Download, verify, and decompress a |CL-ATTR| image"
msgstr "下载、验证并解压缩 |CL-ATTR| 映像,"
#: ../../guides/maintenance/download-verify-decompress.rst:6
msgid ""
"This guide describes the available types of |CL| images, where to "
"download them, how to verify their integrity, and how to decompress them."
" Follow the steps for your OS."
msgstr "本指南介绍可用的 |CL| 映像类型,从何处下载这些映像,如何验证这些映像的完整性以及如何解压缩这些影响。遵循适用您的操作系统的步骤。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:3
#: <included from
msgid ""
"|CL-ATTR| offers many types of `images`_ for different platforms and "
"environments."
msgstr "|CL-ATTR| 为不同平台和环境提供多种类型的 `images`_。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:7
#: <included from
msgid "The naming convention of a |CL| image filename is:"
msgstr "|CL| 映像文件名的命名约定是:"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:13
#: <included from
msgid "The *[version number]* field specifies the version number."
msgstr "*[version number]* 字段指定版本号。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:15
#: <included from
msgid ""
"The *[image type]* field specifies the type of image and its "
"corresponding file format."
msgstr "*[image type]* 字段指定映像类型及其相应的文件格式。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:18
#: <included from
msgid ""
"The *[compression type]* field specifies the compression type. Two types "
"of compressions are used: GNU\\* zip (*.gz*) and XZ (*.xz*)."
msgstr "*[compression type]* 字段指定压缩类型。使用的压缩类型有两种:GNU\\* zip (*.gz*) 和 XZ (*.xz*)。"
#: ../../guides/maintenance/download-verify-decompress.rst:22
msgid "Linux OS steps"
msgstr "Linux 操作系统步骤"
#: ../../guides/maintenance/download-verify-decompress.rst:27
#: ../../guides/maintenance/download-verify-decompress.rst:86
#: ../../guides/maintenance/download-verify-decompress.rst:131
msgid "Verify the integrity of the |CL| image"
msgstr "确认 |CL| 映像的完整性"
#: ../../guides/maintenance/download-verify-decompress.rst:29
#: ../../guides/maintenance/download-verify-decompress.rst:88
#: ../../guides/maintenance/download-verify-decompress.rst:133
msgid ""
"Before you use a downloaded |CL| image, verify its integrity. This action"
" eliminates the small chance of a corrupted image due to download issues."
" To support verification, each released |CL| image has a corresponding "
"SHA512 checksum file designated with the suffix `-SHA512SUMS`."
msgstr ""
"在使用下载的 |CL| 映像之前,请确认其完整性。本操作消除了由于下载错误导致的罕见映像损坏。为支持确认,每个释放的 |CL| 映像均有一个相应的"
" SHA512 校验和 (checksum) 文件,其指定后缀为 `-SHA512SUMS`。"
#: ../../guides/maintenance/download-verify-decompress.rst:34
#: ../../guides/maintenance/download-verify-decompress.rst:93
#: ../../guides/maintenance/download-verify-decompress.rst:138
msgid "Download the corresponding SHA512 checksum file of your |CL| `image`_."
msgstr "下载与您的 |CL| `映像`_ 相应的 SHA512 校验和文件。"
#: ../../guides/maintenance/download-verify-decompress.rst:35
#: ../../guides/maintenance/download-verify-decompress.rst:61
#: ../../guides/maintenance/download-verify-decompress.rst:94
#: ../../guides/maintenance/download-verify-decompress.rst:114
msgid "Open a Terminal."
msgstr "打开终端。"
#: ../../guides/maintenance/download-verify-decompress.rst:36
#: ../../guides/maintenance/download-verify-decompress.rst:95
#: ../../guides/maintenance/download-verify-decompress.rst:140
msgid "Go to the directory with the downloaded image and checksum files."
msgstr "转到含有下载映像和校验和文件的目录。"
#: ../../guides/maintenance/download-verify-decompress.rst:37
#: ../../guides/maintenance/download-verify-decompress.rst:96
msgid ""
"Verify the integrity of the image and compare it to its original checksum"
" with the command:"
msgstr "验证映像的完整性,并使用以下命令将其与原始校验和进行比较:"
#: ../../guides/maintenance/download-verify-decompress.rst:44
msgid ""
"If the checksum of the downloaded image is different than the original "
"checksum, a warning is displayed with a message indicating the computed "
"checksum does **not** match. Otherwise, the name of the image is printed "
"on the screen followed by `OK`."
msgstr "如果下载的映像的校验和不同于原始校验和,则会显示一条警告消息,指示计算的校验和不匹配。如果校验和匹配,映像的名称会打印在屏幕上,而且后跟 `OK`。"
#: ../../guides/maintenance/download-verify-decompress.rst:49
msgid ""
"For a more in-depth discussion of image verification including checking "
"the certificate see :ref:`image-content-validation`."
msgstr "有关映像验证(包括检查证书)的更深入讨论,请参阅 :ref:`image-content-validation`。"
#: ../../guides/maintenance/download-verify-decompress.rst:55
#: ../../guides/maintenance/download-verify-decompress.rst:108
#: ../../guides/maintenance/download-verify-decompress.rst:151
msgid "Decompress the |CL| image"
msgstr "解压 |CL| 映像"
#: ../../guides/maintenance/download-verify-decompress.rst:57
#: ../../guides/maintenance/download-verify-decompress.rst:153
msgid ""
"Released |CL| images are compressed with either GNU zip (*.gz*) or XZ "
"(*.xz*). The compression type depends on the target platform or "
"environment. To decompress the image, follow these steps:"
msgstr ""
"释放的 |CL| 映像以 GNU zip (*.gz*) 或 XZ (*.xz*) "
"格式压缩。压缩类型取决于目标平台或环境。要解压映像,应遵循这些步骤:"
#: ../../guides/maintenance/download-verify-decompress.rst:62
#: ../../guides/maintenance/download-verify-decompress.rst:115
msgid "Go to the directory with the downloaded image."
msgstr "转到下载映像所在的目录。"
#: ../../guides/maintenance/download-verify-decompress.rst:64
msgid "To decompress an XZ image, enter:"
msgstr "要解压 XZ 映像,输入:"
#: ../../guides/maintenance/download-verify-decompress.rst:70
msgid "To decompress a GZ image, enter:"
msgstr "要解压 GZ 映像,输入:"
#: ../../guides/maintenance/download-verify-decompress.rst:81
msgid "macOS\\* steps"
msgstr "macOS\\* 步骤"
#: ../../guides/maintenance/download-verify-decompress.rst:103
msgid ""
"If the checksum of the downloaded image is different than the original "
"checksum, the differences will be displayed. Otherwise, an empty output "
"indicates a match and your downloaded image is good."
msgstr "如果下载的映像的校验和与原始校验和不同,将显示差异。否则,空输出表示校验和匹配,说明下载的映像完好。"
#: ../../guides/maintenance/download-verify-decompress.rst:110
msgid ""
"We compress all released |CL| images by default with either GNU zip "
"(`.gz`) or xz (`.xz`). The compression type we use depends on the target "
"platform or environment. To decompress the image, follow these steps:"
msgstr ""
"默认情况下,我们使用 GNU zip (`.gz`) 或 xz (`.xz`) 压缩所有发布的 |CL| "
"映像。我们使用的压缩类型取决于目标平台或环境。要解压映像,应遵循这些步骤:"
#: ../../guides/maintenance/download-verify-decompress.rst:116
msgid ""
"Use the :command:`gunzip` command to decompress either compression type. "
"For example:"
msgstr "使用 :command:`gunzip` command 命令解压缩任一种压缩类型。例如:"
#: ../../guides/maintenance/download-verify-decompress.rst:126
msgid "Windows\\* OS steps"
msgstr "Windows\\* 操作系统步骤"
#: ../../guides/maintenance/download-verify-decompress.rst:139
msgid "Start Command Prompt."
msgstr "启动命令提示符。"
#: ../../guides/maintenance/download-verify-decompress.rst:141
msgid "Get the SHA512 checksum of the image with the command:"
msgstr "利用该命令获取该映像的 SHA512 校验和:"
#: ../../guides/maintenance/download-verify-decompress.rst:147
msgid ""
"Manually compare the output with the original checksum value shown in the"
" downloaded checksum file and make sure they match."
msgstr "手动比较该结果与所下载校验和文件中所示的原始校验和值,确保它们相匹配。"
#: ../../guides/maintenance/download-verify-decompress.rst:157
msgid "Download and install `7-Zip`_."
msgstr "下载并安装 `7-Zip`_。"
#: ../../guides/maintenance/download-verify-decompress.rst:158
msgid "Go to the directory with the downloaded image and right-click it."
msgstr "转到含有下载映像的目录并右键点击它。"
#: ../../guides/maintenance/download-verify-decompress.rst:159
msgid ""
"From the pop-up menu, select :guilabel:`7-Zip` and select "
":guilabel:`Extract Here` as shown in Figure 1."
msgstr "从弹出菜单中选择 :guilabel:`7-Zip`,然后选择 :guilabel:`Extract Here`,如图 1 所示。"
#: ../../guides/maintenance/download-verify-decompress.rst:166
msgid "Figure 1: Windows 7-Zip extract file."
msgstr "图 1Windows 7-Zip 提取文件。"
#: ../../guides/maintenance/download-verify-decompress.rst:171
msgid "Image types"
msgstr "映像类型"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:3
#: <included from
msgid ""
"Table 1 lists the currently available images that are platform "
"independent. Table 2 lists the currently available images that are "
"platform specific."
msgstr "表 1 列出了当前可用的独立于平台的映像。表 2 列出了当前可用的特定于平台的映像。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:6
#: <included from
msgid "Table 1: Types of platform-independent |CL| images"
msgstr "表 1:独立于平台的 |CL| 映像类型"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:10
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:23
#: <included from
msgid "Image Type"
msgstr "映像类型"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:11
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:24
#: <included from
msgid "Description"
msgstr "描述"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:13
#: <included from
msgid "live-desktop.img or live-desktop.iso"
msgstr "live-desktop.img 或 live-desktop.iso"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:14
#: <included from
msgid "Image for booting to GNOME\\* desktop to preview or install the OS."
msgstr "用于引导至 GNOME\\* 桌面进行预览或安装操作系统的映像。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:16
#: <included from
msgid "live-server.img or live-server.iso"
msgstr "live-server.img 或 live-server.iso"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:17
#: <included from
msgid "Image for booting to server command prompt to preview or install the OS."
msgstr "用于引导至服务器命令提示符进行预览或安装操作系统的映像。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:19
#: <included from
msgid "Table 2: Types of platform-specific |CL| images"
msgstr "表 2:特定于平台的 |CL| 映像类型"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:26
#: <included from
msgid "aws.img"
msgstr "aws.img"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:27
#: <included from
msgid "Image suitable for use with Amazon\\* AWS\\*."
msgstr "适用于 Amazon\\* AWS\\* 的映像。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:29
#: <included from
msgid "azure.vhd"
msgstr "azure.vhd"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:30
#: <included from
msgid "Virtual Hard Disk for use on Microsoft\\* Azure\\* cloud platform."
msgstr "适用于 Microsoft\\* Azure\\* 云平台的虚拟硬盘。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:32
#: <included from
msgid "azure-docker.vhd"
msgstr "azure-docker.vhd"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:33
#: <included from
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with "
"Docker\\* pre-installed."
msgstr "适用于预装 Docker\\* 的 Microsoft Azure 云平台的虚拟硬盘。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:35
#: <included from
msgid "azure-machine-learning.vhd"
msgstr "azure-machine-learning.vhd"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:36
#: <included from
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with the "
"`machine-learning-basic` bundle installed."
msgstr "适用于安装 `machine-learning-basic` 捆绑包 的 Microsoft Azure 云平台的虚拟硬盘。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:38
#: <included from
msgid "cloudguest.img"
msgstr "cloudguest.img"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:39
#: <included from
msgid ""
"Image with generic cloud guest virtual machine (VM) requirements "
"installed."
msgstr "安装了通用云来宾虚拟机 (VM) 的映像。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:41
#: <included from
msgid "gce.tar"
msgstr "gce.tar"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:42
#: <included from
msgid "Image with the Google Compute Engine (GCE) specific kernel."
msgstr "带有 Google 计算引擎 (GCE) 特定内核的映像。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:44
#: <included from
msgid "hyperv.vhdx"
msgstr "hyperv.vhdx"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:45
#: <included from
msgid ""
"Virtual Hard Disk for use with Microsoft Hyper-V\\* hypervisor. Includes "
"`optimized kernel`_ for Hyper-V."
msgstr "与 Microsoft Hyper-V\\* 虚拟机管理程序一起使用的虚拟硬盘。包括针对 Hyper-V `optimized kernel`_"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:47
#: <included from
msgid "kvm.img"
msgstr "kvm.img"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:48
#: <included from
msgid ""
"Image for booting in a simple VM with start_qemu.sh. Includes `optimized "
"kernel`_ for KVM."
msgstr "用于使用 start_qemu.sh 在简单虚拟机中引导的映像。包括针对 KVM `optimized kernel`_。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:51
#: <included from
msgid "kvm-legacy.img"
msgstr "kvm-legacy.img"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:52
#: <included from
msgid ""
"Image for booting in a simple VM using legacy BIOS, if using "
"start_qemu.sh make sure to remove -bios parameter."
msgstr "用于使用传统 BIOS 在简单虚拟机中引导的映像;如果使用 start_qemu.sh,请确保移除 -bios 参数。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:54
#: <included from
msgid "pxe.tar"
msgstr "pxe.tar"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:55
#: <included from
msgid "Image suitable for use with PXE server."
msgstr "适用于 PXE 服务器的映像。"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:57
#: <included from
msgid "vmware.vmdk"
msgstr "vmware.vmdk"
#: ../../reference/image-types.rst
#: /mnt/c/Users/KPUTNAM/Documents/_OTC_TCS/work_dir/git_repos/clear-linux-documentation/source/guides/maintenance/download-verify-decompress.rst>:58
#: <included from
msgid ""
"Virtual Machine Disk for VMware\\* platforms inclduing Player, "
"Workstation, and ESXi."
msgstr "面向包括 Player、Workstation 和 ESXi 在内的 VMware\\* 平台的虚拟机磁盘。"
@@ -0,0 +1,224 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/maintenance/enable-user-space.rst:4
msgid "Create and enable a new user space"
msgstr "创建并启用新的用户空间"
#: ../../guides/maintenance/enable-user-space.rst:6
msgid ""
"This guide provides steps to complete the following basic setup tasks for"
" a newly installed |CL-ATTR| system:"
msgstr "本指南提供了为新安装的 |CL-ATTR| 系统完成以下基本设置任务的步骤:"
#: ../../guides/maintenance/enable-user-space.rst:14
msgid "Create a new user"
msgstr "创建新用户"
#: ../../guides/maintenance/enable-user-space.rst:16
msgid ""
"To create a new user and set a password for that user, enter the "
"following commands as a root user:"
msgstr "要创建新用户并为该用户设置密码,请以 root 用户身份输入以下命令:"
#: ../../guides/maintenance/enable-user-space.rst:24
msgid ""
"Replace the <userid> with the name of the user account you want to create"
" including the password for that user. The :command:`passwd` command "
"prompts you to enter a new password. Retype the new password for the new "
"user account just created."
msgstr "将 <userid> 替换为要创建的用户帐户的名称,包括该用户的密码。:command:`passwd` 命令会提示您输入新密码。为刚刚创建的新用户帐户重新键入新密码。"
#: ../../guides/maintenance/enable-user-space.rst:30
msgid "Add the new user to the *wheel* group"
msgstr "将新用户添加到 wheel 组"
#: ../../guides/maintenance/enable-user-space.rst:32
msgid ""
"Before logging off as root and logging into your new user account, enable"
" the :command:`sudo` command for your new <userid>."
msgstr "以 root 用户身份注销并登录到新用户帐户之前,请为新的 <userid> 启用 :command:`sudo` 命令。"
#: ../../guides/maintenance/enable-user-space.rst:35
msgid ""
"To be able to execute all applications with root privileges, add the "
"<userid> to the `wheel group`_."
msgstr "为了能以 root 特权执行所有应用程序,请将 <userid> 添加到 `wheel group`_。"
#: ../../guides/maintenance/enable-user-space.rst:38
msgid "Add <userid> to the wheel group:"
msgstr "将 <userid> 添加到 wheel 组:"
#: ../../guides/maintenance/enable-user-space.rst:44
msgid "Log out of root and into the new <userid>."
msgstr "以 root 用户身份注销并登录新的 <userid>。"
#: ../../guides/maintenance/enable-user-space.rst:46
msgid "To log off as root, enter :command:`exit`."
msgstr "要以 root 用户身份注销,请输入 :command:`exit`。"
#: ../../guides/maintenance/enable-user-space.rst:48
msgid "Enter the new <userid> and the password created earlier."
msgstr "输入之前创建的新 <userid> 和密码。"
#: ../../guides/maintenance/enable-user-space.rst:50
msgid "You will now be in the home directory of <userid>."
msgstr "您现在将处于 <userid> 主目录中。"
#: ../../guides/maintenance/enable-user-space.rst:53
msgid "Install and update the OS software to its current version"
msgstr "安装操作系统软件并将其更新到最新版本"
#: ../../guides/maintenance/enable-user-space.rst:55
msgid ""
"The |CL| software utility :ref:`swupd <swupd-guide>` allows you to "
"perform system updates while reaping the benefits of upstream "
"development."
msgstr "使用 |CL| 软件实用程序 :ref:`swupd <swupd-guide>` 能够执行系统更新,利用上游开发成果。"
#: ../../guides/maintenance/enable-user-space.rst:58
msgid "To update your newly installed OS, run:"
msgstr "要更新新安装的操作系统,请运行:"
#: ../../guides/maintenance/enable-user-space.rst:65
msgid "Add a bundle"
msgstr "添加捆绑包"
#: ../../guides/maintenance/enable-user-space.rst:67
msgid ""
"Software applications are installed as bundles using the command "
":command:`swupd bundle-add`. Experienced Linux users might compare swupd "
"to running :command:`apt-get` or :command:`yum install` for package "
"management. However |CL| manages packages at the level of bundles, which "
"are integrated stacks of packages."
msgstr "软件应用程序使用 :command:`swupd bundle-add` 命令作为捆绑包安装。经验丰富的 Linux 用户可能会将 swupd 与运行用于包管理的 :command:`apt-get` 或 :command:`yum install` 加以比较。但是 |CL| 在捆绑包(即集成的包堆栈)级别管理包。"
#: ../../guides/maintenance/enable-user-space.rst:73
msgid ""
"For example, the :command:`sysadmin-basic` bundle installs the majority "
"of applications useful to a system administrator. To install it, enter:"
msgstr "例如,:command:`sysadmin-basic` 捆绑包会安装对系统管理员有用的大多数应用程序。要安装它,请输入:"
#: ../../guides/maintenance/enable-user-space.rst:80
msgid ""
"View a full list of bundles and packages installed with the `sysadmin-"
"basic`_ bundle. You can also view all `bundles`_ for |CL|, active or "
"deprecated."
msgstr "查看与 `sysadmin-basic`_ 捆绑包一起安装的捆绑包和软件包完整列表。您还可以查看适用于 |CL| 的所有 `bundles`_,包括活动或弃用的捆绑包。"
#: ../../guides/maintenance/enable-user-space.rst:83
msgid ""
"Expand your knowledge of :command:`swupd` and check out our developer "
"resources:"
msgstr "加深对 :command:`swupd` 的认识,查看我们的开发人员资源:"
#: ../../guides/maintenance/enable-user-space.rst:85
msgid ":ref:`swupd-guide`"
msgstr ":ref:`swupd-guide`"
#: ../../guides/maintenance/enable-user-space.rst:86
msgid ":ref:`developer-workstation`"
msgstr ":ref:`developer-workstation`"
#: ../../guides/maintenance/enable-user-space.rst:89
msgid "Next steps"
msgstr "后续步骤"
#: ../../guides/maintenance/enable-user-space.rst:91
msgid "Check out our guides and tutorials."
msgstr "查看我们的指南和教程。"
#: ../../guides/maintenance/enable-user-space.rst:93
msgid ":ref:`guides`"
msgstr ":ref:`guides`"
#: ../../guides/maintenance/enable-user-space.rst:94
msgid ":ref:`tutorials`"
msgstr ":ref:`tutorials`"
#~ msgid ""
#~ "View a full list of bundles and"
#~ " packages installed with the `sysadmin-"
#~ "basic`_ bundle. You can also view "
#~ "`all bundles`_ for |CL|, active or "
#~ "deprecated."
#~ msgstr ""
#~ msgid ""
#~ "This section provides steps to complete"
#~ " the following basic setup tasks for"
#~ " a newly installed |CL-ATTR| system:"
#~ msgstr ""
#~ msgid ""
#~ "To create a new user and set "
#~ "a password for that user, enter "
#~ "the following commands as a `root` "
#~ "user:"
#~ msgstr ""
#~ msgid "Add the new user to the `wheel` group"
#~ msgstr ""
#~ msgid ""
#~ "Before logging off as root and "
#~ "logging into your new user account, "
#~ "enable the :command:`sudo` command for "
#~ "your new `<userid>`."
#~ msgstr ""
#~ msgid ""
#~ "To be able to execute all "
#~ "applications with root privileges, add "
#~ "the `<userid>` to the `wheel group`_."
#~ msgstr ""
#~ msgid "Add `<userid>` to the `wheel` group:"
#~ msgstr ""
#~ msgid "Log out of root and into the new `<userid>`."
#~ msgstr ""
#~ msgid "Enter the new `<userid>` and the password created earlier."
#~ msgstr ""
#~ msgid "You will now be in the home directory of `<userid>`."
#~ msgstr ""
#~ msgid ""
#~ "Software applications are installed as "
#~ "bundles using the command :command:`swupd "
#~ "bundle-add`. Experienced Linux* users "
#~ "might compare `swupd` to running "
#~ ":command:`apt-get` or :command:`yum install`"
#~ " for package management. Yet |CL| "
#~ "manages packages at the level of "
#~ "bundles, which are integrated stacks of"
#~ " packages."
#~ msgstr ""
#~ msgid ""
#~ "For example, the `sysadmin-basic` bundle"
#~ " installs the majority of applications "
#~ "useful to a system administrator. To "
#~ "install it, enter:"
#~ msgstr ""
@@ -0,0 +1,206 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/maintenance/fix-broken-install.rst:4
msgid "Fix a broken installation"
msgstr "修复损坏的安装"
#: ../../guides/maintenance/fix-broken-install.rst:6
msgid ""
"This guide explains how to fix a broken installation of |CL-ATTR| using a"
" live desktop image on a USB."
msgstr "本指南介绍如何使用 USB 上的实时桌面映像修复损坏的 |CL-ATTR| 安装。"
#: ../../guides/maintenance/fix-broken-install.rst:14
msgid "Overview"
msgstr "概述"
#: ../../guides/maintenance/fix-broken-install.rst:16
msgid ""
"This guide assumes you have installed |CL| on a target system, but the OS"
" does not boot or function properly."
msgstr "本指南假设您已经在目标系统上安装了 |CL|,但是操作系统无法正常引导或运行。"
#: ../../guides/maintenance/fix-broken-install.rst:19
msgid ""
"The process described in this guide can only verify and fix files that "
":ref:`swupd<swupd-guide>` owns in :file:`/usr`. Files outside of this "
"path, such as :file:`/home/`, :file:`/etc`, :file:`/var`, etc., cannot be"
" repaired by this process."
msgstr "本指南中介绍的过程只能验证和修复 :ref:`swupd<swupd-guide>` 在 :file:`/usr` 中拥有的文件。此路径之外的文件,如 :file:`/home/`、:file:`/etc`、:file:`/var` 等无法通过此过程修复。"
#: ../../guides/maintenance/fix-broken-install.rst:25
msgid "Prerequisites"
msgstr "必备条件"
#: ../../guides/maintenance/fix-broken-install.rst:27
msgid ""
"Download and install the live desktop image on a USB. See :ref:`bare-"
"metal-install-desktop` for install instructions."
msgstr "下载并在 USB 上安装实时桌面映像。有关安装说明,请参阅 :ref:`bare-metal-install-desktop`。"
#: ../../guides/maintenance/fix-broken-install.rst:31
msgid "Boot a live desktop image to fix target system"
msgstr "引导实时桌面映像来修复目标系统"
#: ../../guides/maintenance/fix-broken-install.rst:33
msgid "Boot the |CL| live desktop image."
msgstr "引导 |CL| 实时桌面映像。"
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:4
msgid "Install from live image"
msgstr "从实时映像安装"
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:6
msgid ""
"After you download and burn the live desktop image on a USB drive, follow"
" these steps."
msgstr "下载实时桌面映像并将其刻录到 USB 驱动器后,请按照以下步骤操作。"
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:9
msgid "Insert the USB drive into an available USB slot."
msgstr "将 USB 驱动器插入可用的 USB 插槽。"
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:11
msgid "Power on the system."
msgstr "打开系统电源。"
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:13
msgid ""
"Open the system BIOS setup menu by pressing the :kbd:`F2` key. Your BIOS "
"setup menu entry point may vary."
msgstr "按 :kbd:`F2` 键打开系统 BIOS 设置菜单。您的 BIOS 设置菜单入口点可能会有所不同。"
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:16
msgid ""
"In the setup menu, enable the UEFI boot and set the USB drive as the "
"first option in the device boot order."
msgstr "在设置菜单中,启用 UEFI 引导,并在设备引导顺序中将 USB 驱动器设置为第一个选项。"
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:19
msgid "Save these settings, e.g. :kbd:`F10`, and exit."
msgstr "保存这些设置,例如按 :kbd:`F10`,然后退出。"
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:21
msgid "Reboot the target system."
msgstr "重新引导目标系统。"
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:23
msgid "Select :guilabel:`Clear Linux OS` in the boot menu, shown in Figure 1."
msgstr "在引导菜单中选择 :guilabel:`Clear Linux OS`,如图 1 所示。"
#: ../../get-started/bare-metal-install-desktop/bare-metal-install-desktop.rst:29
msgid "Figure 1: Clear Linux OS in boot menu"
msgstr "图 1:引导菜单中的 Clear Linux OS"
#: ../../guides/maintenance/fix-broken-install.rst:40
msgid "Mount root partition, verify, and fix"
msgstr "挂载根分区,然后验证并修复"
#: ../../guides/maintenance/fix-broken-install.rst:42
msgid "Open a Terminal window."
msgstr "打开一个终端窗口。"
#: ../../guides/maintenance/fix-broken-install.rst:44
msgid "Ensure the system is connected to the network."
msgstr "确保系统已连接到网络。"
#: ../../guides/maintenance/fix-broken-install.rst:46
msgid "Mount the systems root partition."
msgstr "挂载系统的根分区。"
#: ../../guides/maintenance/fix-broken-install.rst:48
msgid "To find the root partition, run:"
msgstr "要查找根分区,请运行:"
#: ../../guides/maintenance/fix-broken-install.rst:54
msgid "We'll use :file:`/dev/sda3/` as the root partition example."
msgstr "我们将使用 :file:`/dev/sda3/` 作为根分区示例。"
#: ../../guides/maintenance/fix-broken-install.rst:56
msgid "Next, mount the partition to the :file:`/mnt` folder."
msgstr "接下来,将分区挂载到 :file:`/mnt` 文件夹。"
#: ../../guides/maintenance/fix-broken-install.rst:62
msgid ""
"Verify that you mounted the correct root partition by checking for some "
"files commonly found on |CL| systems."
msgstr "通过检查 |CL| 系统上常见的一些文件,验证是否挂载了正确的根分区。"
#: ../../guides/maintenance/fix-broken-install.rst:70
msgid "Next, run swupd to fix any issues on the target system."
msgstr "接下来,运行 swupd 来修复目标系统上的任何问题。"
#: ../../guides/maintenance/fix-broken-install.rst:76
msgid ":ref:`Learn more about how swupd works <swupd-guide>`."
msgstr ":ref:`Learn more about how swupd works <swupd-guide>`。"
#: ../../guides/maintenance/fix-broken-install.rst:78
msgid "After the process is complete, unmount the root partition:"
msgstr "该过程完成后,卸载根分区:"
#: ../../guides/maintenance/fix-broken-install.rst:84
msgid ""
"Reboot the system, remove the live desktop USB drive, and boot into the "
"repaired system."
msgstr "重新引导系统,卸下实时桌面 USB 驱动器,并引导至修复后的系统。"
#: ../../guides/maintenance/fix-broken-install.rst:91
msgid "**Congratulations!** You successfully restored |CL|."
msgstr "祝贺您!您已成功恢复 |CL|。"
#~ msgid "Fix a broken installation of |CL-ATTR|"
#~ msgstr ""
#~ msgid ""
#~ "This guide explains how to fix a"
#~ " broken installation of |CL| using a"
#~ " live desktop image on a USB. "
#~ "It's assumed you already installed |CL|"
#~ " on a target system, but your "
#~ "operating system does not boot or "
#~ "function properly."
#~ msgstr ""
#~ msgid ""
#~ "This process can only verify and "
#~ "fix files that :ref:`swupd<swupd-guide>` "
#~ "owns in :file:`/usr`. Files outside of"
#~ " this path, such as /home/, /etc, "
#~ "/var, etc., cannot be repaired by "
#~ "this process."
#~ msgstr ""
#~ msgid ""
#~ ":ref:`Download and install the live "
#~ "desktop image on a USB <bare-"
#~ "metal-install-desktop>`"
#~ msgstr ""
#~ msgid "Assure the system is connected to the network."
#~ msgstr ""
#~ msgid "We'll use `/dev/sda3/` as the root partition example."
#~ msgstr ""
#~ msgid "Next, mount the partition to the `/mnt` folder."
#~ msgstr ""
@@ -0,0 +1,127 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/maintenance/hostname.rst:4
msgid "Modify hostname"
msgstr "修改主机名"
#: ../../guides/maintenance/hostname.rst:6
msgid ""
"This guide describes how to modify and view the hostname of your |CL-"
"ATTR| system."
msgstr "本指南介绍如何修改和查看 |CL-ATTR| 系统的主机名。"
#: ../../guides/maintenance/hostname.rst:14
msgid "Overview"
msgstr "概述"
#: ../../guides/maintenance/hostname.rst:16
msgid ""
"By default, |CL| installations have a machine generated name, which is a "
"long string of letters and numbers. The generated name is fine for "
"computers but is not human-friendly. Administrators and users will often "
"want to rename their machines with a name that is easier to remember, "
"type, and search for. Renaming a machine also makes it easier to "
"identify, by including meaningful data in the name. The following "
"examples show human-friendly machine names:"
msgstr "默认情况下,|CL| 安装有一个计算机生成的名称,它是一长串字母和数字。生成的名称对计算机来说没问题,但对用户来说不友好。管理员和用户通常希望用一个更容易记住、键入和搜索的名称来重命名他们的计算机。通过重命名计算机,可在其名称中包含有意义的数据,也让计算机更容易被识别。以下是几个用户友好型的计算机名称示例:"
#: ../../guides/maintenance/hostname.rst:24
msgid "*regression-test*"
msgstr "*regression-test*"
#: ../../guides/maintenance/hostname.rst:25
msgid "*sally-test-box1*"
msgstr "*sally-test-box1*"
#: ../../guides/maintenance/hostname.rst:26
msgid "*az-bldg2-lab*"
msgstr "*az-bldg2-lab*"
#: ../../guides/maintenance/hostname.rst:29
msgid "Set your hostname"
msgstr "设置主机名"
#: ../../guides/maintenance/hostname.rst:31
msgid ""
"|CL| uses the :command:`hostnamectl` command to display and modify the "
"machine name. :command:`hostnamectl` is part of the :command:`os-core` "
"bundle, which provides a basic Linux\\* user space and utilities."
msgstr "|CL| 使用 :command:`hostnamectl` 命令显示和修改计算机名称。:command:`hostnamectl` 是 :command:`os-core` 捆绑包的一部分,提供了基本的 Linux\\* 用户空间和实用程序。"
#: ../../guides/maintenance/hostname.rst:35
msgid ""
"This example sets the hostname to *telemetry-test-2-h15*, to identify a "
"|CL| telemetry test machine on the second floor at grid location H15. "
"Make sure to reboot after setting a new hostname."
msgstr "本示例将主机名设置为 telemetry-test-2-h15,以标识网格位置 H15 处二楼的 |CL| 遥测测试计算机。请确保在设置新主机名后重启。"
#: ../../guides/maintenance/hostname.rst:46
msgid ""
"There are three types of hostname: *static*, *transient*, and *pretty*. "
"The most common is the static hostname. Static hostnames must be between "
"two and 63 characters long, must start and end with a letter or number, "
"and may contain letters (case-insensitive), numbers, dashes, or dots."
msgstr "主机名有三种类型,分别是静态、瞬态和灵活主机名。最常见的是静态主机名。静态主机名的长度必须在 2 到 63 个字符之间,必须以字母或数字开头和结尾,并且可以包含字母(不区分大小写)、数字、破折号或点。"
#: ../../guides/maintenance/hostname.rst:51
msgid ""
"If the static hostname exists, it is used to generate the transient "
"hostname, which is maintained by the kernel. The transient hostname can "
"be changed by DHCP or mDNS at runtime."
msgstr "如果存在静态主机名,它将用于生成由内核维护的瞬态主机名。运行时,DHCP 或 mDNS 可以更改瞬态主机名。"
#: ../../guides/maintenance/hostname.rst:55
msgid ""
"The pretty hostname is a free-form UTF8 name used for presentation to the"
" user."
msgstr "灵活主机名是一个自由格式的 UTF8 名称,用于向用户显示。"
#: ../../guides/maintenance/hostname.rst:58
msgid "View your hostname"
msgstr "查看主机名"
#: ../../guides/maintenance/hostname.rst:60
msgid "View your current hostname using the following command:"
msgstr "使用以下命令查看当前的主机名:"
#: ../../guides/maintenance/hostname.rst:66
msgid "You should see output similar to:"
msgstr "您应该会看到类似以下内容的输出:"
#: ../../guides/maintenance/hostname.rst:81
msgid ""
"**Congratulations!** You successfully modified the hostname of your |CL| "
"system."
msgstr "祝贺您!您成功地在 |CL| 系统中修改了主机名。"
#~ msgid "Modify hostname on |CL-ATTR|"
#~ msgstr ""
#~ msgid ""
#~ "|CL| uses the :command:`hostnamectl` command"
#~ " to display and modify the machine"
#~ " name. :command:`hostnamectl` is part of"
#~ " the **os-core** bundle, which "
#~ "provides a basic Linux\\* user space "
#~ "and utilities."
#~ msgstr ""
@@ -0,0 +1,318 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:4
msgid "Increase virtual disk size of an image"
msgstr "增加映像的虚拟磁盘大小"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:6
msgid ""
"This guide describes how to increase the disk size of your prebuilt |CL-"
"ATTR| image if you need more capacity."
msgstr "本指南介绍在需要更大容量时如何增加预构建的 |CL-ATTR| 映像的磁盘大小。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:14
msgid "Determine the partition order and sizes of the prebuilt image"
msgstr "确定预构建映像的分区顺序和大小。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:16
msgid ""
"|CL| prebuilt images come in different sizes, ranging from 300 MB to 20 "
"GB."
msgstr "|CL| 预构建映像拥有不同的大小,范围从 300 MB 至 20 GB 不等。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:19
msgid ""
"There are two methods to find the order and sizes of partitions virtual "
"disk of your prebuilt |CL| image."
msgstr "有两种方法可找到预构建 |CL| 映像分区虚拟盘的顺序和大小。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:22
msgid ""
"In both examples, the prebuilt Hyper-V image has a disk size of 8.5 GB "
"with :file:`/dev/sda3` being the partition for the root filesystem (/)"
msgstr "在两个例子中,预构建 Hyper-V 映像拥有 8.5 GB 磁盘大小,其中 :file:`/dev/sda3` 为根文件系统 (/) 分区"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:26
msgid "Checking :command:`lsblk` on the VM"
msgstr "在虚拟机上检查 :command:`lsblk`"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:28
msgid ""
"The first method is to boot up your :abbr:`VM (Virtual Machine)` and "
"execute the :command:`lsblk` command as shown below:"
msgstr "第一种方法是引导启动您的 :abbr:`虚拟机` 并执行 :command:`lsblk` 命令,如下所示:"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:35
msgid "An example output of the :command:`lsblk` command:"
msgstr ":command:`lsblk` 命令输出结果示例:"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:45
msgid "An example of this can also be seen in Figure 1."
msgstr "还可在图 1 中查看此示例。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:48
msgid "Checking :file:`config.json` used to build the image"
msgstr "检查用来构建映像的 :file:`config.json`"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:50
msgid ""
"The second method to determine partition to check the :file:`config.json`"
" file used to create prebuilt image, located in the `releases`_ "
"repository. For example, to find the size of the Hyper-V\\* image version"
" number 20450, follow these steps:"
msgstr "第二种方法是确定分区,以检查用来创建预构建映像的 :file:`config.json` 文件,该文件位于 `releases`_ 库。例如,要发现版本号 20450 的 Hyper-V\\* 映像的大小,请遵循如下步骤:"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:55
msgid "Go to the `releases`_ repository."
msgstr "转到 `releases`_ 库。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:56
msgid "Drill down into the `20450 > clear > config > image` directory."
msgstr "追溯 `20450 > clear > config > image` 目录。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:57
msgid "Open the :file:`hyperv-config.json` file."
msgstr "打开 :file:`hyperv-config.json` 文件。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:58
msgid "Locate the `PartitionLayout` key."
msgstr "找到 `PartitionLayout` 键。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:60
msgid ""
"The example shows 512 MB for the EFI partition, 32 MB for the swap "
"partition, and 8 GB for the root partition."
msgstr "该例子显示 DFI 分区为 512 MB,swap 分区为 32 MB,而根分区为 8 GB。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:80
msgid "Increase virtual disk size"
msgstr "增加虚拟盘大小"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:81
msgid ""
"Once you have determined the disk and partition to be increased, you are "
"ready to perform the actual increase of the disk, partition, and "
"filesystem."
msgstr "一旦确定增加磁盘和分区的大小,您将执行实际操作增加磁盘、分区和 filesystem 的大小。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:85
msgid "Power off VM and increase virtual disk size"
msgstr "关闭虚拟机并增加虚拟盘大小"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:87
msgid ""
"To increase the virtual disk size for a prebuilt image, perform the steps"
" below:"
msgstr "要为预构建映像增加虚拟盘大小,请执行如下步骤:"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:90
msgid "Shut down your VM if it is running."
msgstr "关闭正在运行的虚拟机。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:91
msgid ""
"Use the process defined by your hypervisor or cloud provider to increase"
" the virtual disk size of your |CL| VM."
msgstr "使用虚拟机管理程序或云提供商规定的流程或增加 |CL| 虚拟机的虚拟盘大小。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:93
msgid "Power up the VM."
msgstr "开启虚拟机。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:97
msgid "Resize the partition of the virtual disk"
msgstr "调整虚拟盘的分区大小"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:99
msgid "Log in to an account with root privileges."
msgstr "登录拥有根权限的账户。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:100
msgid "Open a terminal emulator."
msgstr "打开一个终端模拟器。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:101
msgid ""
"Add the :command:`storage-utils` bundle to install the :command:`parted` "
"and :command:`resize2fs` tools."
msgstr "添加 :command:`storage-utils` 捆绑包以安装 :command:`parted` 和 :command:`resize2fs` 工具。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:108
msgid "Launch the `parted` tool."
msgstr "启动 `parted` 工具。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:114
msgid "In the `parted` tool, perform these steps:"
msgstr "在 `parted` 工具中,执行如下步骤:"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:116
msgid "Press :command:`p` to print the partitions table."
msgstr "按下 :command:`p` 以打印分区表。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:117
msgid "If the warning message below is displayed, enter :command:`Fix`."
msgstr "如果显示下面的警告消息,则输入 :command:`Fix`。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:127
msgid ""
"Enter :command:`resizepart [partition number]` where *[partition number]*"
" is the partition number of the partition to modify."
msgstr "输入 :command:`resizepart [partition number]`,其中 *[partition number]* 是需要修改的分区的分区编号。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:129
msgid "Enter :command:`yes` when prompted."
msgstr "出现提示时输入 :command:`yes`。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:130
msgid "Enter the new End size."
msgstr "输入新的 End 大小。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:134
msgid ""
"If you want a partition to take up the remaining disk space, then enter "
"the total size of the disk. When you print the partitions table with the "
":command:`p` command, the total disk size is shown after the "
":guilabel:`Disk` label."
msgstr "如果希望一个分区占用剩余的盘空间,则输入磁盘的总大小。使用 :command:`p` 命令打印分区表时, :guilabel:`Disk` 标签后面会显示出总磁盘大小。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:139
msgid "An example of this can be seen in Figure 1."
msgstr "本步骤示例可在图 1 中查看。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:141
msgid ""
"Enter :command:`q` to exit `parted` when you are finished resizing the "
"image."
msgstr "当调整映像完成后,输入 :command:`q` 退出 `parted`。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:144
msgid ""
"Figure 1 depicts the described steps to resize the partition of the "
"virtual disk from 8.5GB to 20GB."
msgstr "图 1 介绍了将虚拟盘分区从 8.5 GB 调整至 20 GB 的步骤。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:150
msgid "Figure 1: Increase root partition size."
msgstr "图 1:增加根分区的大小。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:153
msgid "Resize the filesystem"
msgstr "调整文件系统的大小"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:155
msgid ""
"Enter :command:`sudo resize2fs -p /dev/[modified partition name]` where "
"*[modified partition name]* is the partition that was changed in the "
"`parted` tool."
msgstr "输入 :command:`sudo resize2fs -p /dev/[modified partition name]`,其中 *[modified partition name]* 是在 `parted` 工具中改变的分区。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:159
msgid "Run the :command:`df -h` to verify that the filesystem size has increased."
msgstr "运行 :command:`df -h` 确认 filesystem 大小已增加。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:162
msgid ""
"Figure 2 depicts the described steps to resize the partition of the "
"virtual disk from 8.5GB to 20GB."
msgstr "图 2 介绍了将虚拟盘分区从 8.5 GB 调整至 20 GB 的步骤。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:169
msgid "Figure 2: Increase root filesystem size after partition has been expanded."
msgstr "图 2:扩展分区后增加根 filesystem 大小。"
#: ../../guides/maintenance/increase-virtual-disk-size.rst:171
msgid ""
"**Congratulations!** You have resized the disk, partition, and "
"filesystem. At this point, the increase in disk capacity is usable."
msgstr "祝贺您!您已经调整磁盘、分区和 filesystem 的大小。此时,盘容量的增加是有用的。"
#~ msgid "Increase virtual disk size of a |CL-ATTR| image"
#~ msgstr ""
#~ msgid ""
#~ "|CL-ATTR| prebuilt images come in "
#~ "different sizes, ranging from 300 MB "
#~ "to 20 GB. This guide describes how"
#~ " to increase the size of your "
#~ "prebuilt |CL| image if you need "
#~ "more capacity."
#~ msgstr ""
#~ msgid "This guide will cover:"
#~ msgstr ""
#~ msgid ""
#~ "In both examples, the prebuilt Hyper-V"
#~ " image has a disk size of 8.5"
#~ " GB with / dev/sda3 being the "
#~ "partition for the root filesystem (/)"
#~ msgstr ""
#~ msgid "Power off VM and increase virtual disk size:"
#~ msgstr ""
#~ msgid ""
#~ "Use the process defined by your "
#~ "hypervisor or cloud provider to increase"
#~ " the virtual disk size of your "
#~ "|CL| VM."
#~ msgstr ""
#~ msgid "Resize the partition of the virtual disk:"
#~ msgstr ""
#~ msgid ""
#~ "Add the |CL| `storage-utils` bundle "
#~ "to install the :command:`parted` and "
#~ ":command:`resize2fs` tools."
#~ msgstr ""
#~ msgid "Enter the new `End` size."
#~ msgstr ""
#~ msgid ""
#~ "If you want a partition to take"
#~ " up the remaining disk space, then"
#~ " enter the total size of the "
#~ "disk. When you print the partitions "
#~ "table with the :command:`p` command, the"
#~ " total disk size is shown after "
#~ "the `Disk` label."
#~ msgstr ""
#~ msgid "Resize the filesytem"
#~ msgstr ""
#~ msgid ""
#~ "Enter :command:`sudo resize2fs -p "
#~ "/dev/[modified partition name]` where "
#~ "*[modified partition name]* is the "
#~ "partition that was changed in `parted`."
#~ msgstr ""
#~ msgid ""
#~ "Congratulations! You have resized the "
#~ "disk, partition, and filesystem. At this"
#~ " point, the increase in disk capacity"
#~ " is usable."
#~ msgstr ""
@@ -0,0 +1,167 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/maintenance/query-upstream.rst:4
msgid "Query package info from upstream repository"
msgstr "从上游存储库查询软件包信息"
#: ../../guides/maintenance/query-upstream.rst:6
msgid ""
"This guide describes how to query package information from the |CL| "
"upstream repositories. This guide is intended for developers and advanced"
" users."
msgstr "本指南介绍如何从 |CL-ATTR| 上游存储库查询软件包信息。本指南面向开发人员和高级用户。"
#: ../../guides/maintenance/query-upstream.rst:15
msgid "Overview"
msgstr "概述"
#: ../../guides/maintenance/query-upstream.rst:17
msgid ""
"In |CL-ATTR|, the :ref:`swupd<swupd-guide>` tool manages software "
"dependencies and installs bundles instead of packages. Although a bundle "
"is a collection of one or more packages, |CL| does not work with packages"
" on the client side. However, on the upstream/factory side, |CL| does "
"work with packages using a process called *mixing*."
msgstr "在 |CL-ATTR| 中,:ref:`swupd<swupd-guide>` 工具用于管理软件依赖项以及安装捆绑包而非软件包。虽然捆绑包是一个或多个软件包的集合,但 |CL| 在客户端上无法处理软件包。但是,在上游/工厂端,|CL| 可以使用名为混合的过程来处理软件包。"
#: ../../guides/maintenance/query-upstream.rst:23
msgid ""
"Currently, :command:`swupd` does not report which packages are installed,"
" provide package version information, or return other package details. "
"This guide describes a method for retrieving package information from the"
" |CL| upstream repositories using :abbr:`DNF(Dandified Yum)` commands."
msgstr "当前,:command:`swupd` 不会报告已安装的软件包,也不会提供软件包版本信息或返回其他软件包详细信息。本指南介绍了用于使用 :abbr:`DNF(Dandified Yum)` 命令从 |CL| 上游存储库检索软件包信息的方法。"
#: ../../guides/maintenance/query-upstream.rst:29
msgid "Prerequisites"
msgstr "必备条件"
#: ../../guides/maintenance/query-upstream.rst:31
msgid ""
"This guide assumes you have installed |CL| on your host system. For "
"detailed instructions on installing |CL| on a bare metal system, visit "
"the :ref:`bare metal installation guide <bare-metal-install-desktop>`."
msgstr "本指南假定您已在主机系统中安装了 |CL|。有关在裸机系统中安装 |CL| 的详细说明,请参见 :ref:`裸机安装指南<bare-metal-install-desktop>`。"
#: ../../guides/maintenance/query-upstream.rst:35
msgid ""
"Before you install any new packages, update |CL| with the following "
"command:"
msgstr "安装任何新软件包之前,请使用以下命令更新 |CL|:"
#: ../../guides/maintenance/query-upstream.rst:42
msgid "Configure DNF"
msgstr "配置 DNF"
#: ../../guides/maintenance/query-upstream.rst:44
msgid "Install the DNF bundle with the command:"
msgstr "使用以下命令安装 DNF 捆绑包:"
#: ../../guides/maintenance/query-upstream.rst:50
msgid "Create a :file:`dnf.conf` file with the commands:"
msgstr "使用以下命令创建 :file:`dnf.conf` 文件:"
#: ../../guides/maintenance/query-upstream.rst:58
msgid ""
"Edit the :file:`/etc/dnf/dnf.conf` file and set the **baseurl** variable "
"for binary and source RPMs as shown in lines 3 and 9 in the following "
"example."
msgstr "编辑 :file:`/etc/dnf/dnf.conf` 文件,并为以下示例中的第 3 行和第 9 行中显示的二进制 RPM 和源 RPM 设置 baseurl 变量。"
#: ../../guides/maintenance/query-upstream.rst:78
msgid "Initialize the RPM database with the command:"
msgstr "使用以下命令初始化 RPM 数据库:"
#: ../../guides/maintenance/query-upstream.rst:86
msgid "DNF command usage examples"
msgstr "DNF 命令用法示例"
#: ../../guides/maintenance/query-upstream.rst:93
msgid "List all binary and source RPMs in the current release"
msgstr "列出当前发行版中的所有二进制 RPM 和源 RPM"
#: ../../guides/maintenance/query-upstream.rst:95
#: ../../guides/maintenance/query-upstream.rst:129
#: ../../guides/maintenance/query-upstream.rst:150
#: ../../guides/maintenance/query-upstream.rst:173
#: ../../guides/maintenance/query-upstream.rst:196
#: ../../guides/maintenance/query-upstream.rst:215
msgid "Command:"
msgstr "命令:"
#: ../../guides/maintenance/query-upstream.rst:101
#: ../../guides/maintenance/query-upstream.rst:135
#: ../../guides/maintenance/query-upstream.rst:156
#: ../../guides/maintenance/query-upstream.rst:179
#: ../../guides/maintenance/query-upstream.rst:202
#: ../../guides/maintenance/query-upstream.rst:221
msgid "Sample output:"
msgstr "示例输出:"
#: ../../guides/maintenance/query-upstream.rst:125
msgid "Show version information for a package in current release"
msgstr "显示当前发行版中的软件包的版本信息"
#: ../../guides/maintenance/query-upstream.rst:127
msgid "This example queries version information for the zstd package."
msgstr "此示例查询 zstd 软件包的版本信息。"
#: ../../guides/maintenance/query-upstream.rst:145
msgid "Show version information for a package in a specific release"
msgstr "显示特定发行版中的软件包的版本信息"
#: ../../guides/maintenance/query-upstream.rst:147
msgid ""
"This example queries version information for the zstd package in release "
"21000."
msgstr "此示例查询发行版 21000 中的 zstd 软件包的版本信息。"
#: ../../guides/maintenance/query-upstream.rst:168
msgid ""
"Show only version and release information for a package in a specific "
"release"
msgstr "仅显示特定发行版中的软件包的版本和发行信息"
#: ../../guides/maintenance/query-upstream.rst:170
msgid ""
"This example queries version and release information for the zstd package"
" in release 15000."
msgstr "此示例查询发行版 15000 中的 zstd 软件包的版本和发行信息。"
#: ../../guides/maintenance/query-upstream.rst:191
msgid "Show the binary package for a specified binary file"
msgstr "显示指定二进制文件的二进制包"
#: ../../guides/maintenance/query-upstream.rst:193
msgid ""
"This example returns the binary package that contains the "
":file:`/usr/bin/zip` binary file."
msgstr "此示例将返回包含 :file:`/usr/bin/zip` 二进制文件的二进制包。"
#: ../../guides/maintenance/query-upstream.rst:210
msgid "Show the source package for a specified binary file"
msgstr "显示指定二进制文件的源包"
#: ../../guides/maintenance/query-upstream.rst:212
msgid ""
"This example returns the source package that contains the "
":file:`/usr/bin/zip` binary file."
msgstr "此示例将返回包含 :file:`/usr/bin/zip` 二进制文件的源包。"
@@ -0,0 +1,151 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-09-06 11:29-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0152\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh_Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=1; plural=0\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../guides/maintenance/resource-limits.rst:4
msgid "Resource limits"
msgstr "资源限制"
#: ../../guides/maintenance/resource-limits.rst:6
msgid ""
"Linux systems employ limiting or quota mechanisms to provide quality of "
"service for system resources and contain rogue processes."
msgstr "Linux 系统使用限制机制或配额机制为系统资源提供服务质量,并且包含异常进程。"
#: ../../guides/maintenance/resource-limits.rst:9
msgid ""
"These limits are layered at the system-level and user-level. If these "
"limits need to be modified, it is useful to understand the different "
"limit configurations."
msgstr "这些限制分为系统级别和用户级别。如果需要修改这些限制,则了解不同的限制配置会有帮助。"
#: ../../guides/maintenance/resource-limits.rst:18
msgid "System-wide limits"
msgstr "系统范围限制"
#: ../../guides/maintenance/resource-limits.rst:20
msgid ""
"Some global resource limits are implemented in the Linux kernel and are "
"controllable with kernel parameters."
msgstr "部分全局资源限制在 Linux 内核中实施,并且可以使用内核参数进行控制。"
#: ../../guides/maintenance/resource-limits.rst:23
msgid ""
"For example, a global limit for the maximum number of open files is set "
"with the *fs.file-max* parameter. This limit applies to all processes and"
" users an cannot be exceeded other limit values."
msgstr "例如,可以使用 fs.file-max 参数来设置针对最大打开文件数的全局限制。此限制应用于所有进程,并且用户不能超过其他限制值。"
#: ../../guides/maintenance/resource-limits.rst:28
msgid "Checking limit"
msgstr "检查限制"
#: ../../guides/maintenance/resource-limits.rst:30
msgid ""
"You can check a current value with :command:`sysctl -n <PARAMETER>`. For "
"example:"
msgstr "可以使用 :command:`sysctl -n <PARAMETER>` 来检查当前值。例如:"
#: ../../guides/maintenance/resource-limits.rst:38
msgid ""
"This *fs.file-max* value is set intentionally high on |CL| systems by "
"default. You can check the maximum value supported by the system with:"
msgstr "默认情况下,此 fs.file-max 值在 |CL| 系统中有意设置得较高。可以使用以下命令检查系统支持的最大值:"
#: ../../guides/maintenance/resource-limits.rst:47
msgid "Overriding limit"
msgstr "替代限制"
#: ../../guides/maintenance/resource-limits.rst:49
msgid ""
"You can override a value with :command:`sysctl -w <PARAMETER>`. For "
"example:"
msgstr "可以使用 :command:`sysctl -w <PARAMETER>` 来替代某个值。例如:"
#: ../../guides/maintenance/resource-limits.rst:56
msgid ""
"If needed permanently, the value can be set by creating a "
":file:`/etc/sysctl.d/*.conf` file (see :command:`man sysctl.d` for "
"details). For example:"
msgstr ""
"如果需要永久值,可以通过创建 :file:`/etc/sysctl.d/*.conf` 文件来设置值(有关详细信息,请参见 "
":command:`man sysctl.d`)。例如:"
#: ../../guides/maintenance/resource-limits.rst:73
msgid "Per-user limits"
msgstr "每用户限制"
#: ../../guides/maintenance/resource-limits.rst:75
msgid ""
"For processes not managed by systemd, resource limits can be set for PAM "
"logins on a per-user basis with upper and lower limits in the "
":file:`/etc/security/limits.conf` file."
msgstr ""
"对于不由 systemd 管理的进程,可以在 :file:`/etc/security/limits.conf` 文件中使用上限和下限基于用户为 "
"PAM 登录设置资源限制。"
#: ../../guides/maintenance/resource-limits.rst:79
msgid ""
"You can set temporary values and check the current values with the "
":command:`ulimit` command. For example, to change the soft limit of "
"maximum number of open file descriptors for the current user:"
msgstr "可以设置临时值,并使用 :command:`ulimit` 命令检查当前值。例如,要更改当前用户的最大打开文件数描述符的软限制:"
#: ../../guides/maintenance/resource-limits.rst:87
msgid "See :command:`man limits.conf` for details."
msgstr "有关详细信息,请参见 :command:`man limits.conf`。"
#: ../../guides/maintenance/resource-limits.rst:91
msgid "Service limits"
msgstr "服务限制"
#: ../../guides/maintenance/resource-limits.rst:93
msgid ""
"Resource limits for services started with systemd units do not follow "
"normal user limits because the process is started in a seperate `Linux "
"control group (cgroup) "
"<https://www.kernel.org/doc/Documentation/cgroup-v2.txt>`_ Linux cgroups "
"associate related process groups and provide resource accounting."
msgstr ""
"使用 systemd 单元启动的服务的资源限制不遵循正常用户限制,因为进程在单独的 `Linux 控制组 (cgroup) "
"<https://www.kernel.org/doc/Documentation/cgroup-v2.txt>`_ 中启动,Linux "
"cgroup 将相关的进程组相关联并提供资源计帐。"
#: ../../guides/maintenance/resource-limits.rst:98
msgid ""
"Resource limits for individual systemd services can be controlled inside "
"their unit files or its configuration drop-in directory with the resource"
" Limit directives. See `process properties section of the systemd.exec "
"man page "
"<https://www.freedesktop.org/software/systemd/man/systemd.exec.html>`_."
msgstr ""
"可以在相应的单元文件或配置放置目录中使用资源限制指令来控制各个 systemd 服务的资源限制。请参见 `process properties "
"section of the systemd.exec man page "
"<https://www.freedesktop.org/software/systemd/man/systemd.exec.html>`_。"
#: ../../guides/maintenance/resource-limits.rst:103
msgid ""
"Resource limits for all systemd services can be controlled with a file in"
" the :file:`/etc/systemd/system.conf.d/` directory. For example, to have "
"no restriction on the number of open files:"
msgstr ""
"可以使用 :file:`/etc/systemd/system.conf.d/` 目录中的文件来控制所有 systemd "
"服务的资源限制。例如,要禁用对最大打开文件数的限制:"
@@ -0,0 +1,418 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../guides/maintenance/restart.rst:4
msgid "Restart system services after an OS update"
msgstr "操作系统更新后重启系统服务"
#: ../../guides/maintenance/restart.rst:6
msgid "This guide describes how to use the :command:`clr-service-restart` tool."
msgstr "本指南介绍如何使用 :command:`clr-service-restart`。"
#: ../../guides/maintenance/restart.rst:13
msgid "Overview"
msgstr "概述"
#: ../../guides/maintenance/restart.rst:15
msgid ""
"|CL-ATTR| includes a :command:`clr-service-restart` tool that shows which"
" system daemons require a restart."
msgstr "|CL-ATTR| 包含 :command:`clr-service-restart` 工具,该工具显示哪些系统守护程序需要重新启动。"
#: ../../guides/maintenance/restart.rst:18
msgid ""
":command:`clr-service-restart` reads various files in the :file:`procfs` "
"filesystem provided by the kernel and relies on :command:`systemd` to "
"determine which services to restart."
msgstr ":command:`clr-service-restart` 读取内核提供的 :file:`procfs` 文件系统中的各种文件,并依靠 :command:`systemd` 来确定要重新启动哪些服务。"
#: ../../guides/maintenance/restart.rst:24
msgid "How it works"
msgstr "工作原理"
#: ../../guides/maintenance/restart.rst:26
msgid ""
":command:`clr-service-restart` implements a whitelist to identify which "
"daemons can be restarted. As a system administrator, you can customize "
"the default |CL| OS whitelist using :command:`allow` or "
":command:`disallow` options for restarting system services. When a "
"software update occurs, :command:`clr-service-restart` consults the "
"whitelist to see if a service daemon is allowed to be restarted or not."
msgstr ":command:`clr-service-restart` 会实现一个白名单,以确定哪些守护程序可以重启。系统管理员可以使用 :command:`allow` 或 :command:`disallow` 选项自定义重启系统服务时使用的默认 |CL| 操作系统白名单。执行软件更新时,:command:`clr-service-restart` 会查阅该白名单,确认是否允许重启某个服务守护程序。有关详细信息,请参阅选项部分。"
#: ../../guides/maintenance/restart.rst:35
msgid "Basic options"
msgstr "基本选项"
#: ../../guides/maintenance/restart.rst:37
msgid ""
":command:`clr-service-restart` has three basic options: :command:`allow`,"
" :command:`disallow`, and :command:`default`."
msgstr ":command:`clr-service-restart` 具有三个基本选项: :command:`allow`、:command:`disallow` 和 :command:`default`。"
#: ../../guides/maintenance/restart.rst:41
msgid "allow"
msgstr "允许"
#: ../../guides/maintenance/restart.rst:43
msgid ""
"The :command:`allow` option identifies a daemon to restart after an OS "
"software update. The :command:`clr-service-restart` daemon creates a "
"symlink in :file:`/etc/clr-service-restart` as a record. The example "
"below tells :command:`clr-service-restart` to restart the *tallow* daemon"
" after an OS software update."
msgstr ":command:`allow` 选项标识操作系统软件更新后要重启的守护程序。:command:`clr-service-restart` 守护程序会在 :file:`/etc/clr-service-restart` 中创建一个符号链接作为记录。下面的示例指示 :command:`clr-service-restart` 在操作系统软件更新后重启 tallow 守护程序。"
#: ../../guides/maintenance/restart.rst:54
msgid "disallow"
msgstr "不允许"
#: ../../guides/maintenance/restart.rst:56
msgid ""
"The :command:`disallow` option tells :command:`clr-service-restart` not "
"to restart the specified daemon even if the OS defaults permit the daemon"
" to be restarted. The :command:`clr-service-restart` daemon creates a "
"symlink in :file:`/etc/clr-service-restart` that points to "
":file:`/dev/null` as a record. The example below tells :command:`clr-"
"service-restart` not to restart the *rngd* daemon after an OS software "
"update."
msgstr ":command:`disallow` 选项指示 :command:`clr-service-restart` 不要重启指定的守护程序,即使操作系统默认允许重启该守护程序。:command:`clr-service-restart` 守护程序会在 :file:`/etc/clr-service-restart` 中创建一个指向 :file:`/dev/null` 的符号链接作为记录。下面的示例指示 :command:`clr-service-restart` 在操作系统软件更新后不要重启 rngd 守护程序。"
#: ../../guides/maintenance/restart.rst:68
msgid "default"
msgstr "默认"
#: ../../guides/maintenance/restart.rst:70
msgid ""
"The :command:`default` option makes :command:`clr-service-restart` revert"
" back to the OS defaults and delete any symlink in :file:`/etc/clr-"
"service-restart`. The example below tells :command:`clr-service-restart`"
" to restart *rngd* automatically again, because *rngd* is whitelisted for"
" automatic service restarts by default in |CL|."
msgstr ":command:`default` 选项指示 :command:`clr-service-restart` 恢复使用操作系统默认设置,并删除 :file:`/etc/clr-service-restart` 中的任何符号链接。下面的示例指示 :command:`clr-service-restart` 重新自动重启 rngd,因为 |CL| 默认将 rngd 加入了自动重启服务白名单。"
#: ../../guides/maintenance/restart.rst:81
msgid "Monitor options"
msgstr "监控选项"
#: ../../guides/maintenance/restart.rst:83
msgid ""
":command:`clr-service-restart` works in the background and is invoked "
"with :command:`swupd` automatically. Review the journal output to verify "
"that services are restarted after an OS software update."
msgstr ":command:`clr-service-restart` 在后台运行,并通过 :command:`swupd` 自动调用。查看日志输出可确认在操作系统软件更新后重启的服务。"
#: ../../guides/maintenance/restart.rst:87
msgid ""
"If you pass both options (:command:`-a` and :command:`-n`) described "
"below, :command:`clr-service-restart` displays a complete list of system "
"services that require a restart. Use both options to verify that all "
"desired daemons are restarted."
msgstr "如果同时传递两个选项(:command:`-a` 和 :command:`-n`),:command:`clr-service-restart` 会显示需要重启的系统服务的完整清单。使用这两个选项可确认所有所需的守护程序都已重启。"
#: ../../guides/maintenance/restart.rst:94
msgid "-n option"
msgstr "-n option"
#: ../../guides/maintenance/restart.rst:96
msgid ""
"The :command:`-n` option makes :command:`clr-service-restart` perform no "
"restarts. Instead it displays the services that could potentially be "
"restarted. When used, :command:`clr-service-restart` outputs a list of "
"messages showing:"
msgstr "此选项指示 :command:`clr-service-restart` 不执行任何重启,而是显示可能要重启的服务。使用该选项时,:command:`clr-service-restart` 会输出一个消息列表,显示:"
#: ../../guides/maintenance/restart.rst:100
msgid "Which service needs a restart."
msgstr "哪个服务需要重启。"
#: ../../guides/maintenance/restart.rst:101
msgid "What unit it is."
msgstr "它是什么单元。"
#: ../../guides/maintenance/restart.rst:102
msgid "Why it needs a restart."
msgstr "为什么它需要重启。"
#: ../../guides/maintenance/restart.rst:103
msgid "Which command is required to restart the unit."
msgstr "重启该单元需要哪个命令。"
#: ../../guides/maintenance/restart.rst:106
msgid "-a option"
msgstr "-a option"
#: ../../guides/maintenance/restart.rst:108
msgid ""
"The :command:`-a` option makes :command:`clr-service-restart` consider "
"all system services, not only the ones that are whitelisted. Because the "
"default whitelist in |CL| is relatively short, you can use this option to"
" restart all impacted services when you log in on the system."
msgstr "此选项指示 :command:`clr-service-restart` 考虑所有系统服务,而不仅仅是白名单中的服务。因为 |CL| 中的默认白名单相对较短,所以您可以在登录系统时使用此选项重启所有受影响的服务。"
#: ../../guides/maintenance/restart.rst:114
msgid "Example"
msgstr "示例"
#: ../../guides/maintenance/restart.rst:116
msgid ""
"In the example below, :command:`clr-service-restart` is invoked with both"
" the :command:`-a` and :command:`-n` options, which displays a complete "
"list of system services that require a restart."
msgstr "在下面的示例中,:command:`clr-service-restart` 使用 :command:`-a` 和 :command:`-n` 两个选项进行了调用,显示了需要重新启动的系统服务的完整列表。"
#: ../../guides/maintenance/restart.rst:120
msgid "Command:"
msgstr "命令:"
#: ../../guides/maintenance/restart.rst:126
msgid "Sample output:"
msgstr "示例输出:"
#: ../../guides/maintenance/restart.rst:138
msgid "Telemetry"
msgstr "遥测技术"
#: ../../guides/maintenance/restart.rst:140
msgid ""
":command:`clr-service-restart` may cause problems such as a short service"
" outage when a daemon is being restarted, or if a daemon fails to "
"properly restart. To minimize issues, :command:`clr-service-restart` "
"creates a telemetry record and sends it to the optional |CL| telemetry "
"service if both conditions below are met:"
msgstr ":command:`clr-service-restart` 可能会导致一些问题,例如守护程序重启时服务短暂中断,或者守护程序未能正确重启。为了最大限度减少这些问题,:command:`clr-service-restart` 会创建遥测记录,并在满足以下两个条件时将其发送到可选的 |CL| 遥测服务:"
#: ../../guides/maintenance/restart.rst:146
msgid "If a unit fails to automatically restart after an OS update."
msgstr "如果某个单元在操作系统更新后无法自动重启。"
#: ../../guides/maintenance/restart.rst:147
msgid ""
"If that unit resides in the system location "
":file:`/usr/lib/systemd/system`."
msgstr "如果该单元位于系统位置 :file:`/usr/lib/systemd/system`。"
#: ../../guides/maintenance/restart.rst:149
msgid ""
"If you do not install the |CL| telemetrics bundle, the data is discarded."
" If you install the telemetrics bundle and you opt to send telemetry, "
"then the system unit name is sent to the |CL| telemetry service. We "
"evaluate the report and update the whitelist to remove services that are "
"not safe to restart."
msgstr "如果未安装 |CL| 遥测捆绑包,该数据将被丢弃。如果安装了遥测捆绑包并选择发送遥测数据,则该系统单元名称将发送到 |CL| 遥测服务。我们会评估报告并更新白名单,移除出无法正常重启的服务。"
#: ../../guides/maintenance/restart.rst:157
msgid "Conclusion"
msgstr "总结"
#: ../../guides/maintenance/restart.rst:159
msgid ""
"The |CL| team enjoys coming up with simple and efficient solutions to "
"make your work easier. We made a GitHub\\* project of :command:`clr-"
"service-restart` and we invite you to look at the code, share your "
"thoughts, and work with us on improving the project. You can find the "
"project at:"
msgstr "|CL| 团队喜欢想出简单但有效的解决方案,让您的工作变得更轻松。我们为 :command:`clr-service-restart` 创建了一个 github 项目,并邀请您查看代码,分享您的想法,并与我们一起改进该项目。您可以在以下网址找到该项目:"
#: ../../guides/maintenance/restart.rst:164
msgid "https://github.com/clearlinux/clr-service-restart"
msgstr "https://github.com/clearlinux/clr-service-restart"
#~ msgid ""
#~ "The software life cycle describes how"
#~ " software is created, developed, and "
#~ "deployed, and includes how to replace"
#~ " or update software. A good OS "
#~ "provides tools for the entire software"
#~ " life cycle. These tools must include"
#~ " ways to remove software components "
#~ "properly when replaced with something "
#~ "else."
#~ msgstr "软件生命周期是指软件是如何创建、开发和部署的,包括如何替换或更新软件。优秀的操作系统需要提供适用于整个软件生命周期的工具。这些工具必须有办法在某些软件组件被替换后将其妥善移除掉。"
#~ msgid ""
#~ "Most of the work on software "
#~ "update code in |CL| was focused on"
#~ " adding new software to the system."
#~ " We recommended that users reboot "
#~ "their system once in a while, but"
#~ " we did not provide any tools "
#~ "to restart services easily, until now."
#~ msgstr ""
#~ "|CL| "
#~ "中的软件更新代码所做的大部分工作是为系统增添新软件。我们建议用户偶尔重启他们的系统,但是直到现在我们还没有提供任何工具来轻松地重启各项服务。"
#~ msgid "User challenges"
#~ msgstr "用户面临的挑战"
#~ msgid ""
#~ "It is difficult to determine which "
#~ "services to restart. You can either "
#~ "evaluate each system and reboot "
#~ "manually, or figure out which services"
#~ " to restart based on documentation "
#~ "like the |CL| release notes. Since "
#~ "neither option solves the issue "
#~ "completely, the |CL| team created a "
#~ "solution."
#~ msgstr ""
#~ "很难确定要重启哪些服务。用户要么是评估每个系统并手动重启,要么是根据 |CL| "
#~ "发行说明之类文档确定要重启哪些服务。由于这两个方案都不能彻底解决问题,所以 |CL| 团队为此打造了一个解决方案。"
#~ msgid ""
#~ "Over the years, several OSes approached"
#~ " the problem and created partial "
#~ "solutions such as the following:"
#~ msgstr "多年来,不少操作系统都在解决此问题,并提出了并不算彻底的解决方案,例如:"
#~ msgid "Automatically restart services during an upgrade."
#~ msgstr "升级期间自动重启服务。"
#~ msgid "Evaluate services using these steps:"
#~ msgstr "使用以下步骤评估服务:"
#~ msgid "Mark updates requiring a reboot, such as kernel updates."
#~ msgstr "标记需要重启的更新,例如内核更新。"
#~ msgid "Inform the user of those updates."
#~ msgstr "向用户通知这些更新。"
#~ msgid "Ask the user to restart the OS."
#~ msgstr "要求用户重启操作系统。"
#~ msgid ""
#~ "Both solutions are acceptable for many"
#~ " OSes. However, |CL| updates software "
#~ "automatically and users do not see "
#~ "notices from the updater unless they "
#~ "review the journal. |CL| requires a "
#~ "completely different solution, with the "
#~ "following requirements:"
#~ msgstr ""
#~ "这两种解决方案对于许多操作系统都是可以接受的。但是,|CL| "
#~ "会自动更新软件,除非用户查看日志,否则不会看到更新程序的通知。因此,|CL| 需要一个完全不同的解决方案,具体要求如下:"
#~ msgid ""
#~ "Eliminate the guesswork about what to"
#~ " restart and under what circumstances."
#~ msgstr "明确确定要重启什么以及在什么情况下重启,而不是靠猜测。"
#~ msgid ""
#~ "Cannot restart everything. Many service "
#~ "daemons do not support an automatic "
#~ "background restart."
#~ msgstr "不能什么都重启。许多服务守护程序不支持自动在后台重启。"
#~ msgid "Fit into the |CL| architectural perspective: be small, quick, and lean."
#~ msgstr "契合 |CL| 架构的特点:小、快、精简。"
#~ msgid "clr-service-restart functionality"
#~ msgstr "clr-service-restart 功能"
#~ msgid "Typical reasons to restart a service daemon include:"
#~ msgstr "重启服务守护程序的常见原因包括:"
#~ msgid "A new version replaces the executable file itself."
#~ msgstr "新版本替换了可执行文件本身。"
#~ msgid "A new version replaces a library component used by a service daemon."
#~ msgstr "新版本替换了服务守护程序使用的库组件。"
#~ msgid ""
#~ "Our method restarts daemons when it "
#~ "is really needed, especially in the "
#~ "case of security updates. The tool "
#~ "restarts daemons by reading various "
#~ "files in the :file:`procfs` filesystem "
#~ "provided by the kernel."
#~ msgstr ""
#~ "我们的方法是在真正需要时重启守护程序,尤其是在安装安全更新时。该工具通过读取内核提供的 :file:`procfs` "
#~ "文件系统中的各种文件来重启守护程序。"
#~ msgid ""
#~ "The second part of the problem is"
#~ " to determine whether or not running"
#~ " processes are part of a system "
#~ "service. The tool focuses on system "
#~ "services because most system services "
#~ "are background tasks with no direct "
#~ "user interaction. Fortunately, :command:`systemd`"
#~ " provides a simple way to:"
#~ msgstr ""
#~ "接下来的问题是确定正在运行的进程是否是系统服务的一部分。该工具侧重于系统服务,因为大多数系统服务都是后台任务,并不会与用户直接交互。幸运的是,:command:`systemd`"
#~ " 提供了一种简单的方法:"
#~ msgid "Determine which active tasks are within the system domain."
#~ msgstr "确定哪些活动任务在系统域内。"
#~ msgid "Determine which tasks map to which service."
#~ msgstr "确定哪些任务映射到哪个服务。"
#~ msgid ""
#~ "We combined both solutions into a "
#~ "low-overhead tool that shows which "
#~ "system daemons require a restart, as "
#~ "shown below:"
#~ msgstr "我们将这两种解决方案融合成一个开销很低的工具,用来显示哪些系统守护程序需要重启,如下所示:"
#~ msgid "Options for clr-service-restart"
#~ msgstr "clr-service-restart 的选项"
#~ msgid ""
#~ "The *disallow* option tells :command:`clr-"
#~ "service-restart` not to restart the "
#~ "specified daemon even if the OS "
#~ "defaults permit the daemon to be "
#~ "restarted. The :command:`clr-service-restart`"
#~ " daemon creates a symlink in "
#~ ":file:`/etc/clr-service-restart` that points"
#~ " to :file:`/dev/null` as a record. "
#~ "The example below tells :command:`clr-"
#~ "service-restart` not to restart the "
#~ "*rngd* daemon after an OS software "
#~ "update."
#~ msgstr ""
#~ "*disallow* 选项指示 :command:`clr-service-restart`"
#~ " 不要重启指定的守护程序,即使操作系统默认允许重启该守护程序。:command:`clr-service-"
#~ "restart` 守护程序会在 :file:`/etc/clr-service-"
#~ "restart` 中创建一个指向 :file:`/dev/null` 的符号链接作为记录。下面的示例指示"
#~ " :command:`clr-service-restart` 在操作系统软件更新后不要重启"
#~ " *rngd* 守护程序。"
#~ msgid "Monitor options for clr-service-restart"
#~ msgstr "clr-service-restart 的监控选项"
#~ msgid ""
#~ "To monitor :command:`clr-service-restart`, "
#~ "use one or both options described "
#~ "below."
#~ msgstr "要监控 :command:`clr-service-restart`,请使用下述一个或两个选项。"
@@ -0,0 +1,95 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/maintenance/time.rst:4
msgid "Set the time"
msgstr "设置时间"
#: ../../guides/maintenance/time.rst:6
msgid ""
"This guide describes how to reset the time in your |CL-ATTR| system when "
"the default :abbr:`NTP (Network Time Protocol)` servers cannot be "
"reached."
msgstr "本指南介绍了当无法访问默认 :abbr:`NTP (Network Time Protocol)` 服务器时,如何重置 |CL-ATTR| 系统中的时间。"
#: ../../guides/maintenance/time.rst:9
msgid "|CL| uses the `systemd-timesyncd.service` daemon to synchronize time."
msgstr "|CL| 使用 `systemd-timesyncd.service` 守护程序来同步时间。"
#: ../../guides/maintenance/time.rst:12
msgid "Install the :command:`sysadmin-basic` bundle."
msgstr "安装 :command:`sysadmin-basic` 捆绑包。"
#: ../../guides/maintenance/time.rst:18
msgid "Set your time zone. This example uses Los Angeles."
msgstr "设置时区。此示例中使用了洛杉矶。"
#: ../../guides/maintenance/time.rst:26
msgid ""
"To see a list of time zones, use the command: :command:`timedatectl list-"
"timezones | grep <locale>`"
msgstr "要查看时区列表,请使用 :command:`timedatectl list-timezones | grep <locale>` 命令"
#: ../../guides/maintenance/time.rst:29
msgid "Create a :file:`/etc/systemd/` directory."
msgstr "创建一个 :file:`/etc/systemd/` 目录。"
#: ../../guides/maintenance/time.rst:35
msgid ""
"Create a new file named :file:`/etc/systemd/timesyncd.conf` and enter the"
" following text."
msgstr "创建一个名为 :file:`/etc/systemd/timesyncd.conf` 的新文件,并输入以下文本。"
#: ../../guides/maintenance/time.rst:44
msgid "Enable the `systemd-timesyncd` service."
msgstr "启用 `systemd-timesyncd` 服务。"
#: ../../guides/maintenance/time.rst:52
msgid ""
"To check the service status, use the :command:`timedatectl status` "
"command."
msgstr "要检查服务状态,请使用 :command:`timedatectl status` 命令。"
#: ../../guides/maintenance/time.rst:54
msgid ""
"To restart the `timesyncd` daemon, enter :command:`systemctl restart "
"systemd-timesyncd` into your terminal emulator."
msgstr "要重启 `timesyncd` 守护程序,请在终端仿真器中输入 :command:`systemctl restart systemd-timesyncd`。"
#: ../../guides/maintenance/time.rst:57
msgid "**Congratulations!** You successfully set up the time in your |CL| system."
msgstr "祝贺您!您成功地在 |CL| 系统中设置了时间。"
#~ msgid ""
#~ "|CL-ATTR| uses the `systemd-"
#~ "timesyncd.service` daemon to synchronize time."
#~ msgstr ""
#~ msgid ""
#~ "This guide describes how to reset "
#~ "the time in your |CL| system when"
#~ " the default :abbr:`NTP (Network Time "
#~ "Protocol)` servers cannot be reached."
#~ msgstr ""
#~ msgid "Install the `sysadmin-basic` bundle."
#~ msgstr ""
@@ -0,0 +1,241 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/maintenance/validate-signatures.rst:4
msgid "Validate signatures"
msgstr "验证签名"
#: ../../guides/maintenance/validate-signatures.rst:7
msgid "This guide describes how to validate the contents of a |CL-ATTR| image."
msgstr "本指南介绍如何验证 |CL-ATTR| 映像的内容。"
#: ../../guides/maintenance/validate-signatures.rst:14
msgid "Overview"
msgstr "概述"
#: ../../guides/maintenance/validate-signatures.rst:16
msgid ""
"Validating the contents of an image is a manual process and is the same "
"process that :ref:`swupd-guide` performs internally."
msgstr "验证映像内容是一个手动过程,与 :ref:`swupd-guide` 在内部执行的过程相同。"
#: ../../guides/maintenance/validate-signatures.rst:19
msgid ""
"|CL| offers a way to validate the content of an image or an update. All "
"validation of content works by creating and signing a hash. A valid "
"signature creates a chain of trust. A broken chain of trust, seen as an "
"invalid signature, means the content is not valid."
msgstr "|CL| 提供了一种验证映像内容或更新内容的方法。所有内容验证都是通过创建哈希以及对哈希签名来实现的。有效的签名会创建一个信任链。信任链断裂被视为无效签名,意味着内容无效。"
#: ../../guides/maintenance/validate-signatures.rst:28
msgid "Image content validation"
msgstr "映像内容验证"
#: ../../guides/maintenance/validate-signatures.rst:30
msgid ""
"In the steps below, we used the installer image of the latest release of "
"|CL|. You may use any image of |CL| you choose."
msgstr "在下面的步骤中,我们使用了 |CL| 最新版本的安装程序映像。您可以使用您选择的任何 |CL| 映像。"
#: ../../guides/maintenance/validate-signatures.rst:33
msgid ""
"Download the image, the signature of the SHA512 sum of the image, and the"
" |CL| certificate used for signing the SHA512 sum."
msgstr "下载映像、映像 SHA512 总和的签名以及用于对 SHA512 总和签名的 |CL| 证书。"
#: ../../guides/maintenance/validate-signatures.rst:45
msgid "Generate the SHA256 sum of the |CL| certificate."
msgstr "生成 |CL| 证书的 SHA256 总和。"
#: ../../guides/maintenance/validate-signatures.rst:51
msgid ""
"Ensure the generated SHA256 sum of the |CL| certificate matches the "
"following SHA256 sum to verify the integrity of the certificate."
msgstr "确保生成的 |CL| 证书 SHA256 总和与以下 SHA256 总和匹配,以验证证书的完整性。"
#: ../../guides/maintenance/validate-signatures.rst:58
msgid "Generate the SHA512 sum of the image and save it to a file."
msgstr "生成映像的 SHA512 总和,并将其保存到文件中。"
#: ../../guides/maintenance/validate-signatures.rst:64
msgid ""
"Ensure the signature of the SHA512 sum of the image was created using the"
" |CL| certificate. This confirms that the image is trusted and has not "
"been modified."
msgstr "确保使用 |CL| 证书创建了映像 SHA512 总和的签名。这会确认映像是可信的,并且没有经过修改。"
#: ../../guides/maintenance/validate-signatures.rst:74
#: ../../guides/maintenance/validate-signatures.rst:125
msgid ""
"The :command:`-purpose any` option is required when using OpenSSL 1.1. If"
" you use an earlier version of OpenSSL, omit this option to perform "
"signature validation. The :command:`openssl version` command may be used"
" to determine the version of OpenSSL in use."
msgstr "使用 OpenSSL 1.1 时,:command:`-purpose any` 选项是必需的。如果使用 OpenSSL 的早期版本,请在执行签名验证时忽略此选项。您可以使用 :command:`openssl version` 命令来确定正在使用的 OpenSSL 的版本。"
#: ../../guides/maintenance/validate-signatures.rst:79
msgid ""
"The output should contain \"Verification successful\". If the output "
"contains \"bad_signature\" anywhere, then the image is not trustworthy."
msgstr "输出应包含 \"Verification successful\"。如果输出在任何地方包含 \"bad_signature\",则映像不可信。"
#: ../../guides/maintenance/validate-signatures.rst:83
msgid "Update content validation"
msgstr "更新内容验证"
#: ../../guides/maintenance/validate-signatures.rst:85
msgid ""
"**swupd** validates all update content automatically before applying the "
"update content. The process swupd follows internally is illustrated here "
"with manual steps using the latest |CL| release. There is no need to "
"perform these steps manually when performing a :command:`swupd update`."
msgstr "swupd 会在应用更新内容之前自动验证所有更新内容。这里以最新 |CL| 版本为例,通过手动步骤说明 swupd 在内部遵循的过程。执行 :command:`swupd update` 时,不需要手动执行这些步骤。"
#: ../../guides/maintenance/validate-signatures.rst:90
msgid ""
"Download the :abbr:`MoM (top-level manifest)`, the signature of the MoM, "
"and the Swupd certificate used for signing the signature of the MoM."
msgstr "下载 :abbr:`MoM (top-level manifest)`、MoM 签名以及用于对 MoM 签名进行签名的 Swupd 证书。"
#: ../../guides/maintenance/validate-signatures.rst:102
msgid "Generate the SHA256 sum of the swupd certificate."
msgstr "生成 swupd 证书的 SHA256 总和。"
#: ../../guides/maintenance/validate-signatures.rst:108
msgid ""
"Confirm that the generated SHA256 sum of the swupd certificate matches "
"the SHA256 sum shown below to verify the integrity of the certificate."
msgstr "确认生成的 swupd 证书 SHA256 总和与以下 SHA256 总和匹配,以验证证书的完整性。"
#: ../../guides/maintenance/validate-signatures.rst:115
msgid ""
"Confirm that the signature of the MoM was created using the Swupd "
"certificate. This signature validates the update content is trustworthy "
"and has not been modified."
msgstr "确认 MoM 签名是使用 Swupd 证书创建的。此签名会验证更新内容是可信的,没有经过修改。"
#: ../../guides/maintenance/validate-signatures.rst:132
msgid ""
"The SHA512 sum of the MoM is not generated and then signed. Instead, the "
"MoM is signed directly because it is small in size compared to an image "
"of |CL|."
msgstr "系统不会生成 MoM 的 SHA512 总和,也不会对该 SHA512 总和签名。相反,系统直接对 MoM 签名,因为它的大小比 |CL| 映像小。"
#: ../../guides/maintenance/validate-signatures.rst:136
msgid ""
"The output should contain \"Verification successful\". If the output "
"contains \"bad_signature\" anywhere, then the MoM cannot be trusted. "
"Because the MoM contains a list of hashes for bundle manifests, if the "
"MoM cannot be trusted, then the bundle content cannot be trusted."
msgstr "输出应包含 \"Verification successful\"。如果输出在任何地方包含 \"bad_signature\",则 MoM 不可信。由于 MoM 包含捆绑包清单的哈希列表,因此如果 MoM 不可信,那么捆绑包内容也不可信。"
#~ msgid ""
#~ "|CL-ATTR| offers a way to validate"
#~ " the content of an image or an"
#~ " update. All validation of content "
#~ "works by creating and signing a "
#~ "hash. A valid signature creates a "
#~ "chain of trust. A broken chain of"
#~ " trust, seen as an invalid signature,"
#~ " means the content is not valid."
#~ msgstr ""
#~ msgid ""
#~ "This guide covers how to validate "
#~ "the contents of an image, which is"
#~ " a manual process and is the "
#~ "same process ``swupd`` performs internally "
#~ "to validate an update."
#~ msgstr ""
#~ msgid ""
#~ "For the outlined steps, the installer"
#~ " image of the latest release of "
#~ "|CL| is used for illustrative purposes."
#~ " You may use any image of |CL|"
#~ " you choose."
#~ msgstr ""
#~ msgid ""
#~ "Ensure the signature of the SHA512 "
#~ "sum of the image was created using"
#~ " the |CL| certificate. This validates "
#~ "the image is trusted and it has"
#~ " not been modified."
#~ msgstr ""
#~ msgid ""
#~ "The `-purpose any` option is required"
#~ " when using OpenSSL 1.1. If using"
#~ " an earlier version of OpenSSL, omit"
#~ " this option to perform signature "
#~ "validation. The `openssl version` command "
#~ "may be used to determine the "
#~ "version of OpenSSL in use."
#~ msgstr ""
#~ msgid ""
#~ "The output should contain ``Verification "
#~ "successful``. If the output contains "
#~ "``bad_signature`` anywhere, then the image "
#~ "is not trustworthy."
#~ msgstr ""
#~ msgid ""
#~ "``swupd`` validates all update content "
#~ "automatically before applying the update "
#~ "content. The process ``swupd`` follows "
#~ "internally is illustrated here with "
#~ "manual steps using the latest |CL| "
#~ "release. There is no need to "
#~ "perform these steps manually when "
#~ "performing a ``swupd update``."
#~ msgstr ""
#~ msgid "Generate the SHA256 sum of the Swupd certificate."
#~ msgstr ""
#~ msgid ""
#~ "Ensure the generated SHA256 sum of "
#~ "the Swupd certificate matches following "
#~ "SHA256 sum to verify the integrity "
#~ "of the certificate."
#~ msgstr ""
#~ msgid ""
#~ "Ensure the signature of the MoM "
#~ "was created using the Swupd certificate."
#~ " This signature validates the update "
#~ "content is trustworthy and has not "
#~ "been modified."
#~ msgstr ""
#~ msgid ""
#~ "The output should contain ``Verification "
#~ "successful``. If the output contains "
#~ "``bad_signature`` anywhere, then the MoM "
#~ "cannot be trusted. Because the MoM "
#~ "contains a list of hashes for "
#~ "bundle manifests, if the MoM cannot "
#~ "be trusted, then the bundle content "
#~ "cannot be trusted."
#~ msgstr ""
@@ -0,0 +1,217 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/network/custom-clear-container.rst:4
msgid "Build a custom |CL-ATTR| based Docker container image"
msgstr "根据 Docker 容器映像构建一个自定义 |CL-ATTR|"
#: ../../guides/network/custom-clear-container.rst:6
msgid ""
"This guide contains the steps to build a custom container image. The "
"official base |CL-ATTR| container image is published on Docker\\* Hub and"
" is updated on a regular basis."
msgstr "本指南包含构建自定义容器映像的步骤。官方基础版 |CL-ATTR| 容器映像发布在 Docker\\* Hub 上,而且会定期更新。"
#: ../../guides/network/custom-clear-container.rst:15
msgid "Prerequisites"
msgstr "必备条件"
#: ../../guides/network/custom-clear-container.rst:17
msgid ""
"You must perform these steps on a |CL| system because the :abbr:`swupd "
"(software updater)` is used to manage bundles in the container."
msgstr "您必须在 |CL| 系统上执行这些步骤,因为系统使用 :abbr:`swupd (software updater)` 管理容器中的捆绑包。"
#: ../../guides/network/custom-clear-container.rst:20
msgid ""
"You must install the :file:`containers-basic` bundle on the |CL| system "
"or Docker will not work."
msgstr "您必须在 |CL| 系统上安装 :file:`containers-basic` 捆绑包,否则 Docker 将无法运行。"
#: ../../guides/network/custom-clear-container.rst:22
msgid "You have a basic understanding of Docker."
msgstr "您需要对 Docker 有基本了解。"
#: ../../guides/network/custom-clear-container.rst:25
msgid "Build the base container image"
msgstr "构建基础容器映像"
#: ../../guides/network/custom-clear-container.rst:27
msgid "Log in and get root privileges."
msgstr "登录并获得 root 特权。"
#: ../../guides/network/custom-clear-container.rst:33
msgid "Verify Docker is installed and running."
msgstr "确认 Docker 已安装且正在运行。"
#: ../../guides/network/custom-clear-container.rst:39
msgid "If Docker is installed and running, the output is similar to this example:"
msgstr "如果 Docker 已安装且正在运行,输出类似于以下示例:"
#: ../../guides/network/custom-clear-container.rst:82
msgid "If Docker is not installed, enter the commands:"
msgstr "如果 Docker 未安装,请输入以下命令:"
#: ../../guides/network/custom-clear-container.rst:89
msgid "Use :command:`os-install` to download and install the bundles."
msgstr "使用 :command:`os-install` 下载并安装捆绑包。"
#: ../../guides/network/custom-clear-container.rst:96
msgid "The swupd example uses the following flags:"
msgstr "swupd 示例使用以下标志:"
#: ../../guides/network/custom-clear-container.rst:98
msgid ":command:`os-install` tells swupd to download and install."
msgstr ":command:`os-install` 指示 swupd 执行下载和安装。"
#: ../../guides/network/custom-clear-container.rst:99
msgid ":command:`-V / --version` specifies the version of the |CL| bundles."
msgstr ":command:`-V / --version` 指定 |CL| 捆绑包版本。"
#: ../../guides/network/custom-clear-container.rst:100
msgid ":command:`--url` specifies the URL of the bundles repository."
msgstr ":command:`--url` 指定捆绑包存储库的 URL。"
#: ../../guides/network/custom-clear-container.rst:101
msgid ""
":command:`--statedir` specifies the state directory where downloaded "
"bundles and any state information are stored."
msgstr ":command:`--statedir` 指定用来存储下载的捆绑包和任何状态信息的状态目录。"
#: ../../guides/network/custom-clear-container.rst:103
msgid ""
":command:`--no-boot-update` tells swupd to skip updating boot files "
"because boot files are not required for a container."
msgstr ":command:`--no-boot-update` 指示 swupd 跳过更新引导文件,因为容器不需要引导文件。"
#: ../../guides/network/custom-clear-container.rst:106
msgid ""
"For more information on swupd flags, enter the :command:`swupd os-install"
" -h` command."
msgstr "有关 swupd 标志的详细信息,请输入 :command:`swupd os-install -h` 命令。"
#: ../../guides/network/custom-clear-container.rst:109
#: ../../guides/network/custom-clear-container.rst:172
#: ../../guides/network/custom-clear-container.rst:199
#: ../../guides/network/custom-clear-container.rst:233
#: ../../guides/network/custom-clear-container.rst:295
msgid "Example output:"
msgstr "结果示例:"
#: ../../guides/network/custom-clear-container.rst:146
msgid "The WARNING message is expected and can be ignored."
msgstr "警告消息是意料之中的,可以忽略。"
#: ../../guides/network/custom-clear-container.rst:148
msgid "Create a tarball and compress it."
msgstr "创建一个 tarball 并压缩它。"
#: ../../guides/network/custom-clear-container.rst:155
msgid "Create the Dockerfile to build the image."
msgstr "创建 Dockerfile 来构建映像。"
#: ../../guides/network/custom-clear-container.rst:166
msgid "Build the |CL| container image."
msgstr "构建 |CL| 容器映像。"
#: ../../guides/network/custom-clear-container.rst:193
msgid "List the newly created |CL| container image."
msgstr "列出新创建的 |CL| 容器映像。"
#: ../../guides/network/custom-clear-container.rst:206
msgid "Launch the built |CL| container."
msgstr "启动已构建的 |CL| 容器。"
#: ../../guides/network/custom-clear-container.rst:213
msgid "Manage bundles in a container"
msgstr "管理容器中的捆绑包"
#: ../../guides/network/custom-clear-container.rst:215
msgid ""
"You can add and remove bundles from a |CL| container using the "
":command:`RUN swupd` command in the Dockerfile."
msgstr "您可以使用 Dockerfile 中的 :command:`RUN swupd` 命令在 |CL| 容器中添加和移除捆绑包。"
#: ../../guides/network/custom-clear-container.rst:219
msgid "Add a bundle"
msgstr "添加捆绑包"
#: ../../guides/network/custom-clear-container.rst:221
msgid ""
"This example Dockerfile adds the :file:`pxe-server` bundle to an existing"
" |CL| Docker image:"
msgstr "本示例 Dockerfile 将 :file:`pxe-server` 捆绑添加到现有 |CL| Docker 映像:"
#: ../../guides/network/custom-clear-container.rst:277
msgid ""
"The WARNING message can be ignored because systemd does not run inside a "
"container."
msgstr "警告消息可以忽略,因为 systemd 不在容器内运行。"
#: ../../guides/network/custom-clear-container.rst:281
msgid "Remove a bundle"
msgstr "移除捆绑包"
#: ../../guides/network/custom-clear-container.rst:283
msgid ""
"This example Dockerfile removes the :file:`pxe-server` bundle from an "
"existing |CL| Docker image:"
msgstr "本示例 Dockerfile 从现有的 |CL| Docker 映像中移除 :file:`pxe-server` 捆绑包:"
#~ msgid ""
#~ "The official base |CL-ATTR| container"
#~ " image is published on Docker\\* Hub"
#~ " and is updated on a regular "
#~ "basis. This guide contains the steps "
#~ "to build a custom container image."
#~ msgstr ""
#~ msgid "Use `os-install` to download and install the bundles."
#~ msgstr ""
#~ msgid "The `swupd` example uses the following flags:"
#~ msgstr ""
#~ msgid ":command:`os-install` tells `swupd` to download and install."
#~ msgstr ""
#~ msgid ""
#~ ":command:`--no-boot-update` tells `swupd` "
#~ "to skip updating boot files because "
#~ "boot files are not required for a"
#~ " container."
#~ msgstr ""
#~ msgid ""
#~ "For more information on `swupd` flags,"
#~ " enter the :command:`swupd os-install "
#~ "-h` command."
#~ msgstr ""
#~ msgid "The `WARNING` message is expected and can be ignored."
#~ msgstr ""
#~ msgid ""
#~ "The `WARNING` message can be ignored "
#~ "because systemd does not run inside "
#~ "a container."
#~ msgstr ""
@@ -0,0 +1,438 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/network/dpdk.rst:4
msgid "Use DPDK to send packets between platforms"
msgstr "使用 DPDK 在平台之间发送数据包"
#: ../../guides/network/dpdk.rst:6
msgid "This guide describes how to send packets between two platforms."
msgstr "本指南介绍如何在两个平台之间发送数据包。"
#: ../../guides/network/dpdk.rst:13
msgid "Overview"
msgstr "概述"
#: ../../guides/network/dpdk.rst:15
msgid ""
"Figure 1 shows how to send packets between two platforms in a simple "
"configuration. The example uses the :abbr:`Data Plane Development Kit "
"(DPDK)`, which is a set of libraries, drivers, sample applications, and "
"tools for fast packet processing."
msgstr "图 1 显示了如何通过简单的配置在两个平台之间发送数据包。该示例使用了 :abbr:`Data Plane Development Kit (DPDK)`,它是一套用于快速处理数据包的库、驱动程序、示例应用程序和工具。"
#: ../../guides/network/dpdk.rst:24
msgid "Figure 1: Environment for l3fwd DPDK application"
msgstr "图 1l3fwd DPDK 应用程序的环境"
#: ../../guides/network/dpdk.rst:26
msgid "This example uses the following DPDK components:"
msgstr "本示例使用以下 DPDK 组件:"
#: ../../guides/network/dpdk.rst:28
msgid "pktgen: Traffic generator. See `pktgen`_ documentation for details."
msgstr "pktgen:流量生成器。有关详细信息,请参阅 `pktgen`_ 文档。"
#: ../../guides/network/dpdk.rst:29
msgid ""
"l3fwd: Layer 3 forwarding example application. See `l3fwd`_ documentation"
" for details."
msgstr "l3fwd:第 3 层转发示例应用程序。有关详细信息,请参阅 `l3fwd`_ 文档。"
#: ../../guides/network/dpdk.rst:33
msgid "Prerequisites"
msgstr "必备条件"
#: ../../guides/network/dpdk.rst:35
msgid "Two platforms using |CL-ATTR| release `13330`_ or higher."
msgstr "两个平台使用 |CL-ATTR| `13330`_ 或更高版本。"
#: ../../guides/network/dpdk.rst:36
msgid "Both images must include the :command:`kernel-native` bundle."
msgstr "两个映像都必须包含 :command:`kernel-native` 捆绑包。"
#: ../../guides/network/dpdk.rst:37
msgid "Install the :command:`network-basic-dev` bundle with the command:"
msgstr "使用以下命令安装 :command:`network-basic-dev` 捆绑包:"
#: ../../guides/network/dpdk.rst:43
msgid ""
"Each platform must have at least one :abbr:`NIC (Network Interface "
"Card)`. Check the `DPDK project`_ for the list of supported `dpdk.org "
"NICs`_."
msgstr "每个平台必须至少有一个 :abbr:`NIC (Network Interface Card)`。查阅 `DPDK project`_ 了解受支持的 `dpdk.org NICs`_ 列表。"
#: ../../guides/network/dpdk.rst:46
msgid "Two network cables."
msgstr "两根网线。"
#: ../../guides/network/dpdk.rst:49
msgid "Install dpdk and build l3fwd example (Platform B)"
msgstr "安装 dpdk 并构建 l3fwd 示例(平台 B"
#: ../../guides/network/dpdk.rst:51
msgid "Change to the :file:`l3fwd` example directory."
msgstr "切换到 :file:`l3fwd` 示例目录。"
#: ../../guides/network/dpdk.rst:57
msgid "Assign :envvar:`RTE_SDK` variable to the makefiles path."
msgstr "将 :envvar:`RTE_SDK` 变量分配给 makefiles 路径。"
#: ../../guides/network/dpdk.rst:63
msgid ""
"Assign :envvar:`RTE_TARGET` variable to the location of the gcc\\* config"
" file."
msgstr "将 :envvar:`RTE_TARGET` 变量分配给 gcc\\* 配置文件的位置。"
#: ../../guides/network/dpdk.rst:70
msgid ""
"Build the `l3fwd` application and add the configuration header to the "
":makevar:`CFLAGS` variable."
msgstr "构建 `l3fwd` 应用程序,并将配置头文件添加到 :makevar:`CFLAGS` 变量中。"
#: ../../guides/network/dpdk.rst:79
msgid "Build pktgen (Platform A)"
msgstr "构建 pktgen(平台 A"
#: ../../guides/network/dpdk.rst:81
msgid "Download the `pktgen tar package`_ v3.1.2 or newer."
msgstr "下载 `pktgen tar package`_ v3.1.2 或更高版本。"
#: ../../guides/network/dpdk.rst:83
msgid "Decompress packages and move to uncompressed source directory."
msgstr "解压缩软件包,并切换到未解压缩的源目录。"
#: ../../guides/network/dpdk.rst:85
msgid "Assign :envvar:`RTE_SDK` variable to the path where makefiles are located."
msgstr "将 :envvar:`RTE_SDK` 变量分配给 makefiles 所在的路径。"
#: ../../guides/network/dpdk.rst:91
msgid "Assign :envvar:`RTE_TARGET` to the location of the gcc config file."
msgstr "将 :envvar:`RTE_TARGET` 分配给 gcc 配置文件的位置。"
#: ../../guides/network/dpdk.rst:97
msgid ""
"Build the `pktgen` project and set the "
":makevar:`CONFIG_RTE_BUILD_SHARED_LIB` variable to \"n\"."
msgstr "构建 `pktgen` 项目,并将 :makevar:`CONFIG_RTE_BUILD_SHARED_LIB` 变量设置为 \"n\"。"
#: ../../guides/network/dpdk.rst:105
msgid "Bind NICs to DPDK kernel drivers (Platforms A and B)"
msgstr "将网卡绑定到 DPDK 内核驱动程序(平台 A 和平台 B)"
#: ../../guides/network/dpdk.rst:107
msgid ""
"The `l3fwd` application uses two NICs. The DPDK includes tools for "
"binding NICs to DPDK modules to run DPDK applications."
msgstr "`l3fwd` 应用程序使用两个网卡。DPDK 包括将网卡绑定到 DPDK 模块以运行 DPDK 应用程序的工具。"
#: ../../guides/network/dpdk.rst:110
msgid "Load the DPDK I/O kernel module."
msgstr "加载 DPDK I/O 内核模块。"
#: ../../guides/network/dpdk.rst:116
msgid ""
"Check the NIC status to determine which network cards are not busy. When "
"another application is using them, the status shows \"Active\", and those"
" NICs cannot be bound."
msgstr "检查网卡以确定哪些网卡为空闲状态。另一个应用程序正在使用网卡时,状态显示为 \"Active\",此时这些网卡无法绑定。"
#: ../../guides/network/dpdk.rst:124
msgid ""
"Bind two available NICs. The general syntax for binding is: :command"
":`dpdk-devbind --bind=vfio-pci <device-entry>`. A working example is "
"shown below:"
msgstr "绑定两个可用的网卡。绑定操作的常规语法是 :command:`dpdk-devbind --bind=vfio-pci <device-entry>`。下面显示了一个工作示例:"
#: ../../guides/network/dpdk.rst:132
msgid ""
"Check the NIC status to verify that the NICs are bound correctly. If "
"successful, `drv` displays the value `igb_uio`, which confirms that the "
"NICs are using the DPDK modules."
msgstr "检查网卡状态,验证网卡绑定是否正确。如果绑定成功,`drv` 显示值 `igb_uio`,这确认了网卡正在使用 DPDK 模块。"
#: ../../guides/network/dpdk.rst:138
msgid "Set hugepages (Platforms A and B)"
msgstr "设置大页(平台 A 和 B"
#: ../../guides/network/dpdk.rst:140
msgid ""
"|CL| supports `hugepages` for the large memory pool allocation used for "
"packet buffers."
msgstr "|CL| 支持 `hugepages`,即可以分配大内存池,并将其用于数据包缓冲区。"
#: ../../guides/network/dpdk.rst:143
msgid "Set the number of hugepages."
msgstr "设置大页数量。"
#: ../../guides/network/dpdk.rst:149
msgid "Allocate pages on NUMA machines."
msgstr "在 NUMA 计算机上分配页面。"
#: ../../guides/network/dpdk.rst:156
msgid "Make memory available for DPDK."
msgstr "为 DPDK 分配内存。"
#: ../../guides/network/dpdk.rst:162
msgid ""
"For more information, refer to the `DPDK guide`_ System Requirements "
"section."
msgstr "有关详细信息,请参阅 `DPDK guide`_ 系统要求一节。"
#: ../../guides/network/dpdk.rst:167
msgid "Set up the physical environment (Platforms A and B)"
msgstr "设置物理环境(平台 A 和 B"
#: ../../guides/network/dpdk.rst:169
msgid ""
"Connect the NICs on Platform A to the NICs on Platform B using the "
"network cables as shown in figure 2."
msgstr "如图 2 所示,使用网线将平台 A 上的网卡连接到平台 B 上的网卡。"
#: ../../guides/network/dpdk.rst:174
msgid "Figure 2: Physical network environment"
msgstr "图 2:物理网络环境"
#: ../../guides/network/dpdk.rst:178
msgid "Run l3fwd application (Platform B)"
msgstr "运行 l3fwd 应用程序(平台 B"
#: ../../guides/network/dpdk.rst:180
msgid ""
"The `l3fwd` application is one of the DPDK examples available when you "
"install the :file:`dpdk-dev` bundle. `l3fwd` forwards packets from one "
"NIC to another. For details, refer to the `l3fwd`_ documentation."
msgstr "`l3fwd` 应用程序是安装 :file:`dpdk-dev` 捆绑包时可用的 DPDK 示例之一。`l3fwd` 将数据包从一个网卡转发到另一个网卡。有关详细信息,请参阅 `l3fwd`_ 文档。"
#: ../../guides/network/dpdk.rst:184
msgid "Open the l3fwd example directory."
msgstr "打开 l3fwd 示例目录。"
#: ../../guides/network/dpdk.rst:190
msgid "**This step is very important.**"
msgstr "**这一步非常重要。**"
#: ../../guides/network/dpdk.rst:192
msgid "DPDK needs poll mode drivers to operate."
msgstr "DPDK 需要借助轮询模式驱动程序才能运行。"
#: ../../guides/network/dpdk.rst:193
msgid "Poll mode drivers are shared objects in :file:`/usr/lib64`."
msgstr "轮询模式驱动程序是 :file:`/usr/lib64` 中的共享对象。"
#: ../../guides/network/dpdk.rst:194
msgid "See the full list of supported NICs at `dpdk.org NICs`_."
msgstr "请在 `dpdk.org NICs`_ 查看受支持的网卡的完整列表。"
#: ../../guides/network/dpdk.rst:195
msgid ""
"You must know which kernel module each NIC is using and choose a poll "
"mode driver that corresponds to your NICs."
msgstr "您必须知道每个网卡使用的是哪个内核模块,并选择与网卡相对应的轮询模式驱动程序。"
#: ../../guides/network/dpdk.rst:198
msgid ""
"NIC binding and `pktgen` configuration depends upon network use cases and"
" available system resources. Use the :command:`-d` flag to set the poll "
"mode driver."
msgstr "网卡绑定和 `pktgen` 配置取决于网络用例和可用的系统资源。使用 :command:`-d` 标志设置轮询模式驱动程序。"
#: ../../guides/network/dpdk.rst:202
msgid ""
"The following example assumes that the NICs use the `e1000` network "
"driver and the `e1000` poll mode driver. The :file:`librte_pmd_e1000.so` "
"is located in :file:`/usr/lib64` in |CL|."
msgstr "以下示例假设网卡使用 `e1000` 网络驱动程序和 `e1000` 轮询模式驱动程序。:file:`librte_pmd_e1000.so` 位于 |CL| 中的 :file:`/usr/lib64` 中。"
#: ../../guides/network/dpdk.rst:210
msgid ""
"The `l3fwd` application shows port initialization details at startup. "
"After port 0 initialization completes, `l3fwd` shows a MAC address and "
"information for port 1."
msgstr "`l3fwd` 应用程序在启动时显示端口初始化详细信息。端口 0 初始化完成后,`l3fwd` 显示端口 1 的 MAC 地址和信息。"
#: ../../guides/network/dpdk.rst:214
msgid "Save the MAC address for configuring the `pktgen` project."
msgstr "保存该 MAC 地址以配置 `pktgen` 项目。"
#: ../../guides/network/dpdk.rst:217
msgid "Run pktgen application (Platform A)"
msgstr "运行 pktgen 应用程序(平台 A"
#: ../../guides/network/dpdk.rst:219
msgid "`pktgen` is a network traffic generator included in the DPDK."
msgstr "`pktgen` 是 DPDK 中包含的网络流量生成器。"
#: ../../guides/network/dpdk.rst:221
msgid ""
"`pktgen` configuration depends upon the network setup and the available "
"system resources. The following example shows a basic configuration."
msgstr "`pktgen` 配置取决于网络设置和可用的系统资源。以下示例显示了一个基本配置。"
#: ../../guides/network/dpdk.rst:229
msgid "Enable active colorful output (optional)."
msgstr "启用活动彩色输出(可选)。"
#: ../../guides/network/dpdk.rst:235
msgid ""
"Use the MAC addresses shown by the `l3fwd` application during "
"initialization. The command to set the MAC addresses in `pktgen` has the "
"format:"
msgstr "使用初始化期间 `l3fwd` 应用程序显示的 MAC 地址。在 `pktgen` 中设置 MAC 地址的命令格式如下:"
#: ../../guides/network/dpdk.rst:242 ../../guides/network/dpdk.rst:301
#: ../../guides/network/dpdk.rst:319
msgid "Here is a working example:"
msgstr "以下是一个工作示例:"
#: ../../guides/network/dpdk.rst:249
msgid "Send packets."
msgstr "发送数据包。"
#: ../../guides/network/dpdk.rst:255
msgid "For more details, see the `pktgen`_ documentation."
msgstr "有关详细信息,请参阅 `pktgen`_ 文档。"
#: ../../guides/network/dpdk.rst:258
msgid "Appendix A: Use pass-through for virtual machines"
msgstr "附录 A:为虚拟机使用直通"
#: ../../guides/network/dpdk.rst:260
msgid ""
"This section explains how to set up a virtual environment where virtual "
"machines control the NICs on the host."
msgstr "本节说明如何设置由虚拟机控制主机上网卡的虚拟环境。"
#: ../../guides/network/dpdk.rst:263
msgid "Create a new directory and move to it."
msgstr "创建一个新目录并切换到该目录。"
#: ../../guides/network/dpdk.rst:265
msgid ""
"Download or create a :file:`start_qemu.sh` script for running a kvm "
"virtual machine:"
msgstr "下载或创建 :file:`start_qemu.sh` 脚本以运行 kvm 虚拟机:"
#: ../../guides/network/dpdk.rst:272
msgid "Download a bare-metal image of |CL| and rename it as :file:`clear.img`."
msgstr "下载 |CL| 的裸机映像,并将其重命名为 :file:`clear.img`。"
#: ../../guides/network/dpdk.rst:274
msgid "Look for an Ethernet\\* device entry that contains vendor and device ID:"
msgstr "查找包含供应商和设备 ID 的 Ethernet\\* 设备条目:"
#: ../../guides/network/dpdk.rst:280
msgid "An example output:"
msgstr "示例输出如下:"
#: ../../guides/network/dpdk.rst:286
msgid ""
"where `03:00.0` is the device entry and `8086:1521` is the `vendor:device"
" ID`. Record this information, because you need it to unbind the NICs "
"from a host."
msgstr "其中 `03:00.0` 是设备条目,`8086:1521` 是 `vendor:device ID`。记下此信息,因为后面需要用到它将网卡与主机解除绑定。"
#: ../../guides/network/dpdk.rst:291
msgid ""
"Unbind the NICs from the host to do pass-through with virtual machines. "
"|CL| supports this action. The commands take the format:"
msgstr "解除网卡与主机的绑定,以便与虚拟机进行直通通信。|CL| 支持此类通信。命令采用以下格式:"
#: ../../guides/network/dpdk.rst:310
msgid ""
"Assign the unbound NICs to the KVM virtual machine (guest). Modify the "
":file:`start_qemu.sh` script in `qemu-system-x86_64` arguments, and add "
"the lines with the host's NICs information in the format:"
msgstr "将未绑定的网卡分配给 KVM 虚拟机(来宾)。修改 `qemu-system-x86_64` 参数中的 :file:`start_qemu.sh` 脚本,并按以下格式添加含有主机网卡信息的行:"
#: ../../guides/network/dpdk.rst:326
msgid ""
"Add more NUMA machines to the virtual machine by adding lines to the "
"Makefile boot target in the format:"
msgstr "按照以下格式向 Makefile 引导目标添加行,从而将更多 NUMA 计算机添加到虚拟机:"
#: ../../guides/network/dpdk.rst:333
msgid ""
"Here is a working example for a virtual machine with 4096 memory and four"
" CPUs:"
msgstr "下面是一个具有 4096 内存和四个 CPU 的虚拟机的工作示例:"
#: ../../guides/network/dpdk.rst:341
msgid "Each NUMA machine must use the same quantity of memory."
msgstr "每台 NUMA 计算机必须使用相同数量的内存。"
#: ../../guides/network/dpdk.rst:343
msgid "Run the :file:`start_qemu.sh` script."
msgstr "运行 :file:`start_qemu.sh` 脚本。"
#~ msgid ""
#~ "This document describes how to send "
#~ "packets between two platforms in the "
#~ "simple configuration shown in :ref:`Figure "
#~ "1 <f1>`. The example uses the "
#~ ":abbr:`Data Plane Development Kit (DPDK)`, "
#~ "which is a set of libraries, "
#~ "drivers, sample applications, and tools "
#~ "for fast packet processing."
#~ msgstr ""
#~ msgid "pktgen: Traffic generator. See `pktgen documentation`_ for details."
#~ msgstr ""
#~ msgid ""
#~ "l3fwd: Layer 3 forwarding example "
#~ "application. See `l3fwd documentation`_ for"
#~ " details."
#~ msgstr ""
#~ msgid "Both images must include the :file:`kernel-native bundle`."
#~ msgstr ""
#~ msgid "Install the :file:`network-basic-dev` bundle with the command:"
#~ msgstr ""
#~ msgid ""
#~ "Check the NIC status to determine "
#~ "which network cards are not busy. "
#~ "When another application is using them,"
#~ " the status shows `Active`, and those"
#~ " NICs cannot be bound."
#~ msgstr ""
#~ msgid ""
#~ "Connect the NICs on Platform A to"
#~ " the NICs on Platform B using "
#~ "the network cables as shown in "
#~ ":ref:`Figure 2<f2>`."
#~ msgstr ""
#~ msgid ""
#~ "The `l3fwd` application is one of "
#~ "the DPDK examples available when you "
#~ "install the :file:`dpdk-dev` bundle. "
#~ "`l3fwd` forwards packets from one NIC"
#~ " to another. For details, refer to"
#~ " the `l3fwd documentation`_."
#~ msgstr ""
#~ msgid "For more details, see the `pktgen documentation`_."
#~ msgstr ""
@@ -0,0 +1,406 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/network/ipxe-install.rst:4
msgid "Install over the network with iPXE"
msgstr "使用 iPXE 通过网络安装"
#: ../../guides/network/ipxe-install.rst:6
msgid ""
"This guide describes how to install |CL-ATTR| using :abbr:`PXE (Pre-boot "
"Execution Environment)` over the network."
msgstr "本指南介绍如何通过网络使用 :abbr:`PXE (Pre-boot Execution Environment)` 安装 |CL-ATTR|。"
#: ../../guides/network/ipxe-install.rst:14
msgid "Overview"
msgstr "概述"
#: ../../guides/network/ipxe-install.rst:16
msgid ""
"PXE is an industry standard that describes client-server interaction with"
" network-boot software and uses the DHCP and TFTP protocols. This guide "
"shows one method of using the PXE environment to install |CL|."
msgstr "PXE 是描述客户端-服务器与网络引导软件交互的行业标准,并使用 DHCP 和 TFTP 协议。本指南介绍了一种使用 PXE 环境安装 |CL| 的方法。"
#: ../../guides/network/ipxe-install.rst:20
msgid ""
"The PXE extension called `iPXE`_ adds support for additional protocols "
"such as HTTP, :abbr:`iSCSI (Internet Small Computer Systems Interface)`, "
":abbr:`AoE (ATA over Ethernet\\*)`, and :abbr:`FCoE (Fiber Channel over "
"Ethernet\\*)`. iPXE enables network booting on computers with no built-in"
" PXE support."
msgstr "名为 `iPXE`_ 的 PXE 扩展新增了对 HTTP、:abbr:`iSCSI (Internet Small Computer Systems Interface)`、:abbr:`AoE (ATA over Ethernet\\*)` 和 :abbr:`FCoE (Fiber Channel over Ethernet\\*)` 等协议的支持。iPXE 支持在没有内置 PXE 支持的计算机上使用网络引导。"
#: ../../guides/network/ipxe-install.rst:25
msgid ""
"To install |CL| through iPXE, you must create a PXE client. Figure 1 "
"depicts the flow of information between a PXE server and a PXE client."
msgstr "要通过 iPXE 安装 |CL|,必须创建一个 PXE 客户端。图 1 描述了 PXE 服务器和 PXE 客户端之间的信息流。"
#: ../../guides/network/ipxe-install.rst:31
msgid "Figure 1: PXE information flow."
msgstr "图 1PXE 信息流。"
#: ../../guides/network/ipxe-install.rst:35
msgid ""
"The |CL| image that boots through the PXE process automatically erases "
"all data and partitions on the PXE client system and creates 3 new "
"partitions to install onto."
msgstr "通过 PXE 过程引导的 |CL| 映像会自动擦除 PXE 客户端系统上的所有数据和分区,并创建 3 个新分区来安装该映像。"
#: ../../guides/network/ipxe-install.rst:40
msgid "Prerequisites"
msgstr "必备条件"
#: ../../guides/network/ipxe-install.rst:42
msgid "Before booting with iPXE, make the following preparations."
msgstr "使用 iPXE 引导之前,请做好以下准备。"
#: ../../guides/network/ipxe-install.rst:44
msgid ""
"Connect the PXE server and PXE clients to a switch on a private network, "
"as shown in figure 2."
msgstr "将 PXE 服务器和 PXE 客户端连接到专用网络上的交换机,如图 2 所示。"
#: ../../guides/network/ipxe-install.rst:50
msgid "Figure 2: Network topology."
msgstr "图 2:网络拓扑。"
#: ../../guides/network/ipxe-install.rst:52
msgid ""
"Your PXE client must have a boot order where the network boot option is "
"prioritized before the disk boot option."
msgstr "在 PXE 客户端的引导顺序中,网络引导选项需要优先于磁盘引导选项。"
#: ../../guides/network/ipxe-install.rst:55
msgid "Your PXE server must have:"
msgstr "PXE 服务器必须:"
#: ../../guides/network/ipxe-install.rst:57
msgid "Ethernet/LAN boot option."
msgstr "具有以太网/局域网引导选项。"
#: ../../guides/network/ipxe-install.rst:58
msgid "At least two network adapters."
msgstr "具有至少两个网络适配器。"
#: ../../guides/network/ipxe-install.rst:59
msgid "Connection to a public network."
msgstr "连接到公共网络。"
#: ../../guides/network/ipxe-install.rst:60
msgid "Secure boot option disabled."
msgstr "禁用安全引导选项。"
#: ../../guides/network/ipxe-install.rst:64
msgid ""
"You must disable the secure boot option in the BIOS because the UEFI "
"binaries used to boot |CL| are not signed."
msgstr "您必须在 BIOS 中禁用安全引导选项,因为用于引导 |CL| 的 UEFI 二进制文件未经签名。"
#: ../../guides/network/ipxe-install.rst:69
msgid "Configuration"
msgstr "配置"
#: ../../guides/network/ipxe-install.rst:71
msgid ""
"To set up |CL| using iPXE automatically, use the :file:`configure-"
"ipxe.sh` script included with :abbr:`ICIS (Ister Cloud Init Service)`. "
"For additional instructions on the script, refer to the guide on the "
"`ister-cloud-init-svc`_ GitHub\\* repository."
msgstr "要使用 iPXE 自动设置 |CL|,请使用随 :abbr:`ICIS (Ister Cloud Init Service)` 附带的 :file:`configure-ipxe.sh` 脚本。有关该脚本的其他说明,请参阅 `ister-cloud-init-svc`_ GitHub\\* 存储库中的指南。"
#: ../../guides/network/ipxe-install.rst:76
msgid "To set up |CL| manually, perform the steps below."
msgstr "要手动设置 |CL|,请执行以下步骤。"
#: ../../guides/network/ipxe-install.rst:78
msgid "Define the variables used for iPXE boot configuration."
msgstr "定义 iPXE 引导配置使用的变量。"
#: ../../guides/network/ipxe-install.rst:94
msgid "Log in and get root privilege."
msgstr "登录并获得 root 特权。"
#: ../../guides/network/ipxe-install.rst:100
msgid ""
"Add the :command:`pxe-server` bundle to your |CL| system. The bundle "
"contains all files needed to run a PXE server."
msgstr "将 :command:`pxe-server` 捆绑包添加到 |CL| 系统。该捆绑包含有运行 PXE 服务器所需的所有文件。"
#: ../../guides/network/ipxe-install.rst:107
msgid ""
"Download the latest network-bootable release of |CL| and extract the "
"files."
msgstr "下载 |CL| 的最新网络引导版本,并提取文件。"
#: ../../guides/network/ipxe-install.rst:121
msgid ""
"Ensure that the initial ramdisk file is named :file:`initrd` and the "
"kernel file is named :file:`linux`, which is a symbolic link to the "
"actual kernel file."
msgstr "确保初始 ramdisk 文件命名为 :file:`initrd`,内核文件命名为 :file:`linux` (这是一个指向实际内核文件的符号链接)。"
#: ../../guides/network/ipxe-install.rst:125
msgid ""
"Create an iPXE boot script with the following contents. During an iPXE "
"boot, the iPXE boot script directs the PXE client to download the files "
"to boot and install |CL|. Use the names previously given to the initial "
"ramdisk and kernel files."
msgstr "创建包含以下内容的 iPXE 引导脚本。在 iPXE 引导过程中,iPXE 引导脚本会指示 PXE 客户端下载引导和安装 |CL| 所需的文件。使用先前提供给初始 ramdisk 和内核文件的名称。"
#: ../../guides/network/ipxe-install.rst:141
msgid ""
"The :command:`pxe-server` bundle contains a lightweight web-server known "
"as nginx. Create a configuration file for nginx to serve |CL| to PXE "
"clients with the following contents:"
msgstr ":command:`pxe-server` 捆绑包含一个名为 nginx 的轻量级 Web 服务器。为 nginx 创建一个配置文件,以便 |CL| 为 PXE 客户端提供以下内容:"
#: ../../guides/network/ipxe-install.rst:163
msgid ""
"Create a separate nginx configuration file to serve network-bootable "
"images on a non-standard port number. This action saves existing nginx "
"configurations."
msgstr "创建一个单独的 nginx 配置文件,以便在非标准端口号上提供网络引导映像。此操作会保存现有的 nginx 配置。"
#: ../../guides/network/ipxe-install.rst:167
msgid "Start nginx and enable the startup on boot option."
msgstr "启动 nginx 并启用引导时启动选项。"
#: ../../guides/network/ipxe-install.rst:174
msgid ""
"The :command:`pxe-server` bundle contains a lightweight DNS server which "
"conflicts with the DNS stub listener provided in `systemd-resolved`. "
"Disable the DNS stub listener and temporarily stop `systemd-resolved`."
msgstr ":command:`pxe-server` 捆绑包包含一个轻量级 DNS 服务器,该服务器与 `systemd-resolved` 中提供的 DNS 存根侦听器冲突。请禁用 DNS 存根侦听器,并暂时停止 `systemd-resolved`。"
#: ../../guides/network/ipxe-install.rst:188
msgid ""
"Assign a static IP address to the network adapter for the private network"
" and restart `systemd-networkd` with the following commands:"
msgstr "为专用网络的网络适配器分配一个静态 IP 地址,并使用以下命令重新启动 `systemd-networkd`"
#: ../../guides/network/ipxe-install.rst:204
msgid ""
"Configure :abbr:`NAT (Network Address Translation)` to route traffic from"
" the private network to the public network. This action makes the PXE "
"server act as a router. To make these changes persistent during reboots, "
"save the changes to the firewall with the following commands:"
msgstr "配置 :abbr:`NAT (Network Address Translation)`,将流量从专用网络路由到公共网络。此操作会让 PXE 服务器充当路由器。要使这些更改在重启期间保持不变,请使用以下命令将更改保存到防火墙:"
#: ../../guides/network/ipxe-install.rst:220
msgid ""
"The firewall masks packets to make them appear as coming from the PXE "
"server and hides PXE clients from the public network."
msgstr "防火墙会遮掩数据包,使其看起来像来自 PXE 服务器,并对公共网络隐藏 PXE 客户端。"
#: ../../guides/network/ipxe-install.rst:223
msgid ""
"Configure the kernel to forward network packets to different interfaces. "
"Otherwise, NAT will not work."
msgstr "配置内核,将网络数据包转发到不同的接口。否则,NAT 将不起作用。"
#: ../../guides/network/ipxe-install.rst:232
msgid ""
"The :command:`pxe-server` bundle contains iPXE firmware images that allow"
" computers without an iPXE implementation to perform an iPXE boot. Create"
" a TFTP hosting directory and populate the directory with the iPXE "
"firmware images with the following commands:"
msgstr ":command:`pxe-server` 捆绑包包含 iPXE 固件映像,这些映像允许没有 iPXE 实现的计算机执行 iPXE 引导。创建一个 TFTP 托管目录,并用以下命令用 iPXE 固件映像填充该目录:"
#: ../../guides/network/ipxe-install.rst:242
msgid ""
"The :command:`pxe-server` bundle contains a lightweight TFTP, DNS, and "
"DHCP server known as `dnsmasq`. Create a configuration file for `dnsmasq`"
" to listen on a dedicated IP address for those functions. PXE clients on "
"the private network will use this IP address."
msgstr ":command:`pxe-server` 捆绑包包含一个名为 `dnsmasq` 的轻量级 TFTP、DNS 和 DHCP 服务器。为 `dnsmasq` 创建一个配置文件,以便监听这些功能的专用 IP 地址。专用网络上的 PXE 客户端将使用此 IP 地址。"
#: ../../guides/network/ipxe-install.rst:253
msgid ""
"Add the options to serve iPXE firmware images to PXE clients over TFTP to"
" the `dnsmasq` configuration file."
msgstr "将通过 TFTP 向 PXE 客户端提供 iPXE 固件映像的选项添加到 `dnsmasq` 配置文件中。"
#: ../../guides/network/ipxe-install.rst:263
msgid ""
"Add the options to host a DHCP server for PXE clients to the "
":file:`dnsmasq` configuration file."
msgstr "将为 PXE 客户端托管 DHCP 服务器的选项添加到 `dnsmasq` 配置文件中。"
#: ../../guides/network/ipxe-install.rst:285
msgid "The configuration provides the following important functions:"
msgstr "该配置提供以下重要功能:"
#: ../../guides/network/ipxe-install.rst:287
msgid ""
"Directs PXE clients without an iPXE implementation to the TFTP server to "
"acquire architecture-specific iPXE firmware images that allow them to "
"perform an iPXE boot."
msgstr "将没有 iPXE 实现的 PXE 客户端定向到 TFTP 服务器,以获取特定于体系结构的 iPXE 固件映像,从而允许这些客户端执行 iPXE 引导。"
#: ../../guides/network/ipxe-install.rst:290
msgid ""
"Activates only on the network adapter that has an IP address on the "
"defined subnet."
msgstr "仅在具有指定子网中 IP 地址的网络适配器上激活。"
#: ../../guides/network/ipxe-install.rst:292
msgid "Directs PXE clients to the DNS server."
msgstr "将 PXE 客户端定向到 DNS 服务器。"
#: ../../guides/network/ipxe-install.rst:293
msgid "Directs PXE clients to the PXE server for routing via NAT."
msgstr "将 PXE 客户端定向到 PXE 服务器,以便通过 NAT 进行路由。"
#: ../../guides/network/ipxe-install.rst:294
msgid ""
"Divides the private network into two pools of IP addresses. One pool is "
"for network boot and one pool is used after boot. Each pool has their own"
" lease times."
msgstr "将专用网络分成两个 IP 地址池。一个地址池用于网络引导,一个地址池在引导后使用。每个地址池都有自己的租赁时间。"
#: ../../guides/network/ipxe-install.rst:298
msgid ""
"Create a file for `dnsmasq` to record the IP addresses it provides to PXE"
" clients."
msgstr "为 `dnsmasq` 创建一个文件,记录它向 PXE 客户端提供的 IP 地址。"
#: ../../guides/network/ipxe-install.rst:306
msgid "Start `dnsmasq` and enable startup on boot."
msgstr "启动 `dnsmasq` 并启用引导时启动。"
#: ../../guides/network/ipxe-install.rst:313
msgid "Start `systemd-resolved`."
msgstr "启动 `systemd-resolved`。"
#: ../../guides/network/ipxe-install.rst:321
msgid ""
"`systemd-resolved` dynamically updates the list of DNS servers for the "
"private network if you use the `dnsmasq` DNS server. The setup creates a "
"pass-through DNS server that relies on the DNS servers listed in "
":file:`/etc/resolv.conf`."
msgstr "如果使用 `dnsmasq` DNS 服务器,`systemd-resolved` 会动态更新专用网络的 DNS 服务器列表。该设置会创建一个直通 DNS 服务器,该服务器依赖于 :file:`/etc/resolv.conf` 中列出的 DNS 服务器。"
#: ../../guides/network/ipxe-install.rst:326
msgid "Power on the PXE client and watch the client boot and install |CL|."
msgstr "打开 PXE 客户端的电源,观看客户端引导并安装 |CL|。"
#: ../../guides/network/ipxe-install.rst:328
msgid ""
"After booting, |CL| automatically partitions the hard drive, installs "
"itself, updates to the latest version, and reboots."
msgstr "引导后,|CL| 会自动对硬盘分区,自行安装,更新到最新版本,然后重新引导。"
#: ../../guides/network/ipxe-install.rst:332
msgid ""
"**Congratulations!** You have successfully installed and configured a PXE"
" server that enables PXE clients to boot and install |CL| over the "
"network."
msgstr "祝贺您!您已成功安装并配置了 PXE 服务器,使 PXE 客户端能够通过网络引导并安装 |CL|。"
#~ msgid "Install |CL-ATTR| over the network with iPXE"
#~ msgstr ""
#~ msgid ""
#~ "This guide describes how to install "
#~ "|CL-ATTR| using :abbr:`PXE (Pre-boot "
#~ "Execution Environment)`."
#~ msgstr ""
#~ msgid ""
#~ "Connect the PXE server and PXE "
#~ "clients to a switch on a private"
#~ " network, as shown in Figure 2."
#~ msgstr ""
#~ msgid ""
#~ "To set up |CL| using iPXE "
#~ "automatically, use the :file:`configure-"
#~ "ipxe.sh` script included with :abbr:`ICIS "
#~ "(Ister Cloud Init Service)`. For "
#~ "additional instructions on the script, "
#~ "refer to the guide on the `ICIS"
#~ " GitHub repository`_."
#~ msgstr ""
#~ msgid ""
#~ "Add the `pxe-server` bundle to "
#~ "your |CL| system. The bundle contains"
#~ " all files needed to run a PXE"
#~ " server."
#~ msgstr ""
#~ msgid ""
#~ "The `pxe-server` bundle contains a "
#~ "lightweight web-server known as `nginx`."
#~ " Create a configuration file for "
#~ "`nginx` to serve |CL| to PXE "
#~ "clients with the following contents:"
#~ msgstr ""
#~ msgid ""
#~ "Create a separate `nginx` configuration "
#~ "file to serve network-bootable images"
#~ " on a non-standard port number. "
#~ "This action saves existing `nginx` "
#~ "configurations."
#~ msgstr ""
#~ msgid "Start `nginx` and enable the startup on boot option."
#~ msgstr ""
#~ msgid ""
#~ "The `pxe-server` bundle contains a "
#~ "lightweight DNS server which conflicts "
#~ "with the DNS stub listener provided "
#~ "in `systemd-resolved`. Disable the DNS"
#~ " stub listener and temporarily stop "
#~ "`systemd-resolved`."
#~ msgstr ""
#~ msgid ""
#~ "The `pxe-server` bundle contains iPXE"
#~ " firmware images that allow computers "
#~ "without an iPXE implementation to "
#~ "perform an iPXE boot. Create a "
#~ "TFTP hosting directory and populate the"
#~ " directory with the iPXE firmware "
#~ "images with the following commands:"
#~ msgstr ""
#~ msgid ""
#~ "The `pxe-server` bundle contains a "
#~ "lightweight TFTP, DNS, and DHCP server"
#~ " known as `dnsmasq`. Create a "
#~ "configuration file for `dnsmasq` to "
#~ "listen on a dedicated IP address "
#~ "for those functions. PXE clients on "
#~ "the private network will use this "
#~ "IP address."
#~ msgstr ""
#~ msgid ""
#~ "Add the options to host a DHCP "
#~ "server for PXE clients to the "
#~ "`dnsmasq` configuration file."
#~ msgstr ""
@@ -0,0 +1,201 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-22 12:54-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/network/network-bonding.rst:4
msgid "Combine multiple interfaces with network bonding"
msgstr "使用网络捆绑聚合多个接口"
#: ../../guides/network/network-bonding.rst:6
msgid ""
"This guide describes how to configure systemd to use the "
":command:`bonding` driver."
msgstr "本指南介绍如何配置 systemd 以使用 :command:`bonding` 驱动程序。"
#: ../../guides/network/network-bonding.rst:9
msgid ""
"Network bonding combines multiple network interfaces into a single "
"logical interface to provide redundancy and bandwidth aggregation."
msgstr "网络捆绑是指将多个网络接口组合成一个逻辑接口,从而提供冗余和带宽聚合。"
#: ../../guides/network/network-bonding.rst:12
msgid "|CL-ATTR| includes the Linux `Bonding driver`_ and `Team driver`_ ."
msgstr "|CL-ATTR| 包含 Linux `Bonding driver`_ 和 `Team driver`_。"
#: ../../guides/network/network-bonding.rst:14
msgid "The example demonstrates how to:"
msgstr "该示例演示了如何:"
#: ../../guides/network/network-bonding.rst:16
msgid "Bond all four ports of a quad-port NIC in 802.3ad mode."
msgstr "在 802.3ad 模式下,捆绑四端口网卡的所有四个端口。"
#: ../../guides/network/network-bonding.rst:18
msgid "Enable jumbo frames to optimize large data transfers on the local network."
msgstr "启用巨型帧来优化本地网络上的大量数据传输。"
#: ../../guides/network/network-bonding.rst:20
msgid ""
"Your NICs and network switch must support 802.3ad mode and jumbo frames. "
"The example explains how to configure your NICs for both features. Your "
"switch may require additional configuration. See your switch "
"documentation for details."
msgstr "您的网卡和网络交换机必须支持 802.3ad 模式和巨型帧。该示例解释了如何为这两种功能配置网卡。您的交换机可能需要额外的配置。查阅交换器文档以了解详细信息。"
#: ../../guides/network/network-bonding.rst:26
msgid "You must run all commands in this guide as root."
msgstr "您必须以 root 用户身份运行本指南中的所有命令。"
#: ../../guides/network/network-bonding.rst:28
msgid "Log in and get root privileges."
msgstr "登录并获得 root 特权。"
#: ../../guides/network/network-bonding.rst:34
msgid "Create the :file:`/etc/systemd/network` directory."
msgstr "创建 :file:`/etc/systemd/network` 目录。"
#: ../../guides/network/network-bonding.rst:40
msgid ""
"The :file:`/etc/systemd/network` directory contains configuration files "
"and network settings for the virtual device and its underlying physical "
"interfaces."
msgstr ":file:`/etc/systemd/network` 目录包含虚拟设备及其底层物理接口的配置文件和网络设置。"
#: ../../guides/network/network-bonding.rst:44
msgid ""
"Configure systemd to create a virtual network device called `bond1`. Use "
"a text editor to create a file named :file:`30-bond1.netdev`."
msgstr "将 systemd 配置为创建一个名为 `bond1` 的虚拟网络设备。使用文本编辑器创建一个名为 :file:`30-bond1.netdev` 的文件。"
#: ../../guides/network/network-bonding.rst:59
msgid ""
"Refer to the `systemd.netdev`_ manpage for :file:`30-bond1.netdev` file "
"syntax. This example is based on Example 9 on the manpage. Modify the "
"example for your configuration."
msgstr "有关 :file:`30-bond1.netdev` 文件语法,请参阅 `systemd.netdev`_ 手册页。本示例基于手册页上的示例 9。根据您的配置修改示例。"
#: ../../guides/network/network-bonding.rst:63
msgid ""
"Configure the slave interfaces. Create a text file named "
":file:`30-bond1-enp1s0.network`. Assign the slave interfaces to the "
"virtual `bond1` device and use the syntax shown in `systemd.network`_."
msgstr "配置从属接口。创建一个名为 :file:`30-bond1-enp1s0.network` 的文本文件。将从属接口分配给虚拟 `bond1` 设备,并使用 `systemd.network`_ 中所示的语法。"
#: ../../guides/network/network-bonding.rst:78
msgid ""
"The example bonds all four ports of a quad-port NIC as a slave of "
"`bond1`. The example uses a wildcard match because the NIC names are in "
"the range `enp1s0f0-enp1s0f3`. If your NIC names are not wildcard-"
"compatible, create a separate :file:`.network` file for each NIC."
msgstr "本示例将四端口网卡的所有四个端口捆绑为 `bond1` 从属接口。本示例使用通配符匹配,因为网卡名称在 `enp1s0f0-enp1s0f3` 范围内。如果网卡名称不兼容通配符,请为每个网卡创建一个单独的 :file:`.network` 文件。"
#: ../../guides/network/network-bonding.rst:83
msgid ""
"For best results, do not assign addresses or DHCP support to the "
"individual NICs."
msgstr "为了获得最佳效果,请勿为单个网卡分配地址或 DHCP 支持。"
#: ../../guides/network/network-bonding.rst:86
msgid ""
"The `MTUBytes` setting enables jumbo frames of up to 9000 bytes. Your "
"switch may require additional configuration to support this setting."
msgstr "`MTUBytes` 设置支持高达 9000 字节的巨型帧。您的交换机可能需要额外的配置来支持此设置。"
#: ../../guides/network/network-bonding.rst:89
msgid "Configure the bonded interface in a file named :file:`30-bond1.network`."
msgstr "在名为 :file:`30-bond1.network` 的文件中配置捆绑接口。"
#: ../../guides/network/network-bonding.rst:103
msgid "`bond1` is a virtual interface with no physical link status."
msgstr "`bond1` 是一个没有物理链路状态的虚拟接口。"
#: ../../guides/network/network-bonding.rst:105
msgid ""
"`BindCarrier` indicates that the `bond1` link status is determined by the"
" status of the listed slave devices."
msgstr "`BindCarrier` 表示 `bond1` 链路状态由所列从属设备的状态决定。"
#: ../../guides/network/network-bonding.rst:108
msgid ""
"`Address` contains an IP address that you assign to the logical "
"interface. DHCP bonded interfaces are complex and outside the scope of "
"this example."
msgstr "`Address` 包含分配给逻辑接口的一个 IP 地址。DHCP 捆绑接口十分复杂,不在本示例的讨论范围内。"
#: ../../guides/network/network-bonding.rst:111
msgid ""
"`MTUBytes` must be set to 9000 on all slave interfaces and on the bonded "
"interface for successful jumbo frames operation. If `MTUBytes` is not the"
" same on all interfaces, then the lowest value is used."
msgstr "要成功处理巨型帧,所有从属接口和捆绑接口上的 `MTUBytes` 必须设置为 9000。如果所有接口上的 `MTUBytes` 设置并不相同,将使用这些设置中的最小值。"
#: ../../guides/network/network-bonding.rst:115
msgid "Apply the new network configuration with the command:"
msgstr "使用以下命令应用新的网络配置:"
#: ../../guides/network/network-bonding.rst:121
msgid ""
"The `MTUBytes` settings do not take effect until you reboot or manually "
"apply the settings with a utility such as ifconfig."
msgstr "除非重启或使用 ifconfig 等实用程序手动应用设置,否则 `MTUBytes` 设置不会生效。"
#~ msgid ""
#~ "|CL-ATTR| includes Linux bonding_ and"
#~ " team_ drivers. This guide describes "
#~ "how to configure systemd to use "
#~ "the `bonding` driver."
#~ msgstr ""
#~ msgid "Bond all four ports of a quad-port NIC in `802.3ad` mode."
#~ msgstr ""
#~ msgid ""
#~ "Your NICs and network switch must "
#~ "support `802.3ad` mode and jumbo frames."
#~ " The example explains how to "
#~ "configure your NICs for both features."
#~ " Your switch may require additional "
#~ "configuration. See your switch documentation"
#~ " for details."
#~ msgstr ""
#~ msgid ""
#~ "Refer to the systemd.netdev_ manpage for"
#~ " :file:`30-bond1.netdev` file syntax. This "
#~ "example is based on Example 9 on"
#~ " the manpage. Modify the example for"
#~ " your configuration."
#~ msgstr ""
#~ msgid ""
#~ "Configure the slave interfaces. Create a"
#~ " text file named :file:`30-bond1-enp1s0.network`."
#~ " Assign the slave interfaces to the"
#~ " virtual `bond1` device and use the"
#~ " syntax shown in systemd.network_."
#~ msgstr ""
#~ msgid ""
#~ "The `MTUBytes` settings do not take "
#~ "effect until you reboot or manually "
#~ "apply the settings with a utility "
#~ "such as `ifconfig`."
#~ msgstr ""
@@ -0,0 +1,270 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../guides/network/openssh-server.rst:4
msgid "Enable and configure SSH service"
msgstr "启用并配置 SSH 服务"
#: ../../guides/network/openssh-server.rst:6
msgid "This guide describes how to set up SSH service."
msgstr "本指南介绍如何设置 SSH 服务。"
#: ../../guides/network/openssh-server.rst:13
msgid "Overview"
msgstr "概述"
#: ../../guides/network/openssh-server.rst:15
msgid ""
"The :command:`openssh-server` bundle provides the OpenSSH package that "
"enables an SSH service in |CL-ATTR|. Remote users require an SSH service "
"to be able to use an encrypted login shell."
msgstr ":command:`openssh-server` 捆绑包提供了用于在 |CL-ATTR| 中启用 SSH 服务的 OpenSSH 软件包。远程用户需要 SSH 服务才能使用加密登录 shell。"
#: ../../guides/network/openssh-server.rst:19
msgid ""
"|CL| enables the `sshd.socket` unit, which listens on port 22 by default "
"and starts the OpenSSH service as required. The first time OpenSSH "
"starts, it generates the server SSH keys needed for the service."
msgstr "|CL| 将启用 `sshd.socket` 单元,该单元默认侦听端口 22 并根据需要启动 OpenSSH 服务。OpenSSH 首次启动时,它会生成服务所需的服务器 SSH 密钥。"
#: ../../guides/network/openssh-server.rst:24
msgid "Prerequisites"
msgstr "必备条件"
#: ../../guides/network/openssh-server.rst:26
msgid "Ensure the :command:`openssh-server` bundle is installed."
msgstr "确保已安装 :command:`openssh-server` 捆绑包。"
#: ../../guides/network/openssh-server.rst:28
msgid "To list all bundles on your host, enter:"
msgstr "要列出主机上的所有捆绑包,请输入:"
#: ../../guides/network/openssh-server.rst:34
msgid "To add the :command:`openssh-server` bundle, enter:"
msgstr "要添加 :command:`openssh-server` 捆绑包,请输入:"
#: ../../guides/network/openssh-server.rst:41
msgid "Change default port"
msgstr "更改默认端口"
#: ../../guides/network/openssh-server.rst:43
msgid ""
"Perform the following steps to change the default listening port for the "
"OpenSSH service."
msgstr "执行以下步骤以更改 OpenSSH 服务的默认侦听端口。"
#: ../../guides/network/openssh-server.rst:46
msgid "Open the :file:`sshd.socket` file:"
msgstr "打开 :file:`sshd.socket` 文件:"
#: ../../guides/network/openssh-server.rst:52
msgid ""
"Add the `[Socket]` section and `ListenStream` option to the sshd.socket "
"file as shown below. The first `ListenStream` entry removes the |CL| "
"default listen port value. The second `ListenStream` entry sets the new "
"default listen port value. In this example, we set the new default port "
"to 4200:"
msgstr "将 `[Socket]` 部分和 `ListenStream` 选项添加到 sshd.socket 文件中,如下所示。第一个 `ListenStream` 条目用于删除 |CL| 默认侦听端口值。第二个 `ListenStream` 条目用于设置新的默认侦听端口值。在此示例中,我们将新的默认端口设置为 4200:"
#: ../../guides/network/openssh-server.rst:65
msgid ""
"Make sure to include a new line after the last line of text in the "
":file:`sshd.socket` file."
msgstr "务必在 :file:`sshd.socket` 文件中的最后一行文本之后包含一个新行。"
#: ../../guides/network/openssh-server.rst:67
msgid "Verify your changes:"
msgstr "验证所做更改:"
#: ../../guides/network/openssh-server.rst:73
msgid "The following output is displayed:"
msgstr "将显示以下输出:"
#: ../../guides/network/openssh-server.rst:81
msgid "Reload the systemd daemon configurations:"
msgstr "重新加载 systemd 守护程序配置:"
#: ../../guides/network/openssh-server.rst:87
msgid "Restart the sshd.socket unit:"
msgstr "重新启动 sshd.socket 单元:"
#: ../../guides/network/openssh-server.rst:93
msgid "Confirm the sshd.socket unit is listening on your new port:"
msgstr "确认 sshd.socket 单元正在侦听新端口:"
#: ../../guides/network/openssh-server.rst:101
msgid "Output should show :guilabel:`Active:` as `active(listening)`."
msgstr "输出应该将 :guilabel:`Active:` 显示为 `active(listening)`。"
#: ../../guides/network/openssh-server.rst:104
msgid "Enable SFTP"
msgstr "启用 SFTP"
#: ../../guides/network/openssh-server.rst:106
msgid ""
"|CL| *disables* the :abbr:`SFTP (SSH File Transfer Protocol)` subsystem "
"by default due to security considerations. To enable the SFTP subsystem, "
"you must configure the :abbr:`SSHD (SSH Daemon)` service file."
msgstr "出于安全考虑,|CL| 默认禁用 :abbr:`SFTP(SSH 文件传输协议)` 子系统。要启用 SFTP 子系统,您必须配置 :abbr:`SSHD(SSH 守护程序)` 服务文件。"
#: ../../guides/network/openssh-server.rst:110
msgid "Create a systemd drop-in directory for the SSHD service:"
msgstr "为 SSHD 服务创建 systemd 放置目录:"
#: ../../guides/network/openssh-server.rst:116
msgid ""
"Create the following file: "
":file:`/etc/systemd/system/sshd@.service.d/sftp.conf`"
msgstr "创建以下文件::file:`/etc/systemd/system/sshd@.service.d/sftp.conf`"
#: ../../guides/network/openssh-server.rst:119
msgid "Add the OPTIONS environment variable to the :file:`sftp.conf` file."
msgstr "将 OPTIONS 环境变量添加到 :file:`sftp.conf` 文件中。"
#: ../../guides/network/openssh-server.rst:126
msgid "Reload systemd configuration:"
msgstr "重新加载 systemd 配置:"
#: ../../guides/network/openssh-server.rst:132
msgid "Congratulations! The SFTP subsystem is enabled."
msgstr "恭喜!SFTP 子系统已启用。"
#: ../../guides/network/openssh-server.rst:135
msgid "Enable root login"
msgstr "启用 root 登录"
#: ../../guides/network/openssh-server.rst:137
msgid "To enable root login via SSH, perform the following steps:"
msgstr "要通过 SSH 启用 root 登录,请执行以下步骤:"
#: ../../guides/network/openssh-server.rst:139
#: ../../guides/network/openssh-server.rst:162
msgid "Create an *ssh* directory in :file:`/etc`, if it does not already exist."
msgstr "在 :file:`/etc` 中创建 *ssh* 目录(如果尚未存在)。"
#: ../../guides/network/openssh-server.rst:145
#: ../../guides/network/openssh-server.rst:168
msgid ""
"Create the following file, if it does not already exist: "
":file:`/etc/ssh/sshd_config`"
msgstr "创建以下文件(如果尚未存在)::file:`/etc/ssh/sshd_config`"
#: ../../guides/network/openssh-server.rst:148
msgid "Set the configuration variable in :file:`/etc/ssh/sshd_config`:"
msgstr "在 :file:`/etc/ssh/sshd_config` 中设置配置变量:"
#: ../../guides/network/openssh-server.rst:155
msgid "Enable X11-forwarding"
msgstr "启用 X11 转发"
#: ../../guides/network/openssh-server.rst:157
msgid ""
"X11 forwarding allows you to securely run graphical applications (that "
"is, X clients) over the SSH conection. This enables remote GUI apps "
"without the need for full VNC or remote desktop setup. To enable "
"X11-forwarding via SSH, perform the following steps:"
msgstr "使用 X11 转发可以通过 SSH 连接安全地运行图形应用程序(即 X 客户端)。这使得无需完整 VNC 或远程桌面设置便可启用远程 GUI 应用程序。要通过 SSH 启用 X11 转发,请执行以下步骤:"
#: ../../guides/network/openssh-server.rst:171
msgid "Set the following configuration variables."
msgstr "设置以下配置变量。"
#~ msgid "openssh-server"
#~ msgstr ""
#~ msgid ""
#~ "The **openssh-server** bundle provides "
#~ "the OpenSSH\\* package needed to enable"
#~ " an SSH service in |CL-ATTR|. "
#~ "Remote users require an SSH service "
#~ "to be able to use an encrypted "
#~ "login shell."
#~ msgstr ""
#~ msgid ""
#~ "|CL| enables the `sshd.socket` unit, "
#~ "which will listen on port 22 by"
#~ " default and start the OpenSSH "
#~ "service as required. The first time "
#~ "OpenSSH starts, it generates the server"
#~ " SSH keys needed for the service."
#~ msgstr ""
#~ msgid "Assure the bundle :file:`openssh-server` is installed."
#~ msgstr ""
#~ msgid "To check it it's on your host, enter:"
#~ msgstr ""
#~ msgid "To add it, enter:"
#~ msgstr ""
#~ msgid ""
#~ "Perform the following steps to change"
#~ " the default listening port for the"
#~ " OpenSSH service:"
#~ msgstr ""
#~ msgid "Open the sshd.socket file:"
#~ msgstr ""
#~ msgid ""
#~ "Make sure to include a new line"
#~ " after the last line of text in"
#~ " the sshd.socket file."
#~ msgstr ""
#~ msgid "You should see the following output:"
#~ msgstr ""
#~ msgid "Confirm the the sshd.socket unit is listening on your new port:"
#~ msgstr ""
#~ msgid ""
#~ "|CL| *disables* the :abbr:`SFTP (SSH "
#~ "File Transfer Protocol)` subsystem by "
#~ "default due to security considerations. "
#~ "To enable the SFTP subsystem, perform"
#~ " the following configuration of the "
#~ ":abbr:`SSHD (SSH Daemon)` service file:"
#~ msgstr ""
#~ msgid "Add the OPTIONS environment variable to the sftp.conf file."
#~ msgstr ""
#~ msgid "Create a *ssh* directory in :file:`/etc`, if it does not already exist."
#~ msgstr ""
#~ msgid "Set the configuration variable in /etc/ssh/sshd_config"
#~ msgstr ""
#~ msgid ""
#~ "X11 forwarding allows you to securely"
#~ " run graphical applications (i.e., X "
#~ "clients) over the ssh conection. This"
#~ " will alow for remote gui apps "
#~ "without the need for full "
#~ "VNC/remotedesktop. To enable X11-forwarding "
#~ "via SSH, perform the following steps:"
#~ msgstr ""
#~ msgid "Set the configuration variables."
#~ msgstr ""
File diff suppressed because it is too large Load Diff
@@ -0,0 +1,192 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../guides/stacks/dars.rst:4
msgid "Data Analytics Reference Stack"
msgstr "数据分析参考堆栈"
#: ../../guides/stacks/dars.rst:6
msgid ""
"This guide explains how to use the :abbr:`DARS (Data Analytics Reference "
"Stack)`, and to optionally build your own DARS container image."
msgstr "本指南说明了如何使用 :abbr:`DARS (Data Analytics Reference Stack)`,以及如何选择性地构建您自己的 DARS 容器映像。"
#: ../../guides/stacks/dars.rst:9
msgid ""
"Any system that supports Docker\\* containers can be used with DARS. This"
" steps in this guide use |CL-ATTR| as the host system."
msgstr "任何支持 Docker\\* 容器的系统都可与 DARS 一起使用。本指南中的这些步骤使用 |CL-ATTR| 作为主机系统。"
#: ../../guides/stacks/dars.rst:17
msgid "The Data Analytics Reference Stack release"
msgstr "数据分析参考堆栈版本"
#: ../../guides/stacks/dars.rst:19
msgid ""
"The Data Analytics Reference Stack (DARS) provides developers and "
"enterprises a straightforward, highly optimized software stack for "
"storing and processing large amounts of data. More detail is available "
"on the `DARS architecture and performance benchmarks`_."
msgstr "数据分析参考堆栈 (DARS) 为开发人员和企业提供了一个简单、高度优化的软件堆栈来存储和处理大量数据。更多详细信息请参阅 `DARS architecture and performance benchmarks`_。"
#: ../../guides/stacks/dars.rst:23
msgid ""
"The Data Analytics Reference Stack provides two pre-built Docker images, "
"available on `Docker Hub`_:"
msgstr "数据分析参考堆栈提供了两个预构建的 Docker 映像,可在 `Docker Hub`_ 获得:"
#: ../../guides/stacks/dars.rst:26
msgid "A |CL|-derived `DARS with OpenBlas`_ stack optimized for `OpenBLAS`_"
msgstr "一个从 |CL| 派生且针对 `OpenBLAS`_ 优化的 `DARS with OpenBlas`_ 堆栈"
#: ../../guides/stacks/dars.rst:27
msgid "A |CL|-derived `DARS with Intel® MKL`_ stack optimized for `MKL`_"
msgstr "一个从 |CL| 派生且针对 `MKL`_ 优化的 `DARS with MKL`_ 堆栈"
#: ../../guides/stacks/dars.rst:29
msgid ""
"We recommend you view the latest component versions for each image in the"
" :file:`README` found in the `Data Analytics Reference Stack`_ GitHub\\* "
"repository. Because |CL| is a rolling distribution, the package version "
"numbers in the |CL|-based containers may not be the latest released by "
"|CL|."
msgstr "我们建议您在 `DARS repository`_ 中找到 :file:`README`,查看每个映像的最新组件版本。由于 |CL| 是滚动发行的,基于 |CL| 的容器中的软件包版本号可能不是 |CL| 最新发布的版本号。"
#: ../../guides/stacks/dars.rst:36
msgid ""
"The Data Analytics Reference Stack is a collective work, and each piece "
"of software within the work has its own license. Please see the `DARS "
"Terms of Use`_ for more details about licensing and usage of the Data "
"Analytics Reference Stack."
msgstr "数据分析参考堆栈是一项集体成果,成果中的每一个软件都有自己的许可证。有关数据分析参考堆栈的许可和使用的更多详细信息,请参阅 `DARS Terms of Use`_。"
#: ../../guides/stacks/dars.rst:42
msgid "Using the Docker images"
msgstr "使用 Docker 映像"
#: ../../guides/stacks/dars.rst:44
msgid ""
"To immediately start using the latest stable DARS images, pull an image "
"directly from `Docker Hub`_. This example uses the `DARS with Intel® "
"MKL`_ Docker image."
msgstr "要立即开始使用最新的稳定版 DARS 映像,请直接从 `Docker Hub`_ 提取。在本教程中,我们将使用 `Dars with MKL`_ 版本堆栈。"
#: ../../guides/stacks/dars.rst:48
msgid "Once you have downloaded the image, you can run it with"
msgstr "下载完映像后,您可以使用以下命令运行它:"
#: ../../guides/stacks/dars.rst:54
msgid ""
"This will launch the image and drop you into a bash shell inside the "
"container. You will see output similar to the following:"
msgstr "此命令将启动映像,并进入容器内的 bash shell 中。您将看到类似以下内容的输出:"
#: ../../guides/stacks/dars.rst:75
msgid ""
"The :command:`--ulimit nofile` parameter is currently required in order "
"to increase the number of open files opened at certain point by the spark"
" engine."
msgstr ":command:`--ulimit nofile` 参数是当前必需的参数,以便增加 spark 引擎在某一时点打开的打开文件的数量。"
#: ../../guides/stacks/dars.rst:80
msgid "Building DARS images"
msgstr "构建 DARS 映像"
#: ../../guides/stacks/dars.rst:82
msgid ""
"If you choose to build your own DARS container images, you can customize "
"them as needed. Use the provided Dockerfile as a baseline."
msgstr "如果选择构建您自己的 DARS 容器映像,您可以根据需要对它们进行自定义。将提供的 Dockerfile 用作基准。"
#: ../../guides/stacks/dars.rst:85
msgid ""
"To construct images with |CL|, start with a |CL| development platform "
"that has the :command:`containers-basic-dev` bundle installed. Learn more"
" about bundles and installing them by using :ref:`swupd-guide`."
msgstr "要使用 |CL| 构建映像,请从安装了 :command:`containers-basic-dev` 捆绑包的 |CL| 开发平台开始。使用 :ref:`swupd-guide` 了解有关捆绑包和安装捆绑包的更多信息。"
#: ../../guides/stacks/dars.rst:89
msgid "Clone the `Data Analytics Reference Stack`_ GitHub\\* repository."
msgstr "克隆 `Data Analytics Reference Stack`_ GitHub\\* 存储库。"
#: ../../guides/stacks/dars.rst:95
msgid ""
"Inside the DARS directory, run :command:`make` to build OpenBLAS and MKL "
"images."
msgstr "在 DARS 目录中,运行 :command:`make` 来构建 OpenBLAS 和 MKL 映像。"
#: ../../guides/stacks/dars.rst:101
msgid ""
"Run :command:`make baseline` to build the baseline CentOS image. "
"Depending on the system, it may take a while to finish building."
msgstr "然后运行 :command:`make baseline` 构建基准 CentOS 映像。根据系统的不同,可能需要一段时间才能完成构建。完成后,使用 :command:`Docker` 检查生成的映像。"
#: ../../guides/stacks/dars.rst:108
msgid "Once completed, check the resulting images with :command:`Docker`"
msgstr "完成后,使用 :command:`Docker` 检查生成的映像"
#: ../../guides/stacks/dars.rst:114
msgid ""
"You can use any of the resulting images to launch fully functional "
"containers. If you need to customize the containers, you can edit the "
"provided :file:`Dockerfile`."
msgstr "您可以使用任何一个生成的映像来启动功能齐全的容器。如果需要自定义容器,您可以编辑所提供的 :file:`Dockerfile`。"
#~ msgid ""
#~ "This tutorial shows you how to use"
#~ " the Data Analytics Reference Stack "
#~ "(DARS), and to optionally build your "
#~ "own images with the baseline Dockerfiles"
#~ " provided in the `DARS repository`_. "
#~ "Our assumption is that |CL-ATTR| "
#~ "is the host. However, any system "
#~ "that supports Docker\\* containers can "
#~ "be used to follow these steps."
#~ msgstr ""
#~ "本教程介绍如何使用数据分析参考堆栈 (DARS),以及如何使用 `DARS repository`_"
#~ " 中提供的基准 Dockerfiles 来选择构建您自己的映像。我们假设 |CL-"
#~ "ATTR| 是主机。但是,任何支持 Docker\\* 容器的系统都可以用来执行这些步骤。"
#~ msgid ""
#~ "If you choose to build your own"
#~ " DARS container images, you can "
#~ "customize them as needed. Use the "
#~ "provided Dockerfile as a baseline. To"
#~ " construct images with |CL|, start "
#~ "with a |CL| development platform that"
#~ " has the :command:`containers-basic-dev`"
#~ " bundle installed. Learn more about "
#~ "bundles and installing them by using "
#~ ":ref:`swupd-guide`."
#~ msgstr ""
#~ "如果选择构建您自己的 DARS 容器映像,您可以根据需要对它们进行自定义。将提供的 Dockerfile"
#~ " 用作基准。要使用 |CL| 构建映像,请从安装了 :command"
#~ ":`containers-basic-dev` 捆绑包的 |CL| 开发平台开始。使用"
#~ " :ref:`swupd-guide` 了解有关捆绑包和安装捆绑包的更多信息。"
#~ msgid "First, clone the `DARS repository`_ from GitHub."
#~ msgstr "首先,从 GitHub 中克隆 `DARS repository`_。"
@@ -0,0 +1,656 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../guides/stacks/dlrs/dlrs.rst:4
msgid "Deep Learning Reference Stack"
msgstr "深度学习参考堆栈"
#: ../../guides/stacks/dlrs/dlrs.rst:6
msgid ""
"This guide describes how to run benchmarking workloads for TensorFlow\\*,"
" PyTorch\\*, and Kubeflow in |CL-ATTR| using the Deep Learning Reference "
"Stack."
msgstr "本教程介绍如何在 |CL-ATTR| 中使用深度学习参考堆栈运行 TensorFlow\\*、PyTorch\\* 和 Kubeflow 基准工作负载。"
#: ../../guides/stacks/dlrs/dlrs.rst:14
msgid "Overview"
msgstr "概述"
#: ../../guides/stacks/dlrs/dlrs.rst:16
msgid ""
"We created the Deep Learning Reference Stack to help AI developers "
"deliver the best experience on Intel® Architecture. This stack reduces "
"complexity common with deep learning software components, provides "
"flexibility for customized solutions, and enables you to quickly "
"prototype and deploy Deep Learning workloads. Use this guide to run "
"benchmarking workloads on your solution."
msgstr "我们打造了深度学习参考堆栈来帮助 AI 开发人员在英特尔架构上获得最佳开发体验。此堆栈降低了深度学习软件组件常见的复杂性,为自定义解决方案提供了灵活性,并使您能够快速构建原型并部署深度学习工作负载。使用本教程可在您的解决方案上运行基准工作负载。"
#: ../../guides/stacks/dlrs/dlrs.rst:23
msgid "The Deep Learning Reference Stack is available in the following versions:"
msgstr "深度学习参考堆栈有以下版本:"
#: ../../guides/stacks/dlrs/dlrs.rst:25
msgid ""
"`Intel MKL-DNN-VNNI`_, which is optimized using Intel® Math Kernel "
"Library for Deep Neural Networks (Intel® MKL-DNN) primitives and "
"introduces support for Intel® AVX-512 Vector Neural Network Instructions "
"(VNNI)."
msgstr "`Intel MKL-DNN-VNNI`_,它使用面向深度神经网络(英特尔® MKL-DNN)原语的英特尔®数学内核库进行优化,并支持英特尔® AVX-512 矢量神经网络指令 (VNI)。"
#: ../../guides/stacks/dlrs/dlrs.rst:28
msgid ""
"`Intel MKL-DNN`_, which includes the TensorFlow framework optimized using"
" Intel® Math Kernel Library for Deep Neural Networks (Intel® MKL-DNN) "
"primitives."
msgstr "`Intel MKL-DNN`_,它包括使用面向深度神经网络(英特尔® MKL-DNN)原语的英特尔®数学内核库进行优化的 TensorFlow 框架。"
#: ../../guides/stacks/dlrs/dlrs.rst:31
msgid "`Eigen`_, which includes `TensorFlow`_ optimized for Intel® architecture."
msgstr "`Eigen`_,它包括针对英特尔®架构优化的 `TensorFlow`_。"
#: ../../guides/stacks/dlrs/dlrs.rst:32
msgid "`PyTorch with OpenBLAS`_, which includes PyTorch with OpenBlas."
msgstr "`PyTorch with OpenBLAS`_,它包括 PyTorch with OpenBlas。"
#: ../../guides/stacks/dlrs/dlrs.rst:33
msgid ""
"`PyTorch with Intel MKL-DNN`_, which includes PyTorch optimized using "
"Intel® Math Kernel Library (Intel® MKL) and Intel MKL-DNN."
msgstr "`PyTorch with Intel MKL-DNN`_,它包括使用英特尔®数学内核库(英特尔® MKL)和英特尔 MKL-DNN 进行优化的 PyTorch。"
#: ../../guides/stacks/dlrs/dlrs.rst:38
msgid ""
"To take advantage of the Intel® AVX-512 and VNNI functionality with the "
"Deep Learning Reference Stack, you must use the following hardware:"
msgstr "要利用英特尔® AVX-512 和 VNI 功能以及深度学习参考堆栈,您必须使用以下硬件:"
#: ../../guides/stacks/dlrs/dlrs.rst:41
msgid "Intel® AVX-512 images require an Intel® Xeon® Scalable Platform"
msgstr "英特尔® AVX-512 映像需要使用英特尔®至强®可扩展平台"
#: ../../guides/stacks/dlrs/dlrs.rst:42
msgid "VNNI requires a 2nd generation Intel® Xeon® Scalable Platform"
msgstr "VNNI 需要使用第二代英特尔®至强®可扩展平台"
#: ../../guides/stacks/dlrs/dlrs.rst:45
msgid "Stack features"
msgstr "堆栈功能和特性"
#: ../../guides/stacks/dlrs/dlrs.rst:47
msgid "`DLRS V3.0`_ release announcement."
msgstr "`DLRS V3.0`_ 发布公告。"
#: ../../guides/stacks/dlrs/dlrs.rst:48
msgid "Deep Learning Reference Stack v2.0 including current `PyTorch benchmark`_."
msgstr "深度学习参考堆栈 v2.0,包括最新的 `PyTorch benchmark results`_。"
#: ../../guides/stacks/dlrs/dlrs.rst:50
msgid ""
"Deep Learning Reference Stack v1.0 including current `TensorFlow "
"benchmark`_ results."
msgstr "深度学习参考堆栈 v1.0,包括最新的 `TensorFlow benchmark results`_。"
#: ../../guides/stacks/dlrs/dlrs.rst:52
msgid ""
"`DLRS Release notes`_ on Github\\* for the latest release of Deep "
"Learning Reference Stack."
msgstr "`DLRS Release notes`_ on Github\\*,了解深度学习参考堆栈的最新版本。"
#: ../../guides/stacks/dlrs/dlrs.rst:57
msgid ""
"The Deep Learning Reference Stack is a collective work, and each piece of"
" software within the work has its own license. Please see the `DLRS "
"Terms of Use`_ for more details about licensing and usage of the Deep "
"Learning Reference Stack."
msgstr "深度学习参考堆栈是一项集体成果,成果中的每一个软件都有自己的许可证。有关深度学习参考堆栈的许可和使用的更多详细信息,请参阅 `DLRS Terms of Use`_。"
#: ../../guides/stacks/dlrs/dlrs.rst:62
msgid "Prerequisites"
msgstr "必备条件"
#: ../../guides/stacks/dlrs/dlrs.rst:64
msgid ":ref:`Install <bare-metal-install-desktop>` |CL| on your host system"
msgstr "在主机系统上 :ref:`Install <bare-metal-install-desktop>` |CL|"
#: ../../guides/stacks/dlrs/dlrs.rst:65
msgid ":command:`containers-basic` bundle"
msgstr ":command:`containers-basic` 捆绑包"
#: ../../guides/stacks/dlrs/dlrs.rst:66
msgid ":command:`cloud-native-basic` bundle"
msgstr ":command:`cloud-native-basic` 捆绑包"
#: ../../guides/stacks/dlrs/dlrs.rst:68
msgid ""
"In |CL|, :command:`containers-basic` includes Docker\\*, which is "
"required for TensorFlow and PyTorch benchmarking. Use the "
":command:`swupd` utility to check if :command:`containers-basic` and "
":command:`cloud-native-basic` are present:"
msgstr "在 |CL| 中,:command:`containers-basic` 包括 TensorFlow 和 PyTorch 基准测试所必需的 Docker\\*。使用 :command:`swupd` 实用程序检查 :command:`containers-basic` 和 :command:`cloud-native-basic` 是否存在:"
#: ../../guides/stacks/dlrs/dlrs.rst:77
msgid ""
"To install the :command:`containers-basic` or :command:`cloud-native-"
"basic` bundles, enter:"
msgstr "要安装 :command:`containers-basic` 或 :command:`cloud-native-basic` 捆绑包,请输入:"
#: ../../guides/stacks/dlrs/dlrs.rst:84
msgid ""
"Docker is not started upon installation of the :command:`containers-"
"basic` bundle. To start Docker, enter:"
msgstr "安装 :command:`containers-basic` 捆绑包后 Docker 不会启动。要启动 Docker,请输入:"
#: ../../guides/stacks/dlrs/dlrs.rst:91
msgid ""
"To ensure that Kubernetes is correctly installed and configured, follow "
"the instructions in :ref:`kubernetes`."
msgstr "要确保正确安装和配置 Kubernetes,请遵循 :ref:`kubernetes` 中的说明。"
#: ../../guides/stacks/dlrs/dlrs.rst:95
msgid "Version compatibility"
msgstr "版本兼容性"
#: ../../guides/stacks/dlrs/dlrs.rst:97
msgid "We validated these steps against the following software package versions:"
msgstr "我们根据以下软件包版本验证了这些步骤:"
#: ../../guides/stacks/dlrs/dlrs.rst:99
msgid "|CL| 26240 (Minimum supported version)"
msgstr "|CL| 26240(支持的最低版本)"
#: ../../guides/stacks/dlrs/dlrs.rst:100
msgid "Docker 18.06.1"
msgstr "Docker 18.06.1"
#: ../../guides/stacks/dlrs/dlrs.rst:101
msgid "Kubernetes 1.11.3"
msgstr "Kubernetes 1.11.3"
#: ../../guides/stacks/dlrs/dlrs.rst:102
msgid "Go 1.11.12"
msgstr "Go 1.11.12"
#: ../../guides/stacks/dlrs/dlrs.rst:107
msgid ""
"The Deep Learning Reference Stack was developed to provide the best user "
"experience when executed on a |CL| host. However, as the stack runs in a"
" container environment, you should be able to complete the following "
"sections of this guide on other Linux* distributions, provided they "
"comply with the Docker*, Kubernetes* and Go* package versions listed "
"above. Look for your distribution documentation on how to update packages"
" and manage Docker services."
msgstr "深度学习参考堆栈是为了在 |CL| 主机上执行时获得最佳用户体验而开发的。但是,该堆栈在容器环境中运行时,您应该能够在其他 Linux* 发行版上完成本教程的以下部分,只要这些发行版满足上面列出的 Docker*、Kubernetes* 和 Go* 软件包版本。查找关于如何更新软件包和管理 Docker 服务的分发版文档。"
#: ../../guides/stacks/dlrs/dlrs.rst:112
msgid "TensorFlow single and multi-node benchmarks"
msgstr "TensorFlow 单节点和多节点基准测试"
#: ../../guides/stacks/dlrs/dlrs.rst:114
msgid ""
"This section describes running the `TensorFlow Benchmarks`_ in single "
"node. For multi-node testing, replicate these steps for each node. These "
"steps provide a template to run other benchmarks, provided that they can "
"invoke TensorFlow."
msgstr "本部分介绍在单节点中运行 `TensorFlow benchmarks`_。对于多节点测试,请为每个节点重复这些步骤。这些步骤提供了运行其他基准测试的模板,前提是它们可以调用 TensorFlow。"
#: ../../guides/stacks/dlrs/dlrs.rst:121
msgid ""
"Performance test results for the Deep Learning Reference Stack and for "
"this guide were obtained using `runc` as the runtime."
msgstr "深度学习参考堆栈和本教程的性能测试结果是使用 `runc` 作为运行时获得的。"
#: ../../guides/stacks/dlrs/dlrs.rst:124
msgid ""
"Download either the `Eigen`_ or the `Intel MKL-DNN`_ Docker image from "
"`Docker Hub`_."
msgstr "从 `Docker Hub`_ 下载 `Eigen`_ 或 `Intel MKL-DNN`_ Docker 映像。"
#: ../../guides/stacks/dlrs/dlrs.rst:127 ../../guides/stacks/dlrs/dlrs.rst:169
msgid "Run the image with Docker:"
msgstr "使用 Docker 运行映像:"
#: ../../guides/stacks/dlrs/dlrs.rst:136 ../../guides/stacks/dlrs/dlrs.rst:177
msgid ""
"Launching the Docker image with the :command:`-i` argument starts "
"interactive mode within the container. Enter the following commands in "
"the running container."
msgstr "使用 :command:`-i` 参数启动 Docker 映像,从而在容器内启动交互模式。在正在运行的容器中输入以下命令。"
#: ../../guides/stacks/dlrs/dlrs.rst:140
msgid "Clone the benchmark repository in the container:"
msgstr "克隆容器中的基准测试存储库:"
#: ../../guides/stacks/dlrs/dlrs.rst:146 ../../guides/stacks/dlrs/dlrs.rst:187
msgid "Execute the benchmark script:"
msgstr "执行基准测试脚本:"
#: ../../guides/stacks/dlrs/dlrs.rst:154
msgid ""
"You can replace the model with one of your choice supported by the "
"TensorFlow benchmarks."
msgstr "您可以将该模型更换为 TensorFlow 支持的其他模型。"
#: ../../guides/stacks/dlrs/dlrs.rst:157
msgid ""
"If you are using an FP32 based model, it can be converted to an int8 "
"model using `Intel® quantization tools`_."
msgstr "如果使用基于 FP32 的模型,可以使用 `Intel® quantization tools`_ 将其转换为 int8 模型。"
#: ../../guides/stacks/dlrs/dlrs.rst:161
msgid "PyTorch single and multi-node benchmarks"
msgstr "PyTorch 单节点和多节点基准测试"
#: ../../guides/stacks/dlrs/dlrs.rst:163
msgid ""
"This section describes running the `PyTorch benchmarks`_ for Caffe2 in "
"single node."
msgstr "本部分介绍在单节点中运行针对 Caffe2 的 `PyTorch benchmarks`_。"
#: ../../guides/stacks/dlrs/dlrs.rst:166
msgid ""
"Download either the `PyTorch with OpenBLAS`_ or the `PyTorch with Intel "
"MKL-DNN`_ Docker image from `Docker Hub`_."
msgstr "从 `Docker Hub`_ 下载 `PyTorch with OpenBLAS`_ 或 `PyTorch with Intel MKL-DNN`_ Docker 映像。"
#: ../../guides/stacks/dlrs/dlrs.rst:181
msgid "Clone the benchmark repository:"
msgstr "克隆基准测试存储库:"
#: ../../guides/stacks/dlrs/dlrs.rst:197
msgid "Kubeflow multi-node benchmarks"
msgstr "Kubeflow 多节点基准测试"
#: ../../guides/stacks/dlrs/dlrs.rst:199
msgid ""
"The benchmark workload runs in a Kubernetes cluster. The guide uses "
"`Kubeflow`_ for the Machine Learning workload deployment on three nodes."
msgstr "基准测试工作负载在 Kubernetes 集群中运行。本教程使用 `Kubeflow`_ 在三个节点上部署机器学习工作负载。"
#: ../../guides/stacks/dlrs/dlrs.rst:204
msgid ""
"If you choose the Intel® MKL-DNN or Intel® MKL-DNN-VNNI image, your "
"platform must support the Intel® AVX-512 instruction set. Otherwise, an "
"*illegal instruction* error may appear, and you wont be able to complete"
" this guide."
msgstr "如果选择英特尔® MKL-DNN 或英特尔® MKL-DNN-VNNI 映像,您的平台必须支持英特尔® AVX-512 指令集。否则,可能会出现非法指令错误,导致无法完成本教程。"
#: ../../guides/stacks/dlrs/dlrs.rst:210
msgid "Kubernetes setup"
msgstr "Kubernetes 设置"
#: ../../guides/stacks/dlrs/dlrs.rst:212
msgid ""
"Follow the instructions in the :ref:`kubernetes` tutorial to get set up "
"on |CL|. The Kubernetes community also has instructions for creating a "
"cluster, described in `Creating a single control-plane cluster with "
"kubeadm`_."
msgstr "按照 :ref:`kubernetes` 教程中的说明在 |CL| 上进行设置。Kubernetes 社区也提供了 `Creating a single control-plane cluster with kubeadm`_。"
#: ../../guides/stacks/dlrs/dlrs.rst:217
msgid "Kubernetes networking"
msgstr "Kubernetes 网络连接"
#: ../../guides/stacks/dlrs/dlrs.rst:219
msgid ""
"We used `flannel`_ as the network provider for these tests. If you prefer"
" a different network layer, refer to the Kubernetes network documentation"
" described in `Creating a single control-plane cluster with kubeadm`_ for"
" setup."
msgstr "在这些测试中,我们使用 `flannel`_ 作为网络提供程序。如果青睐不同的网络层,请参阅 Kubernetes `Creating a single control-plane cluster with kubeadm`_ 进行设置。"
#: ../../guides/stacks/dlrs/dlrs.rst:224
msgid "Kubectl"
msgstr "Kubectl"
#: ../../guides/stacks/dlrs/dlrs.rst:226
msgid ""
"You can use kubectl to run commands against your Kubernetes cluster. "
"Refer to the `Overview of kubectl`_ for details on syntax and operations."
" Once you have a working cluster on Kubernetes, use the following YAML "
"script to start a pod with a simple shell script, and keep the pod open."
msgstr "您可以使用 kubectl 对您的 Kubernetes 集群运行命令。有关语法和操作的详细信息,请参阅 `Overview of kubectl`_。建立一个 Kubernetes 工作集群后,请使用下面的 YAML 脚本启动一个含有简单 shell 脚本的 Pod,并保持该 Pod 处于打开状态。"
#: ../../guides/stacks/dlrs/dlrs.rst:231
msgid "Copy this example.yaml script to your system:"
msgstr "将 example.yaml 脚本复制到您的系统中:"
#: ../../guides/stacks/dlrs/dlrs.rst:248
msgid "Execute the script with kubectl:"
msgstr "使用 kubectl 执行该脚本:"
#: ../../guides/stacks/dlrs/dlrs.rst:254
msgid ""
"This script opens a single pod. More robust solutions would create a "
"deployment or inject a python script or larger shell script into the "
"container."
msgstr "该脚本打开一个 Pod。更稳健的解决方案是创建部署,或者将 python 脚本或更大的 shell 脚本注入容器。"
#: ../../guides/stacks/dlrs/dlrs.rst:258
msgid "Images"
msgstr "图像"
#: ../../guides/stacks/dlrs/dlrs.rst:260
msgid ""
"You must add `launcher.py`_ to the Docker image to include the Deep "
"Learning Reference Stack and put the benchmarks repo in the correct "
"location. Note that this guide uses Kubeflow v0.4.0, and cannot guarantee"
" results if you use a different version."
msgstr "您必须将 `launcher.py`_ 添加到 Docker 映像中,以包含深度学习参考堆栈,并将基准测试存储库放在正确的位置。请注意,本教程使用 Kubeflow v0.4.0。如果使用不同的版本,则不能保证结果。"
#: ../../guides/stacks/dlrs/dlrs.rst:264
msgid "From the Docker image, run the following:"
msgstr "从 Docker 映像中,运行以下命令:"
#: ../../guides/stacks/dlrs/dlrs.rst:273
msgid "Your entry point becomes: :file:`/opt/launcher.py`."
msgstr "您的入口点变成 :file:`/opt/launcher.py`。"
#: ../../guides/stacks/dlrs/dlrs.rst:275
msgid "This builds an image that can be consumed directly by TFJob from Kubeflow."
msgstr "这会构建一个可供 TFJob 从 Kubeflow 直接使用的映像。"
#: ../../guides/stacks/dlrs/dlrs.rst:278
msgid "ksonnet\\*"
msgstr "ksonnet\\*"
#: ../../guides/stacks/dlrs/dlrs.rst:280
msgid ""
"Kubeflow uses ksonnet\\* to manage deployments, so you must install it "
"before setting up Kubeflow."
msgstr "Kubeflow 使用 ksonnet\\* 来管理部署,因此您必须在设置 Kubeflow 之前安装它。"
#: ../../guides/stacks/dlrs/dlrs.rst:283
msgid ""
"ksonnet was added to the :command:`cloud-native-basic` bundle in |CL| "
"version 27550. If you are using an older |CL| version (not recommended), "
"you must manually install ksonnet as described below."
msgstr "ksonnet 已添加到 |CL| 版本 27550 中的 :command:`cloud-native-basic` 捆绑包中。如果使用的是较旧的 |CL| 版本(不推荐),您必须如下所述手动安装 ksonnet。"
#: ../../guides/stacks/dlrs/dlrs.rst:287
msgid "On |CL|, follow these steps:"
msgstr "在 |CL| 上,请按照下列步骤操作:"
#: ../../guides/stacks/dlrs/dlrs.rst:298
msgid ""
"After the ksonnet installation is complete, ensure that binary `ks` is "
"accessible across the environment."
msgstr "ksonnet 安装完成后,确保可在整个环境中访问 `ks` 二进制文件。"
#: ../../guides/stacks/dlrs/dlrs.rst:302
msgid "Kubeflow"
msgstr "Kubeflow"
#: ../../guides/stacks/dlrs/dlrs.rst:304
msgid ""
"Once you have Kubernetes running on your nodes, set up `Kubeflow`_ by "
"following these instructions from the `Getting Started with Kubeflow`_ "
"guide."
msgstr "Kubernetes 在节点上运行后,请按照 `Getting Started with Kubeflow`_ 中的说明设置 `Kubeflow`_。"
#: ../../guides/stacks/dlrs/dlrs.rst:322
msgid "Next, deploy the primary package for our purposes: tf-job-operator."
msgstr "接下来,为我们的目的部署主要软件包:tf-job-operator。"
#: ../../guides/stacks/dlrs/dlrs.rst:332
msgid ""
"This creates the CustomResourceDefinition (CRD) endpoint to launch a "
"TFJob."
msgstr "这将创建 CustomResourceDefinition (CRD) 端点来启动 TFJob。"
#: ../../guides/stacks/dlrs/dlrs.rst:335
msgid "Run a TFJob"
msgstr "运行 TFJob"
#: ../../guides/stacks/dlrs/dlrs.rst:337
msgid "Get the ksonnet registries for deploying TFJobs from `dlrs-tfjob`_."
msgstr "从 `dlrs-tfjob`_ 获取用于部署 TFJobs 的 ksonnet 注册表。"
#: ../../guides/stacks/dlrs/dlrs.rst:339
msgid "Install the TFJob components as follows:"
msgstr "按照以下步骤安装 TFJob 组件:"
#: ../../guides/stacks/dlrs/dlrs.rst:347
msgid "Export the image name to use for the deployment:"
msgstr "导出用于部署的映像名称:"
#: ../../guides/stacks/dlrs/dlrs.rst:355
msgid "Replace <docker_name> with the image name you specified in previous steps."
msgstr "将 <docker_name> 替换为前述步骤中指定的映像名称。"
#: ../../guides/stacks/dlrs/dlrs.rst:357
msgid ""
"Generate Kubernetes manifests for the workloads and apply them using "
"these commands:"
msgstr "为工作负载生成 Kubernetes 清单,并使用以下命令应用这些清单:"
#: ../../guides/stacks/dlrs/dlrs.rst:367
msgid "This replicates and deploys three test setups in your Kubernetes cluster."
msgstr "这会在 Kubernetes 集群中复制和部署三个测试设置。"
#: ../../guides/stacks/dlrs/dlrs.rst:370
msgid "Results of running this guide"
msgstr "运行本教程的结果"
#: ../../guides/stacks/dlrs/dlrs.rst:372
msgid ""
"You must parse the logs of the Kubernetes pod to retrieve performance "
"data. The pods will still exist post-completion and will be in "
"Completed state. You can get the logs from any of the pods to inspect "
"the benchmark results. More information about Kubernetes logging is "
"available in the Kubernetes `Logging Architecture`_ documentation."
msgstr "您必须解析 Kubernetes Pod 的日志来检索性能数据。完成后,Pod 仍会存在,并将处于“已完成”状态。您可以从任何一个 Pod 中获取日志来检查基准测试结果。有关 Kubernetes 日志记录的更多信息,请参见 Kubernetes `Logging Architecture`_ 文档。"
#: ../../guides/stacks/dlrs/dlrs.rst:379
msgid "Use Jupyter Notebook"
msgstr "使用 Jupyter Notebook"
#: ../../guides/stacks/dlrs/dlrs.rst:381
msgid ""
"This example uses the `PyTorch with OpenBLAS`_ container image. After it "
"is downloaded, run the Docker image with :command:`-p` to specify the "
"shared port between the container and the host. This example uses port "
"8888."
msgstr "本示例使用 `PyTorch with OpenBLAS`_ 容器映像。下载后,使用 :command:`-p` 运行 Docker 映像,以指定容器和主机之间的共享端口。本示例使用端口 8888。"
#: ../../guides/stacks/dlrs/dlrs.rst:389
msgid ""
"After you start the container, launch the Jupyter Notebook. This command "
"is executed inside the container image."
msgstr "启动容器后,启动 Jupyter Notebook。该命令在容器映像内执行。"
#: ../../guides/stacks/dlrs/dlrs.rst:396
msgid ""
"After the notebook has loaded, you will see output similar to the "
"following:"
msgstr "加载笔记本后,您将看到类似以下内容的输出:"
#: ../../guides/stacks/dlrs/dlrs.rst:404
msgid ""
"From your host system, or any system that can access the host's IP "
"address, start a web browser with the following. If you are not running "
"the browser on the host system, replace :command:`127.0.0.1` with the IP "
"address of the host."
msgstr "从您的主机系统或任何可以访问主机 IP 地址的系统,使用以下命令启动 Web 浏览器。如果没有在主机系统上运行浏览器,请将 :command:`127.0.0.1` 更换为主机的 IP 地址。"
#: ../../guides/stacks/dlrs/dlrs.rst:412
msgid "Your browser displays the following:"
msgstr "您的浏览器会显示以下内容:"
#: ../../guides/stacks/dlrs/dlrs.rst:418
msgid "Figure 1: :guilabel:`Jupyter Notebook`"
msgstr "图 1 :guilabel:`Jupyter Notebook`"
#: ../../guides/stacks/dlrs/dlrs.rst:421
msgid ""
"To create a new notebook, click :guilabel:`New` and select "
":guilabel:`Python 3`."
msgstr "要创建新笔记本,请点击 :guilabel:`New`,然后选择 :guilabel:`Python 3`。"
#: ../../guides/stacks/dlrs/dlrs.rst:427
msgid "Figure 2: Create a new notebook"
msgstr "图 2:创建一个新笔记本"
#: ../../guides/stacks/dlrs/dlrs.rst:429
msgid "A new, blank notebook is displayed, with a cell ready for input."
msgstr "此时将显示一个新的空白笔记本,其中有一个单元格可供输入内容。"
#: ../../guides/stacks/dlrs/dlrs.rst:436
msgid ""
"To verify that PyTorch is working, copy the following snippet into the "
"blank cell, and run the cell."
msgstr "要验证 PyTorch 是否正在工作,请将以下片段复制到空白单元格中,并运行该单元格。"
#: ../../guides/stacks/dlrs/dlrs.rst:450
msgid "When you run the cell, your output will look something like this:"
msgstr "运行单元格时,您的输出将如下所示:"
#: ../../guides/stacks/dlrs/dlrs.rst:456
msgid ""
"You can continue working in this notebook, or you can download existing "
"notebooks to take advantage of the Deep Learning Reference Stack's "
"optimized deep learning frameworks. Refer to `Jupyter Notebook`_ for "
"details."
msgstr "您可以继续在此笔记本中工作,也可以下载现有笔记本来利用深度学习参考堆栈的优化深度学习框架。详情请参阅 `Jupyter Notebook`_。"
#: ../../guides/stacks/dlrs/dlrs.rst:461
msgid "Uninstallation"
msgstr "卸载"
#: ../../guides/stacks/dlrs/dlrs.rst:463
msgid ""
"To uninstall the Deep Learning Reference Stack, you can choose to stop "
"the container so that it is not using system resources, or you can stop "
"the container and delete it to free storage space."
msgstr "要卸载深度学习参考堆栈,您可以选择停止容器以使其不使用系统资源,或者可以停止容器并将其删除以释放存储空间。"
#: ../../guides/stacks/dlrs/dlrs.rst:467
msgid "To stop the container, execute the following from your host system:"
msgstr "要停止容器,请从主机系统执行以下操作:"
#: ../../guides/stacks/dlrs/dlrs.rst:469
msgid "Find the container's ID"
msgstr "找到容器的 ID"
#: ../../guides/stacks/dlrs/dlrs.rst:475
msgid "This will result in output similar to the following:"
msgstr "这将产生类似于以下内容的输出:"
#: ../../guides/stacks/dlrs/dlrs.rst:482
msgid ""
"You can then use the ID or container name to stop the container. This "
"example uses the name \"oss\":"
msgstr "然后,您可以使用 ID 或容器名称来停止容器。本示例使用名称 \"oss\""
#: ../../guides/stacks/dlrs/dlrs.rst:490
msgid "Verify that the container is not running"
msgstr "验证容器未在运行"
#: ../../guides/stacks/dlrs/dlrs.rst:497
msgid "To delete the container from your system you need to know the Image ID:"
msgstr "要从系统中删除容器,您需要知道映像 ID:"
#: ../../guides/stacks/dlrs/dlrs.rst:503
msgid "This command results in output similar to the following:"
msgstr "该命令会产生类似于以下内容的输出:"
#: ../../guides/stacks/dlrs/dlrs.rst:511
msgid "To remove an image use the image ID:"
msgstr "要移除映像,请使用映像 ID"
#: ../../guides/stacks/dlrs/dlrs.rst:527
msgid ""
"Note that you can execute the :command:`docker rmi` command using only "
"the first few characters of the image ID, provided they are unique on the"
" system."
msgstr "请注意,您可以只使用映像 ID 的前几个字符来执行 :command:`docker rmi` 命令,前提是它们在系统上是唯一的。"
#: ../../guides/stacks/dlrs/dlrs.rst:529
msgid "Once you have removed the image, you can verify it has been deleted with:"
msgstr "移除映像后,您可以通过以下方式验证它是否已被移除:"
#: ../../guides/stacks/dlrs/dlrs.rst:537
msgid "Related topics"
msgstr "相关主题"
#: ../../guides/stacks/dlrs/dlrs.rst:539
msgid "`DLRS V3.0`_ release announcement"
msgstr "`DLRS V3.0`_ 发布公告"
#: ../../guides/stacks/dlrs/dlrs.rst:540
msgid "`TensorFlow Benchmarks`_"
msgstr "`TensorFlow Benchmarks`_"
#: ../../guides/stacks/dlrs/dlrs.rst:541
msgid "`PyTorch benchmarks`_"
msgstr "`PyTorch benchmarks`_"
#: ../../guides/stacks/dlrs/dlrs.rst:542
msgid "`Kubeflow`_"
msgstr "`Kubeflow`_"
#: ../../guides/stacks/dlrs/dlrs.rst:543
msgid ":ref:`kubernetes` tutorial"
msgstr ":ref:`kubernetes` 教程"
#: ../../guides/stacks/dlrs/dlrs.rst:544
msgid "`Jupyter Notebook`_"
msgstr "`Jupyter Notebook`_"
#~ msgid "Deep Learning Reference Stack `V3.0 release announcement`_."
#~ msgstr "深度学习参考堆栈 `V3.0 release announcement`_。"
#~ msgid ""
#~ "You must parse the logs of the "
#~ "Kubernetes pod to retrieve performance "
#~ "data. The pods will still exist "
#~ "post-completion and will be in "
#~ "Completed state. You can get the "
#~ "logs from any of the pods to "
#~ "inspect the benchmark results. More "
#~ "information about `Kubernetes logging`_ is "
#~ "available from the Kubernetes community."
#~ msgstr ""
#~ "您必须解析 Kubernetes Pod 的日志来检索性能数据。完成后,Pod "
#~ "仍会存在,并将处于“已完成”状态。您可以从任何一个 Pod 中获取日志来检查基准测试结果。有关 "
#~ "`Kubernetes logging`_ 的更多信息可从 Kubernetes 社区获取。"
#~ msgid "Deep Learning Reference Stack `V3.0 release announcement`_"
#~ msgstr "深度学习参考堆栈 `V3.0 release announcement`_"
@@ -0,0 +1,711 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../guides/stacks/greengrass.rst:4
msgid "Enable AWS Greengrass\\* and OpenVINO™ toolkit"
msgstr "启用 AWS Greengrass\\* 和 OpenVINO™ 工具包"
#: ../../guides/stacks/greengrass.rst:6
msgid ""
"This guide explains how to enable AWS Greengrass\\* and OpenVINO™ "
"toolkit. Specifically, the guide demonstrates how to:"
msgstr "本指南说明了如何启用 AWS Greengrass\\* 和 OpenVINO™ 工具包。具体而言,该指南演示了如何:"
#: ../../guides/stacks/greengrass.rst:9
msgid "Set up the Intel® edge device with |CL-ATTR|"
msgstr "使用 |CL-ATTR| 设置英特尔®边缘设备"
#: ../../guides/stacks/greengrass.rst:10
msgid ""
"Install the OpenVINO™ toolkit and Amazon Web Services\\* (AWS\\*) "
"Greengrass\\* software stacks"
msgstr "安装 OpenVINO™ 工具包和 Amazon Web Services\\* (AWS\\*) Greengrass\\* 软件堆栈"
#: ../../guides/stacks/greengrass.rst:12
msgid ""
"Use AWS Greengrass\\* and AWS Lambda\\* to deploy the FaaS samples from "
"the cloud"
msgstr "使用 AWS Greengrass\\* 和 AWS Lambda\\* 从云中部署 FaaS 示例"
#: ../../guides/stacks/greengrass.rst:20
msgid "Overview"
msgstr "概述"
#: ../../guides/stacks/greengrass.rst:22
msgid ""
"Hardware accelerated Function-as-a-Service (FaaS) enables cloud "
"developers to deploy inference functionalities [1] on Intel® IoT edge "
"devices with accelerators (CPU, Integrated GPU, Intel® FPGA, and Intel® "
"Movidius™ technology). These functions provide a great developer "
"experience and seamless migration of visual analytics from cloud to edge "
"in a secure manner using a containerized environment. Hardware-"
"accelerated FaaS provides the best-in-class performance by accessing "
"optimized deep learning libraries on Intel® IoT edge devices with "
"accelerators."
msgstr "硬件加速的功能即服务 (FaaS) 有助于云开发人员在搭载加速器的英特尔® IoT 边缘设备(CPU、集成 GPU、英特尔® FPGA 和英特尔® Movidius™ 技术)上部署推理功能 [1]。这些功能使用容器化环境,为开发人员提供了出色的体验,有助于开发人员将可视化分析从云安全地迁移到边缘。硬件加速的 FaaS 支持在搭载加速器的英特尔® IoT 边缘设备上访问经过优化的深度学习库,实现业界最佳性能。"
#: ../../guides/stacks/greengrass.rst:32
msgid "Supported platforms"
msgstr "支持的平台"
#: ../../guides/stacks/greengrass.rst:34
msgid "Operating System: |CL| latest release"
msgstr "操作系统:|CL| 最新版本"
#: ../../guides/stacks/greengrass.rst:35
msgid "Hardware: Intel® core platforms (that support inference on CPU only)"
msgstr "硬件:英特尔®酷睿™平台(本教程仅支持 CPU 推理。)"
#: ../../guides/stacks/greengrass.rst:38
msgid "Sample description"
msgstr "示例说明"
#: ../../guides/stacks/greengrass.rst:40
msgid ""
"The AWS Greengrass samples are located at `Edge-Analytics-FaaS`_. This "
"guide uses the 1.0 version of the source code."
msgstr "AWS Greengrass 示例位于 `Edge-Analytics-FaaS`_ 中。本教程使用 1.0 版本的源代码。"
#: ../../guides/stacks/greengrass.rst:43
msgid "|CL| provides the following AWS Greengrass samples:"
msgstr "|CL| 提供以下 AWS Greengrass 示例:"
#: ../../guides/stacks/greengrass.rst:45
msgid "`greengrass_classification_sample.py`_"
msgstr "`greengrass_classification_sample.py`_"
#: ../../guides/stacks/greengrass.rst:47
msgid ""
"This AWS Greengrass sample classifies a video stream using classification"
" networks such as AlexNet and GoogLeNet and publishes top-10 results on "
"AWS\\* IoT Cloud every second."
msgstr "此 AWS Greengrass 示例使用 AlexNet 和 GoogLeNet 等分类网络对视频流进行分类,并每秒在 AWS\\* IoT 云上发布前十名结果。"
#: ../../guides/stacks/greengrass.rst:51
msgid "`greengrass_object_detection_sample_ssd.py`_"
msgstr "`greengrass_object_detection_sample_ssd.py`_"
#: ../../guides/stacks/greengrass.rst:53
msgid ""
"This AWS Greengrass sample detects objects in a video stream and "
"classifies them using single-shot multi-box detection (SSD) networks such"
" as SSD Squeezenet, SSD Mobilenet, and SSD300. This sample publishes "
"detection outputs such as class label, class confidence, and bounding box"
" coordinates on AWS IoT Cloud every second."
msgstr "此 AWS Greengrass 示例会检测视频流中的对象,并使用单步多框检测 (SSD) 网络(例如 SSD Squeezenet、SSD Mobilenet 和 SSD300)对它们进行分类。此示例每秒在 AWS IoT 云上发布检测输出,如类标签、类置信度和边界框坐标。"
#: ../../guides/stacks/greengrass.rst:61
msgid "Install the OS on the edge device"
msgstr "在边缘设备上安装操作系统"
#: ../../guides/stacks/greengrass.rst:63
msgid ""
"Start with a clean installation of |CL| on a new system, using the :ref"
":`bare-metal-install-desktop`, found in :ref:`get-started`."
msgstr "使用 :ref:`get-started` 中的 :ref:`bare-metal-install-desktop`,在新系统上安装干净的 |CL|。"
#: ../../guides/stacks/greengrass.rst:67
msgid "Create user accounts"
msgstr "创建用户帐户"
#: ../../guides/stacks/greengrass.rst:69
msgid ""
"After |CL| is installed, create two user accounts. Create an "
"administrative user in |CL| and create a user account for the Greengrass "
"services to use ( see Greengrass user below)."
msgstr "安装 |CL| 后,创建两个用户帐户。在 |CL| 中创建一个管理用户,并为要使用的 Greengrass 服务创建一个用户帐户(请参阅下面的 Greengrass 用户)。"
#: ../../guides/stacks/greengrass.rst:73
msgid ""
"Create a new user and set a password for that user. Enter the following "
"commands as ``root``:"
msgstr "创建新用户并为该用户设置密码。以 ``root`` 用户身份输入以下命令:"
#: ../../guides/stacks/greengrass.rst:81
msgid ""
"Next, enable the :command:`sudo` command for your new <userid>. Add "
"<userid> to the `wheel` group:"
msgstr "接下来,为新的 <userid> 启用 :command:`sudo` 命令。将 <userid> 添加到 `wheel` 组:"
#: ../../guides/stacks/greengrass.rst:88
msgid "Create a :file:`/etc/fstab` file."
msgstr "创建一个 :file:`/etc/fstab` 文件。"
#: ../../guides/stacks/greengrass.rst:96
msgid ""
"By default, |CL| does not create an :file:`/etc/fstab` file. You must "
"create this file before the Greengrass service runs."
msgstr "默认情况下,|CL| 不会创建 :file:`/etc/fstab` 文件。您必须在 Greengrass 服务运行之前创建此文件。"
#: ../../guides/stacks/greengrass.rst:100
msgid "Add required bundles"
msgstr "添加所需的捆绑包"
#: ../../guides/stacks/greengrass.rst:102
msgid ""
"Use the :command:`swupd` software updater utility to add the prerequisite"
" bundles for the OpenVINO software stack:"
msgstr "使用 :command:`swupd` 软件更新程序实用程序添加 OpenVINO 软件堆栈必备的软件包:"
#: ../../guides/stacks/greengrass.rst:111
msgid "Learn more about how to :ref:`swupd-guide`."
msgstr "详细了解如何 :ref:`swupd-guide`。"
#: ../../guides/stacks/greengrass.rst:113
msgid ""
"The :command:`computer-vision-basic` bundle installs the OpenVINO™ "
"toolkit, and the sample models optimized for Intel® edge platforms."
msgstr ":command:`computer-vision-basic` 捆绑包会安装 OpenVINO™ 工具包以及针对英特尔®边缘平台优化的示例模型。"
#: ../../guides/stacks/greengrass.rst:117
msgid "Convert deep learning models"
msgstr "转换深度学习模型"
#: ../../guides/stacks/greengrass.rst:120
msgid "Locate sample models"
msgstr "找到示例模型"
#: ../../guides/stacks/greengrass.rst:122
msgid ""
"There are two types of provided models that can be used in conjunction "
"with AWS Greengrass for this guide: classification or object detection."
msgstr "本教程中提供了两种可以与 AWS Greengrass 配合使用的模型:分类和对象检测。"
#: ../../guides/stacks/greengrass.rst:125
msgid ""
"To complete this guide using an image classification model, download the "
"BVLC AlexNet model files `bvlc_alexnet.caffemodel`_ and "
"`deploy.prototxt`_ to the default model_location at "
":file:`/usr/share/openvino/models`. Any custom pre-trained classification"
" models can be used with the classification sample."
msgstr "要使用图像分类模型完成本教程,请将 BVLC AlexNet 模型文件 `bvlc_alexnet.caffemodel`_ 和 `deploy.prototxt`_ 下载到 :file:`/usr/share/openvino/models` 处的默认 model_location。预先训练的任何自定义分类模型都可与分类示例配合使用。"
#: ../../guides/stacks/greengrass.rst:131
msgid ""
"For object detection, the sample models optimized for Intel® edge "
"platforms are included with the computer-vision-basic bundle installation"
" at :file:`/usr/share/openvino/models`. These models are provided as an "
"example; you may also use a custom SSD model with the Greengrass object "
"detection sample."
msgstr "对于对象检测,安装 computer-vision-basic 捆绑包时会在 :file:`/usr/share/openvino/models` 处附带针对英特尔®边缘平台优化的示例模型。这些模型作为示例提供;但是,您也可以将自定义 SSD 模型与 Greengrass 对象检测示例结合使用。"
#: ../../guides/stacks/greengrass.rst:137
msgid "Run model optimizer"
msgstr "运行模型优化器"
#: ../../guides/stacks/greengrass.rst:139
msgid ""
"Follow the instructions in the `Model Optimizer Developer Guide`_ for "
"converting deep learning models to Intermediate Representation using "
"Model Optimizer. To optimize either of the sample models described above,"
" run one of the following commands."
msgstr "遵循 `Model Optimizer Developer Guide`_ 中的说明,使用 Model Optimizer 将深度学习模型转换为 Intermediate Representation。要优化上述任一示例模型,请运行以下命令之一。"
#: ../../guides/stacks/greengrass.rst:143
msgid "For classification using BVLC AlexNet model:"
msgstr "对于使用 BVLC AlexNet 模型的分类:"
#: ../../guides/stacks/greengrass.rst:152
msgid "For object detection using SqueezeNetSSD-5Class model:"
msgstr "对于使用 SqueezeNetSSD-5Class 模型的对象检测:"
#: ../../guides/stacks/greengrass.rst:161
msgid "In these examples:"
msgstr "在这些示例中:"
#: ../../guides/stacks/greengrass.rst:163
msgid "`<model_location>` is :file:`/usr/share/openvino/models`."
msgstr "`<model_location>` 是 :file:`/usr/share/openvino/models`。"
#: ../../guides/stacks/greengrass.rst:165
msgid "`<data_type>` is FP32 or FP16, depending on target device."
msgstr "`<data_type>` 是 FP32 或 FP16,具体取决于目标设备。"
#: ../../guides/stacks/greengrass.rst:167
msgid ""
"`<output_dir>` is the directory where the Intermediate Representation "
"(IR) is stored. IR contains .xml format corresponding to the network "
"structure and .bin format corresponding to weights. This .xml file should"
" be passed to :command:`<PARAM_MODEL_XML>`."
msgstr "`<output_dir>` 是存储中间表示 (IR) 的目录。IR 包含与网络结构对应的 .xml 格式以及与权重对应的 .bin 格式。此 .xml 文件应传递给 :command:`<PARAM_MODEL_XML>`。"
#: ../../guides/stacks/greengrass.rst:172
msgid ""
"In the BVLC AlexNet model, the prototxt defines the input shape with "
"batch size 10 by default. In order to use any other batch size, the "
"entire input shape must be provided as an argument to the model "
"optimizer. For example, to use batch size 1, you must provide: "
"`--input_shape [1,3,227,227]`"
msgstr "在 BVLC AlexNet 模型中,默认情况下,prototxt 会定义批处理大小为 10 的输入形状。要使用任何其他批处理大小,必须将整个输入形状作为参数提供给模型优化器。例如,要使用批处理大小 1,您必须提供 `--input_shape [1,3,227,227]`"
#: ../../guides/stacks/greengrass.rst:180
msgid "Configure AWS Greengrass group"
msgstr "配置 AWS Greengrass 组"
#: ../../guides/stacks/greengrass.rst:182
msgid ""
"For each Intel® edge platform, you must create a new AWS Greengrass group"
" and install AWS Greengrass core software to establish the connection "
"between cloud and edge."
msgstr "对于每个英特尔®边缘平台,您必须创建一个新的 AWS Greengrass 组,并安装 AWS Greengrass 核心软件,以在云和边缘之间建立连接。"
#: ../../guides/stacks/greengrass.rst:186
msgid ""
"To create an AWS Greengrass group, follow the instructions in `Configure "
"AWS IoT Greengrass on AWS IoT`_."
msgstr "要创建 AWS Greengrass 组,请按照 `Configure AWS IoT Greengrass on AWS IoT`_ 中的说明执行操作。"
#: ../../guides/stacks/greengrass.rst:189
msgid ""
"To install and configure AWS Greengrass core on edge platform, follow the"
" instructions in `Start AWS Greengrass on the Core Device`_. In step "
"8(b), download the x86_64 Ubuntu\\* configuration of the AWS Greengrass "
"core software."
msgstr "要在边缘平台上安装和配置 AWS Greengrass 核心,请按照 `Start AWS Greengrass on the Core Device`_ 中的说明执行操作。在步骤 8(b) 中,下载 AWS Greengrass 核心软件的 x86_64 Ubuntu\\* 配置。"
#: ../../guides/stacks/greengrass.rst:196
msgid ""
"You do not need to run the :file:`cgroupfs-mount.sh` script in step #6 of"
" Module 1 of the `AWS Greengrass Developer Guide`_ because this is "
"enabled already in |CL|."
msgstr "您不需要在 `AWS Greengrass developer guide`_ 模块 1 的步骤 6 中运行 :file:`cgroupfs-mount.sh` 脚本,因为它已经在 |CL| 中启用。"
#: ../../guides/stacks/greengrass.rst:200
msgid ""
"Be sure to download both the security resources and the AWS Greengrass "
"core software."
msgstr "请务必下载安全资源和 AWS Greengrass 核心软件。"
#: ../../guides/stacks/greengrass.rst:205
msgid "Security certificates are linked to your AWS account."
msgstr "安全证书会链接到您的 AWS 帐户。"
#: ../../guides/stacks/greengrass.rst:209
msgid "Create and package Lambda function"
msgstr "创建并打包 Lambda 函数"
#: ../../guides/stacks/greengrass.rst:211
msgid ""
"Complete steps 1-4 of the AWS Greengrass guide at `Create and Package a "
"Lambda Function`_."
msgstr "在 `Create and Package a Lambda Function`_ 中完成 AWS Greengrass 教程的步骤 1-4。"
#: ../../guides/stacks/greengrass.rst:216
msgid ""
"This creates the tarball needed to create the AWS Greengrass environment "
"on the edge device."
msgstr "这会创建必要的 tarball,以便在边缘设备上创建 AWS Greengrass 环境。"
#: ../../guides/stacks/greengrass.rst:220
msgid ""
"In step 5, replace :file:`greengrassHelloWorld.py` with the "
"classification or object detection Greengrass sample from `Edge-"
"Analytics-Faas`_:"
msgstr "在步骤 5 中,将 :file:`greengrassHelloWorld.py` 替换为 `Edge-Analytics-Faas`_ 中的分类或对象检测 Greengrass 示例:"
#: ../../guides/stacks/greengrass.rst:223
msgid "Classification: `greengrass_classification_sample.py`_"
msgstr "分类:`greengrass_classification_sample.py`_"
#: ../../guides/stacks/greengrass.rst:225
msgid "Object Detection: `greengrass_object_detection_sample_ssd.py`_"
msgstr "对象检测:`greengrass_object_detection_sample_ssd.py`_"
#: ../../guides/stacks/greengrass.rst:227
msgid ""
"Zip the selected Greengrass sample with the extracted Greengrass SDK "
"folders from the previous step into "
":file:`greengrass_sample_python_lambda.zip`."
msgstr "将所选的 Greengrass 示例以及从上一步提取的 Greengrass SDK 文件夹压缩到 :file:`greengrass_sample_python_lambda.zip`。"
#: ../../guides/stacks/greengrass.rst:230
msgid "The zip should contain:"
msgstr "压缩包应包含:"
#: ../../guides/stacks/greengrass.rst:232
msgid "greengrasssdk"
msgstr "greengrasssdk"
#: ../../guides/stacks/greengrass.rst:234
msgid "greengrass classification or object detection sample"
msgstr "greengrass 分类或对象检测示例"
#: ../../guides/stacks/greengrass.rst:236
msgid "For example:"
msgstr "例如:"
#: ../../guides/stacks/greengrass.rst:243
msgid ""
"Return to the AWS documentation section called `Create and Package a "
"Lambda Function`_ and complete the procedure."
msgstr "返回名为 `Create and Package a Lambda Function`_ 的 AWS 文档部分,并完成步骤。"
#: ../../guides/stacks/greengrass.rst:248
msgid ""
"In step 9(a) of the AWS documentation, while uploading the zip file, make"
" sure to name the handler to one of the following, depending on the AWS "
"Greengrass sample you are using:"
msgstr "在 AWS 文档的步骤 9(a) 中,上传 Zip 文件,并确保根据使用的 AWS Greengrass 示例将处理程序命名为以下名称之一:"
#: ../../guides/stacks/greengrass.rst:252
msgid "greengrass_object_detection_sample_ssd.function_handler"
msgstr "greengrass_object_detection_sample_ssd.function_handler"
#: ../../guides/stacks/greengrass.rst:253
msgid "greengrass_classification_sample.function_handler"
msgstr "greengrass_classification_sample.function_handler"
#: ../../guides/stacks/greengrass.rst:257
msgid "Configure Lambda function"
msgstr "配置 Lambda 函数"
#: ../../guides/stacks/greengrass.rst:259
msgid ""
"After creating the Greengrass group and the Lambda function, start "
"configuring the Lambda function for AWS Greengrass."
msgstr "创建 Greengrass 组和 Lambda 函数后,开始为 AWS Greengrass 配置 Lambda 函数。"
#: ../../guides/stacks/greengrass.rst:262
msgid ""
"Follow steps 1-8 in `Configure the Lambda Function for AWS IoT "
"Greengrass`_ in the AWS documentation."
msgstr "按照 AWS 文档中 `Configure the Lambda Function for AWS IoT Greengrass`_ 中的步骤 1-8 执行操作。"
#: ../../guides/stacks/greengrass.rst:265
msgid ""
"In addition to the details mentioned in step 8, change the Memory limit "
"to 2048 MB to accommodate large input video streams."
msgstr "除了步骤 8 中提到的细节之外,将内存限制更改为 2048 MB,以容纳较大的输入视频流。"
#: ../../guides/stacks/greengrass.rst:268
msgid ""
"Add the following environment variables as key-value pairs when editing "
"the Lambda configuration and click on update:"
msgstr "编辑 Lambda 配置时,添加以下环境变量作为键值对,然后点击更新:"
#: ../../guides/stacks/greengrass.rst:271
msgid "**Table 1. Environment variables: Lambda configuration**"
msgstr "**表 1.环境变量:Lambda 配置**"
#: ../../guides/stacks/greengrass.rst:275
msgid "Key"
msgstr "键"
#: ../../guides/stacks/greengrass.rst:276
msgid "Value"
msgstr "值"
#: ../../guides/stacks/greengrass.rst:277
msgid "PARAM_MODEL_XML"
msgstr "PARAM_MODEL_XML"
#: ../../guides/stacks/greengrass.rst:278
msgid ""
"<MODEL_DIR>/<IR.xml>, where <MODEL_DIR> is user specified and contains "
"IR.xml, the Intermediate Representation file from Intel® Model Optimizer."
" For this guide, <MODEL_DIR> should be set to "
"'/usr/share/openvino/models' or one of its subdirectories."
msgstr "<MODEL_DIR>/<IR.xml>,其中 <MODEL_DIR> 是用户指定的,包含来自英特尔®模型优化器的中间表示文件 IR.xml。在本教程中,<MODEL_DIR> 应设置为 '/usr/share/openvino/models' 或其某个子目录。"
#: ../../guides/stacks/greengrass.rst:282
msgid "PARAM_INPUT_SOURCE"
msgstr "PARAM_INPUT_SOURCE"
#: ../../guides/stacks/greengrass.rst:283
msgid "<DATA_DIR>/input.webm to be specified by user. Holds both input and"
msgstr "<DATA_DIR>由用户指定的 /input.webm。保存输入和"
#: ../../guides/stacks/greengrass.rst:284
msgid "output data. For webcam, set PARAM_INPUT_SOURCE to /dev/video0"
msgstr "输出数据。对于网络摄像头,请将 PARAM_INPUT_SOURCE 设置为 /dev/video0"
#: ../../guides/stacks/greengrass.rst:285
msgid "PARAM_DEVICE"
msgstr "PARAM_DEVICE"
#: ../../guides/stacks/greengrass.rst:286
msgid "\"CPU\""
msgstr "\"CPU\""
#: ../../guides/stacks/greengrass.rst:287
msgid "PARAM_CPU_EXTENSION_PATH"
msgstr "PARAM_CPU_EXTENSION_PATH"
#: ../../guides/stacks/greengrass.rst:288
msgid "/usr/lib64/libcpu_extension.so"
msgstr "/usr/lib64/libcpu_extension.so"
#: ../../guides/stacks/greengrass.rst:289
msgid "PARAM_OUTPUT_DIRECTORY"
msgstr "PARAM_OUTPUT_DIRECTORY"
#: ../../guides/stacks/greengrass.rst:290
msgid "<DATA_DIR> to be specified by user. Holds both input and output data"
msgstr "<DATA_DIR> 由用户指定。保存输入和输出数据"
#: ../../guides/stacks/greengrass.rst:292
msgid "PARAM_NUM_TOP_RESULTS"
msgstr "PARAM_NUM_TOP_RESULTS"
#: ../../guides/stacks/greengrass.rst:293
msgid ""
"User specified for classification sample. (e.g. 1 for top-1 result, 5 for"
" top-5 results)"
msgstr "为分类示例指定的用户。(例如,1 为 前 1 名结果,5 为前 5 名结果)"
#: ../../guides/stacks/greengrass.rst:296
msgid ""
"Add subscription to subscribe, or publish messages from AWS Greengrass "
"Lambda function by completing the procedure in `Configure the Lambda "
"Function for AWS IoT Greengrass`_."
msgstr "完成 `Configure the Lambda Function for AWS IoT Greengrass`_ 中的步骤,添加订阅以进行订阅或发布来自 AWS Greengrass Lambda 函数的消息。"
#: ../../guides/stacks/greengrass.rst:301
msgid ""
"The optional topic filter field is the topic mentioned inside the Lambda "
"function. In this guide, sample topics include the following: "
":command:`openvino/ssd` or :command:`openvino/classification`"
msgstr "可选主题过滤器字段是 Lambda 函数中提到的主题。在本教程中,示例主题包括以下 :command:`openvino/ssd` 或 :command:`openvino/classification`"
#: ../../guides/stacks/greengrass.rst:305
msgid "Add local resources"
msgstr "添加本地资源"
#: ../../guides/stacks/greengrass.rst:307
msgid ""
"Refer to the AWS documentation `Access Local Resources with Lambda "
"Functions and Connectors`_ for details about local resources and access "
"privileges."
msgstr "有关 `Access Local Resources with Lambda Functions and Connectors`_ 的详细信息,请参阅 AWS 文档。"
#: ../../guides/stacks/greengrass.rst:310
msgid "The following table describes the local resources needed for the CPU:"
msgstr "下表列出了 CPU 所需的本地资源:"
#: ../../guides/stacks/greengrass.rst:312
msgid "**Local resources**"
msgstr "**本地资源**"
#: ../../guides/stacks/greengrass.rst:316
msgid "Name"
msgstr "名称"
#: ../../guides/stacks/greengrass.rst:317
msgid "Resource type"
msgstr "资源类型"
#: ../../guides/stacks/greengrass.rst:318
msgid "Local path"
msgstr "本地路径"
#: ../../guides/stacks/greengrass.rst:319
msgid "Access"
msgstr "访问"
#: ../../guides/stacks/greengrass.rst:321
msgid "ModelDir"
msgstr "ModelDir"
#: ../../guides/stacks/greengrass.rst:322
#: ../../guides/stacks/greengrass.rst:332
msgid "Volume"
msgstr "卷"
#: ../../guides/stacks/greengrass.rst:323
msgid "<MODEL_DIR> to be specified by user"
msgstr "<MODEL_DIR> 由用户指定"
#: ../../guides/stacks/greengrass.rst:324
#: ../../guides/stacks/greengrass.rst:329
msgid "Read-Only"
msgstr "只读"
#: ../../guides/stacks/greengrass.rst:326
msgid "Webcam"
msgstr "网络摄像头"
#: ../../guides/stacks/greengrass.rst:327
msgid "Device"
msgstr "设备"
#: ../../guides/stacks/greengrass.rst:328
msgid "/dev/video0"
msgstr "/dev/video0"
#: ../../guides/stacks/greengrass.rst:331
msgid "DataDir"
msgstr "DataDir"
#: ../../guides/stacks/greengrass.rst:333
msgid "<DATA_DIR> to be specified by user. Holds both input and output data."
msgstr "<DATA_DIR> 由用户指定。保存输入和输出数据。"
#: ../../guides/stacks/greengrass.rst:335
msgid "Read and Write"
msgstr "读取和写入"
#: ../../guides/stacks/greengrass.rst:338
msgid "Deploy Lambda function"
msgstr "部署 Lambda 函数"
#: ../../guides/stacks/greengrass.rst:340
msgid ""
"Refer to the AWS documentation `Deploy Cloud Configurations to an AWS IoT"
" Greengrass Core Device`_ for instructions on how to deploy the lambda "
"function to AWS Greengrass core device. Select *Deployments* on the group"
" page and follow the instructions."
msgstr "有关如何 `Deploy Cloud Configurations to an AWS IoT Greengrass Core Device`_ 的说明,请参阅 AWS 文档。在组页面上选择 *Deployments*,并按照说明执行操作。"
#: ../../guides/stacks/greengrass.rst:344
msgid "Output consumption"
msgstr "输出的使用"
#: ../../guides/stacks/greengrass.rst:346
msgid ""
"There are four options available for output consumption. These options "
"are used to report, stream, upload, or store inference output at an "
"interval defined by the variable :command:`reporting_interval` in the AWS"
" Greengrass samples."
msgstr "使用输出时有四种可用选项。这些选项用于按 AWS Greengrass 示例中 :command:`reporting_interval` 变量定义的间隔,报告、流式传输、上传或存储推理输出。"
#: ../../guides/stacks/greengrass.rst:350
msgid "IoT cloud output:"
msgstr "IoT 云输出:"
#: ../../guides/stacks/greengrass.rst:352
msgid ""
"This option is enabled by default in the AWS Greengrass samples using the"
" :command:`enable_iot_cloud_output` variable. You can use it to verify "
"the lambda running on the edge device. It enables publishing messages to "
"IoT cloud using the subscription topic specified in the lambda. (For "
"example, topics may include :command:`openvino/classification` for "
"classification and :command:`openvino/ssd` for object detection samples.)"
" For classification, top-1 result with class label are published to IoT "
"cloud. For SSD object detection, detection results such as bounding box "
"coordinates of objects, class label, and class confidence are published."
msgstr "在 AWS Greengrass 示例中,默认情况下使用 :command:`enable_iot_cloud_output` 变量启用此选项。您可以使用它来验证在边缘设备上运行的 lambda。它支持使用 lambda 中指定的订阅主题向 IoT 云发布消息。(例如,主题可能包括用于分类示例的 :command:`openvino/classification` 以及用于对象检测示例的 :command:`openvino/ssd`。) 对于分类,具有类标签的前 1 名结果会发布到 IoT 云。对于 SSD 对象检测,则发布对象的边界框坐标、类标签和类置信度等检测结果。"
#: ../../guides/stacks/greengrass.rst:362
msgid ""
"Refer to the AWS documentation `Verify the Lambda Function Is Running on "
"the Device`_ for instructions on how to view the output on IoT cloud."
msgstr "有关如何在 IoT 云上查看输出的说明,请参考 AWS 文档 `Verify the Lambda Function Is Running on the Device`_。"
#: ../../guides/stacks/greengrass.rst:366
msgid "Kinesis streaming:"
msgstr "Kinesis 流式传输:"
#: ../../guides/stacks/greengrass.rst:368
msgid ""
"This option enables inference output to be streamed from the edge device "
"to cloud using Kinesis [3] streams when :command:`enable_kinesis_output` "
"is set to True. The edge devices act as data producers and continually "
"push processed data to the cloud. You must set up and specify Kinesis "
"stream name, Kinesis shard, and AWS region in the AWS Greengrass samples."
msgstr ":command:`enable_kinesis_output` 设置为 True 时,此选项支持使用 Kinesis [3] 流将推理输出从边缘设备流式传输到云。边缘设备充当数据生产者,并将处理后的数据不断推送到云中。您必须在 AWS Greengrass 示例中设置和指定 Kinesis 流名称、Kinesis shard 和 AWS 区域。"
#: ../../guides/stacks/greengrass.rst:375
msgid "Cloud storage using AWS S3 bucket:"
msgstr "使用 AWS S3 存储桶的云存储:"
#: ../../guides/stacks/greengrass.rst:377
msgid ""
"When the :command:`enable_s3_jpeg_output` variable is set to True, it "
"enables uploading and storing processed frames (in jpeg format) in an AWS"
" S3 bucket. You must set up and specify the S3 bucket name in the AWS "
"Greengrass samples to store the JPEG images. The images are named using "
"the timestamp and uploaded to S3."
msgstr "将 :command:`enable_s3_jpeg_output` 变量设置为 True 时,它允许在 AWS S3 存储桶中上传和存储已处理的帧(jpeg 格式)。您必须在 AWS Greengrass 示例中设置和指定用来存储 JPEG 图像的 S3 存储桶名称。这些映像使用时间戳命名,并上传到 S3。"
#: ../../guides/stacks/greengrass.rst:383
msgid "Local storage:"
msgstr "本地存储:"
#: ../../guides/stacks/greengrass.rst:385
msgid ""
"When the :command:`enable_s3_jpeg_output` variable is set to True, it "
"enables storing processed frames (in jpeg format) on the edge device. The"
" images are named using the timestamp and stored in a directory specified"
" by :command:`PARAM_OUTPUT_DIRECTORY`."
msgstr "将 :command:`enable_s3_jpeg_output` 变量设置为 True 时,它允许在边缘设备上存储已处理的帧(jpeg 格式)。这些映像使用时间戳命名,并存储在由 :command:`PARAM_OUTPUT_DIRECTORY` 指定的目录中。"
#: ../../guides/stacks/greengrass.rst:391
msgid "References"
msgstr "参考"
#: ../../guides/stacks/greengrass.rst:393
msgid "AWS Greengrass: https://aws.amazon.com/greengrass/"
msgstr "AWS Greengrasshttps://aws.amazon.com/greengrass/"
#: ../../guides/stacks/greengrass.rst:394
msgid "AWS Lambda: https://aws.amazon.com/lambda/"
msgstr "AWS Lambdahttps://aws.amazon.com/lambda/"
#: ../../guides/stacks/greengrass.rst:395
msgid "AWS Kinesis: https://aws.amazon.com/kinesis/"
msgstr "AWS Kinesishttps://aws.amazon.com/kinesis/"
#~ msgid "This tutorial demonstrates how to:"
#~ msgstr "本教程演示了如何:"
#~ msgid "Refer to the following topics:"
#~ msgstr "请参阅以下主题:"
#~ msgid ""
#~ "Follow these instructions for `converting "
#~ "deep learning models to Intermediate "
#~ "Representation using Model Optimizer`_. To "
#~ "optimize either of the sample models "
#~ "described above, run one of the "
#~ "following commands."
#~ msgstr ""
#~ "按照 `converting deep learning models to"
#~ " Intermediate Representation using Model "
#~ "Optimizer`_ 中的说明执行操作。要优化上述任一示例模型,请运行以下命令之一。"
#~ msgid "Follow the instructions here to `view the output on IoT cloud`_."
#~ msgstr "按照这里的说明`view the output on IoT cloud`_。"
+144
View File
@@ -0,0 +1,144 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:15-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../index.rst:4
msgid "|CL-PRJ|"
msgstr "|CL-PRJ|"
#: ../../index.rst:6
msgid ""
"Welcome to the |CL-ATTR| documentation pages, the source for |CL| "
"documentation."
msgstr "欢迎来到 |CL-ATTR| 文档页面,这是 |CL| 文档的资料来源。"
#: ../../index.rst:8
msgid "Our documentation is divided into the following sections:"
msgstr "我们的文档分为以下几个部分:"
#: ../../index.rst:11
msgid ":ref:`get-started`"
msgstr ":ref:`get-started`"
#: ../../index.rst:13
msgid ""
"If you are new to |CL|, get started quickly with step-by-step "
"instructions for installing |CL| on bare metal, in a virtual environment,"
" or as a live image on a USB stick."
msgstr "如果您刚开始使用 |CL|,请按照详细的步骤说明来快速将 |CL| 安装在裸机上、安装在虚拟环境中或将 Clear Linux OS 实时映像烧录至 U 盘。"
#: ../../index.rst:17
msgid ":ref:`about`"
msgstr ":ref:`about`"
#: ../../index.rst:19
msgid "|CL| is different from other Linux distributions."
msgstr "|CL| 与其他的 Linux 分发版不同。"
#: ../../index.rst:21
msgid ""
"Updates, ease of use, and custom derivatives are a few of the differences"
" this section explains. Orient yourself to these differences and why they"
" matter to you."
msgstr "本页面将解释更新、易用性和自定义衍生工具的一些区别。您可了解这些差异以及其重要性。"
#: ../../index.rst:29
msgid ":ref:`guides`"
msgstr ":ref:`guides`"
#: ../../index.rst:31
msgid ""
"Guides cover a range of topics from |CL| features and tooling, to system "
"maintenance, network, and stacks."
msgstr "指南页面涵盖了从 |CL| 功能和工具到系统维护、网络和堆栈的一系列主题。"
#: ../../index.rst:34
msgid ":ref:`Use case tutorials <tutorials>`"
msgstr ":ref:`Use case tutorials <tutorials>`"
#: ../../index.rst:36
msgid ""
"Sample use cases, with step-by-step instructions, show how to set up "
"third-party tools and software with |CL|."
msgstr "通过分步说明的示例用例,来介绍如何使用 |CL| 设置第三方工具和软件。"
#: ../../index.rst:39
msgid ":ref:`reference`"
msgstr ":ref:`reference`"
#: ../../index.rst:41
msgid ""
"This section provides additional reference information on the |CL| "
"project."
msgstr "本页面提供了有关 |CL| Project 的其他参考信息。"
#: ../../index.rst:43
msgid ":ref:`faq`"
msgstr ":ref:`faq`"
#: ../../index.rst:45
msgid "The FAQ section provides answers to commonly asked questions about |CL|."
msgstr "FAQ 页面提供了有关 |CL| 的常见问题与解答。"
#~ msgid ""
#~ "If you are new to |CL|, get "
#~ "started fast with tutorials for "
#~ "installing |CL| on bare metal, in "
#~ "a virtual environment, or as a "
#~ "live image on a USB stick."
#~ msgstr ""
#~ msgid ":ref:`tooling`"
#~ msgstr ""
#~ msgid ""
#~ "Clear Linux is a little different "
#~ "from other distros. Here are some "
#~ "important tools and concept for managing"
#~ " your install."
#~ msgstr ""
#~ msgid ""
#~ "Guides show how to complete common "
#~ "tasks that help you leverage |CL| "
#~ "native features effectively. From basic "
#~ "system configuration to advanced management"
#~ " of a cloud installation, there is"
#~ " a guide for you."
#~ msgstr ""
#~ msgid ":ref:`tutorials`"
#~ msgstr ""
#~ msgid ""
#~ "|CL| tutorials provide step-by-step "
#~ "instructions on how |CL| features can"
#~ " be used and extended, frequently "
#~ "with third-party tools."
#~ msgstr ""
#~ msgid ""
#~ "Find the detailed information you need"
#~ " to enable your configuration or task"
#~ " in our |CL| reference section."
#~ msgstr ""
#~ msgid "Refer to our FAQ section to read commonly asked questions and answers."
#~ msgstr ""
@@ -0,0 +1,47 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-08-21 11:09-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: zh-Hans\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
"Language: zh-Hans\n"
#: ../../reference/bundles/bundles.rst:4
msgid "Available bundles"
msgstr "可用的捆绑包"
#: ../../reference/bundles/bundles.rst:6
msgid ""
"This document provides a current list of available bundles. View the "
"`clr-bundles repo`_ on GitHub\\*, or select the bundle :file:`Name` for "
"more details."
msgstr "本文档提供了可用捆绑包的当前列表。有关更多详细信息,请查看 GitHub\\* 上的 `clr-bundles repo`_,或者选择 :file:`Name` 捆绑包。"
#: ../../reference/bundles/bundles.rst:9
msgid ""
"To learn more about how |CL-ATTR| uses bundles for software deployment, "
"visit :ref:`bundles-guide`."
msgstr "要了解有关 |CL-ATTR| 如何使用捆绑包进行软件部署的更多信息,请参见 :ref:`bundles-guide`。"
#: ../../reference/bundles/bundles.rst:13
msgid "Bundle list"
msgstr "捆绑包列表"
#~ msgid ""
#~ "To learn more about how |CL-ATTR|"
#~ " uses bundles for software deployment, "
#~ "visit :ref:`bundles-about`."
#~ msgstr ""
@@ -0,0 +1,161 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../reference/collaboration/collaboration.rst:4
msgid "Documentation guidelines"
msgstr ""
#: ../../reference/collaboration/collaboration.rst:6
msgid ""
"See a missing topic in the documentation? Find an existing document that "
"could be improved? Help us out by contributing! If you haven't "
"contributed before, take a moment to review our `Contribution "
"guidelines`_."
msgstr ""
#: ../../reference/collaboration/collaboration.rst:10
msgid ""
"Do you have questions about the documentation that were not answered by "
"these guidelines? Send your question to the `mailing list`_."
msgstr ""
#: ../../reference/collaboration/collaboration.rst:14
msgid "Contribution guidelines"
msgstr ""
#: ../../reference/collaboration/collaboration.rst:16
msgid ""
"The |CL| documentation is hosted in GitHub and is written using "
"reStructuredText. Use our guidelines and best practices to write "
"consistent, readable documentation."
msgstr ""
#: ../../reference/collaboration/collaboration.rst:27
msgid "How to contribute"
msgstr ""
#: ../../reference/collaboration/collaboration.rst:29
msgid "There are multiple ways to contribute and help improve our documentation:"
msgstr ""
#: ../../reference/collaboration/collaboration.rst:31
msgid ""
"**Make a suggestion**: Have a documentation suggestion but no time to "
"write it yourself? Send your suggestion to the `mailing list`_."
msgstr ""
#: ../../reference/collaboration/collaboration.rst:33
msgid ""
"**Log an issue**: If you find a problem in our documentation (such as "
"typos or out-of-date information), log an issue in the `documentation "
"repository`_."
msgstr ""
#: ../../reference/collaboration/collaboration.rst:35
msgid ""
"**Contribute directly via GitHub**: Whether you've found a typo, have "
"better instructions or examples, or have a new page to add, submit your "
"improvement or addition as a pull request on the `documentation "
"repository`_."
msgstr ""
#: ../../reference/collaboration/collaboration.rst:38
msgid ""
"**Test documentation**: Step through our instructional guides and "
"tutorials to verify the instructions. Log or correct any out-of-date "
"information."
msgstr ""
#: ../../reference/collaboration/collaboration.rst:41
msgid "All contributions must follow our `code of conduct`_."
msgstr ""
#: ../../reference/collaboration/collaboration.rst:44
msgid "Contribute via GitHub"
msgstr ""
#: ../../reference/collaboration/collaboration.rst:46
msgid ""
"Our documentation is hosted in GitHub and we follow the standard `GitHub "
"flow`_:"
msgstr ""
#: ../../reference/collaboration/collaboration.rst:48
msgid "Clone the `documentation repository`_."
msgstr ""
#: ../../reference/collaboration/collaboration.rst:50
msgid "Create your own fork of the repository."
msgstr ""
#: ../../reference/collaboration/collaboration.rst:52
msgid "Create a branch for your contribution."
msgstr ""
#: ../../reference/collaboration/collaboration.rst:54
msgid "Add your commits."
msgstr ""
#: ../../reference/collaboration/collaboration.rst:56
msgid "Open a pull request."
msgstr ""
#: ../../reference/collaboration/collaboration.rst:58
msgid "Discuss, review, and update your contributions."
msgstr ""
#: ../../reference/collaboration/collaboration.rst:60
msgid ""
"Once the maintainer approves, your contribution is merged and published "
"as part of the documentation."
msgstr ""
#: ../../reference/collaboration/collaboration.rst:66
msgid "References"
msgstr ""
#: ../../reference/collaboration/collaboration.rst:68
msgid ""
"We use the following references to guide the grammar, style, and "
"formatting of our documentation:"
msgstr ""
#: ../../reference/collaboration/collaboration.rst:71
msgid "`Microsoft Writing Style Guide`_"
msgstr ""
#: ../../reference/collaboration/collaboration.rst:72
msgid "`Merriam-Webster Dictionary`_"
msgstr ""
#: ../../reference/collaboration/collaboration.rst:73
msgid ""
"The Chicago Manual of Style (15th edition), The University of Chicago "
"Press"
msgstr ""
#: ../../reference/collaboration/collaboration.rst:74
msgid "Microsoft Press Computer Dictionary, Microsoft Press"
msgstr ""
#: ../../reference/collaboration/collaboration.rst:75
msgid "Read Me First!, Oracle Technical Publications"
msgstr ""
@@ -0,0 +1,890 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../reference/collaboration/structure-formatting.rst:4
msgid "Structure and formatting"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:6
msgid ""
"Content should be organized to support scanning. Consistent organization,"
" formatting, and writing style helps readers quickly find what they need "
"and to understand the content more effectively. This document describes "
"our organization and formatting guidelines."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:11
msgid ""
"Refer to :ref:`writing-guide` to learn how we keep our documents clear "
"and concise."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:18
msgid "Markup"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:20
msgid ""
"Our documentation is written in the reStructuredText markup language, "
"using Sphinx roles and directives. We use Sphinx to generate the final "
"documentation. You can read more about reStructuredText and Sphinx on "
"their respective websites:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:25
msgid "`Sphinx documentation`_"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:26
msgid "`reStructuredText Primer`_"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:28
msgid ""
"You can view the content directly in the .rst markup files, or generate "
"the HTML content by installing and building the documentation locally. To"
" run the documentation locally, follow the instructions found in the "
"`documentation repository`_ README."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:34
msgid "New pages"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:36
msgid ""
"There are a few additional steps to consider when adding a new page to "
"the documentation. First, identify where your new page should be located "
"within the existing `Documentation organization`_. Second, make sure the "
"new page is picked up in the Sphinx build and easily linkable from other "
"content."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:41
msgid ""
"Each page must be included in a `Sphinx toctree`_ in order to be included"
" in the documentation content tree. Typically, pages are added to the "
"section landing page toctree."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:45
msgid "For example, the :ref:`collaboration` page toctree looks like:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:55
msgid ""
"Additionally, each page must include a uniquely named reST label directly"
" before the page title, to enable the `Sphinx ref role`_ for linking to a"
" page."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:58
msgid ""
"For example, this page \"Structure and formating\" has the label ``.. "
"_structure-formatting``:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:68
msgid ""
"This page can then be referenced from other pages in the documentation "
"using the `:ref:` role:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:76
msgid "Documentation organization"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:78
msgid "The documentation is organized into five general sections:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:80
msgid ""
"**Concepts**: Introduction and overview of |CL| specific concepts or "
"features."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:82
msgid "**Get started**: Information about getting started with |CL|."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:83
msgid "**Guides**: Detailed information and instruction on using |CL| features."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:84
msgid ""
"**Tutorials**: Step-by-step instruction for using |CL| in specific use "
"cases."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:85
msgid "**Reference**: Supplementary and reference information for |CL|."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:88
msgid "Page structure"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:90
msgid "Each page in the documentation should follow the basic format of:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:92
msgid "Overview: 1-2 sentences describing what this page shows and why it matters"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:93
msgid ""
"Prerequisites: Describe any pre-work necessary to the content (if "
"appropriate)"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:94
msgid "Content"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:95
msgid "Next steps: List links to next steps (if appropriate)"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:96
msgid "Related topics: List links to related content (if appropriate)"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:99
msgid "Headings"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:101
msgid ""
"Use headings to section and organize your content for better readability "
"and clarity."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:104
msgid "All files must have a top level heading, which is the title for the page."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:105
msgid ""
"Up to three additional levels of headings are allowed under the title "
"heading."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:106
msgid ""
"Each heading should be followed by at least one paragraph of content. "
"Avoid two or more consecutive headings."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:109
msgid ""
"Refer to the :ref:`writing-guide` for tips on using headings to create "
":ref:`scannable content <scannable-content>`."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:112
msgid "To mark up headings in the .rst file:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:114
msgid "Use hash-tags to underline the file's main title:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:121
msgid "Use asterisks to underline the file's first level headings:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:128
msgid "Use equal signs to underline the file's second level of headings:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:135
msgid "Use dashes to underline the file's third level of headings:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:143
msgid "In-page navigation"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:145
msgid ""
"If a page has three or more sections, provide quick links to each "
"section. Place the quick links after the overview section."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:148
msgid "Use the standard `reST contents directive`_ with depth: 1 for quick links."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:151
msgid "Inline text formatting"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:153
msgid ""
"We use the `Microsoft Writing Style Guide`_ as our starting point for "
"text formatting. We apply the formatting using reST and Sphinx markup."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:156
msgid "Use our quick reference for the most commonly used inline text elements:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:159
msgid "**Element**"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:159
msgid "**Convention**"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:159
msgid "**reST/Sphinx**"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:161
msgid "Acronyms"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:161
msgid ""
"Define acronym when first used. After first use and definition, use the "
"acronym only."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:161
msgid "Use the ``:abbr:`` role, in the following format:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:164
msgid "``:abbr:`Acronym (Def)```"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:166
msgid "Bundle names"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:166
#: ../../reference/collaboration/structure-formatting.rst:174
#: ../../reference/collaboration/structure-formatting.rst:176
msgid "Bold"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:166
#: ../../reference/collaboration/structure-formatting.rst:174
#: ../../reference/collaboration/structure-formatting.rst:176
msgid "Use the ``:command:`` role."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:168
msgid "Callouts"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:168
msgid "Use ``.. note::``"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:170
msgid "Code/command examples"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:170
msgid ""
"Monospace, visually distinct from rest of text. Use an indented call-out "
"box."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:170
msgid "Use ``.. code-block::`` with the correct language setting."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:174
msgid "Commands"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:176
msgid "Command flags"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:178
msgid "Console output"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:178
msgid ""
"Monospace, visual distinction from rest of text. Use an indented call-out"
" box."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:178
msgid "Use ``.. code-block::`` with console as the language setting."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:182
msgid "Emphasis"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:182
msgid "Italic"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:182
msgid "``*strong*``"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:184
msgid "Environment variables"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:184
msgid "Use the case format of the environment variable."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:184
msgid "Use ``:envvar:``"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:187
msgid "Example commands with optional or replaceable parts"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:187
msgid "Use angle brackets for swapping in the specific name, e.g. <package-name>."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:191
msgid "Use square brackets for optional parts, e.g. [--build]."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:195
msgid "Example URLs (not linked)"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:195
msgid "Plain text"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:197
msgid "File extensions"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:197
msgid "Lowercase"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:199
msgid "File names, directories, paths"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:199
msgid "Title style capitalization"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:199
msgid "Use the ``:file:`` role."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:201
msgid "GUI labels"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:201
msgid "Use ``:guilabel:``"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:203
msgid "Inline comments"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:203
msgid "Use ``..``"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:205
msgid "Keystrokes"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:205
msgid "Use ``:kbd:``"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:207
msgid "Local navigation"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:207
msgid "``.. contents:: :local:`` with a depth of 1"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:210
msgid "Menu selection"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:210
msgid "Use ``:menuselection:``"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:212
msgid "New terms"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:212
msgid "Italic for first use, normal for all subsequent uses."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:215
msgid "If it is used outside of the source of definition, link the term."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:212
msgid "``*term*``"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:218
msgid "Product name"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:218
msgid "Follow correct trademark and attribution guidelines."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:221
msgid "Tool names"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:221
msgid "Correctly capitalized, no quotes, bold, or italics as the basic rule."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:224
msgid ""
"If the tool name is the command, like most Linux tools, treat it like a "
"command."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:228
msgid ""
"If the tool name is lowercase and used at the start of a sentence, use "
"bold."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:234
msgid "White space and line length"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:236
msgid ""
"Limit line length to 78 characters. The GitHub web interface forces this "
"limitation for readability."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:239
msgid "Remove trailing whitespace from your documents."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:242
msgid "Code blocks and examples"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:244
msgid ""
"When providing example code or commands use the `Sphinx code-block "
"directive`_. Select the appropriate syntax highlighting for the example "
"command or code."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:247
msgid "For example, if showing console output, use console highlighting:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:253
msgid "Sphinx provides other ways of `marking up example code`_ if needed."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:256
msgid "Lists and instructions"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:258
msgid ""
"Use a numbered list when the order or priority of the items is important,"
" such as step-by-step instructions."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:261
msgid "Use a bulleted list when the order of the items is not important."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:263
msgid ""
"For both list types, keep all items in the list parallel. See "
":ref:`parallelism`."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:266
msgid "Use standard `reST list markup`_."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:269
msgid "Numbered lists"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:271
msgid ""
"Numbered lists are most frequently used for procedures. Use numbered "
"lists to show sequence for the items. Follow our guidelines for numbered "
"lists:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:274
msgid "Make sure the list is sequential and not just a collection of items."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:275
msgid ""
"Introduce a numbered list with a sentence. End the setup text with a "
"colon. Example: \"To configure the unit, perform the following steps:\""
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:277
#: ../../reference/collaboration/structure-formatting.rst:299
msgid "Each item in the list should be parallel."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:278
msgid ""
"Treat numbered list items as full sentences with correct ending "
"punctuation."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:280
msgid ""
"You may interrupt numbered lists with other content, if relevant, e.g. "
"explanatory text, commands, or code."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:282
msgid "Second-level steps are acceptable; avoid third-level steps."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:283
msgid ""
"Avoid single-step procedures; the minimum number of steps in a procedure "
"is two."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:285
msgid ""
"Do not create numbered lists that emulate flowcharts. The reader should "
"be able to execute the list of steps from first to last without branching"
" or looping."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:288
msgid ""
"Avoid over-using numbered lists, except in procedural documents such as "
"tutorials and step-by-step guides."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:292
msgid "Bulleted lists"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:294
msgid ""
"Use bulleted lists to reduce wordiness and paragraph density, especially "
"when a sequence is not required. Here are some guidelines for bulleted "
"lists:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:297
msgid ""
"Introduce a bulleted list with a sentence. End the setup text with a "
"colon. Example: \"To repair the unit, you will need the following "
"items:\""
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:300
msgid "Avoid interrupting bulleted lists with other paragraph styles."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:301
msgid "Second-level bullets are acceptable; avoid third-level bullets."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:303
msgid ""
"Use the correct ending punctuation for sentence style bullet lists. For "
"example:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:305
msgid "**Use this:**"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:315
msgid "**Not this:**"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:327
msgid "Instructions"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:329
msgid ""
"When presenting instructions, such as in a tutorial, present them in a "
"numbered list according to these guidelines:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:332
msgid "Each step (list item) should describe one action."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:334
msgid ""
"If the same steps are repeated, refer to the earlier steps rather than "
"repeating them."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:337
msgid ""
"When a step includes a command or code block as an example, put the "
"command or code block after the step that includes them."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:340
msgid ""
"Use supporting images where appropriate. If the series of steps is "
"supported by one figure, refer to the figure in the introductory text."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:343
msgid "For example: \"See Figure 15 and do the following:\""
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:345
msgid ""
"When a series of steps is supported by two or more figures, refer to the "
"specific figure in the relevant step and show the figure immediately "
"after the reference. **Do not write**: \"See figures 15 through 22 and do"
" the following:\""
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:351
msgid "Notices"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:353
msgid ""
"We use four special types of notices: notes, cautions, warnings, and "
"dangers. Here are some specific rules and tips regarding use of these "
"notices:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:356
msgid ""
"Do not use a notice directly after a heading. Notices must follow a "
"variant of body text."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:358
msgid "Do not include more than one notice in a single notice block."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:359
msgid "Avoid back-to-back notices."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:360
msgid ""
"If back-to-back notices are not avoidable, make sure each distinct notice"
" in the notice block is clearly defined."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:363
msgid "Use the standard `reST admonition directive`_."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:366
msgid "Notes, cautions, and warnings"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:368
msgid ""
"Use notes sparingly. Avoid having more than one note per section. If you "
"exceed this number consistently, consider rewriting the notes as main "
"body text."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:371
msgid ""
"Use cautions and warnings to alert readers of potential problems or "
"pitfalls. Use conditional phrases in cautions and warnings, such as \"If "
"you do X, then Y will occur.\""
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:375
msgid "These are examples of typical notices and the conditions for their usage:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:378
msgid ""
"Notes are extra bits of information that supplement the main content. "
"Notes should be relatively short."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:382
msgid ""
"Cautions are low-level hazard messages that alert the user of possible "
"equipment, product, and software damage, including loss of data."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:386
msgid "Warnings are mid-level hazards that are likely to cause product damage."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:389
msgid "Links"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:391
msgid "Use the standard `reST markup for links`_."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:393
msgid ""
"To add a cross-reference to another documentation page, use the `:ref:` "
"role:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:399
msgid ""
"To add an external link, we use named references that refer to a defined "
"link/label at the bottom of the page."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:402
msgid ""
"For example, an external link is defined at the bottom of the page like "
"this:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:408
msgid "The defined link is then used in the content like this:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:415
msgid "Images"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:417
msgid ""
"Use images or figures to convey information that may be difficult to "
"explain using words alone. Well-planned graphics reduce the amount of "
"text required to explain a topic or example."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:421
msgid ""
"Follow these guidelines when using graphics in support of your "
"documentation:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:423
msgid ""
"Keep it simple. Use images that serve a specific purpose in your "
"document, and contain only the information the reader needs."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:426
msgid ""
"Avoid graphics that will need frequent updating. Don't include "
"information in a graphic that might change with each release, such as "
"product versions."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:429
msgid ""
"Use either PNG or JPEG bitmap files for screenshots and SVG files for "
"vector graphics."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:432
msgid ""
"Place the image immediately after the text it helps clarify, or as close "
"as possible."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:435
msgid ""
"Use the `Sphinx figure directive`_ to insert images and figures into the "
"document. Include both alt text, a figure name, and caption."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:438
msgid "For example:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:447
msgid ""
"Include at least one direct reference to an image from the main text, "
"using the figure number. For example:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:450
msgid "**Use this:** ::"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:454
msgid "**Not this:** ::"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:458
msgid "Images should follow these naming and location conventions:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:460
msgid ""
"Save the image files in a :file:`figures` folder at the same level as the"
" file that will reference the image."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:462
msgid "Name image files according to the following rules:"
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:464
msgid "Use only lower case letters."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:465
msgid "Separate multiple words in filenames using dashes."
msgstr ""
#: ../../reference/collaboration/structure-formatting.rst:466
msgid ""
"Name images using the filename of the file they appear on and add a "
"number to indicate their place in the file. For example, the third figure"
" added to the :file:`welcome.rst` file must be named "
":file:`welcome-3.png`."
msgstr ""
@@ -0,0 +1,689 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../reference/collaboration/writing-guide.rst:4
msgid "Writing guide"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:6
msgid ""
"We want our documentation to be easy to read and understand. This "
"document describes guidelines for writing documentation that is clear, "
"concise, confident, and courteous."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:10
msgid ""
"Refer to :ref:`structure-formatting` for details on organizing content "
"and how we use reStructuredText and Sphinx."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:17
msgid "Use simple English"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:19
msgid ""
"Write using simple English: Be brief and communicate only the information"
" that is needed. Be friendly and informative. Emphasize clarity and avoid"
" unecessary complicated or technical terms. Make the content accessible "
"to non-native speakers."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:25
msgid "Be brief"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:27
msgid ""
"Use short sentences and paragraphs. Stick to the principle of one main "
"idea per sentence, plus one additional point if needed. Each paragraph "
"should address one main idea. Remember the basic structure of a "
"paragraph: Introduction, body, and conclusion."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:33
msgid "Be friendly"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:35
msgid ""
"We write for our peers and want to be familiar. Take a personal tone as "
"if you were speaking directly to the reader. Use \"you\" to address the "
"reader and \"we\" to refer to our view. Be professional, respectful, and "
"cooperative."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:39
msgid ""
"Assume your audience has the same level of technical understanding and "
"expertise as you did when you first started collaborating. Do not talk "
"down to our readers, but also do not assume they know everything about "
"the subject. Offer brief explanations or summaries of common knowledge if"
" a significant portion of readers might benefit."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:46
msgid "Use simple words"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:48
msgid ""
"Use simple words to increase reader comprehension and reduce ambiguity. "
"Follow our tips for making good word choices:"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:51
msgid ""
"**Avoid jargon**: Write for your audience, using everyday language where "
"possible, and technical terms where appropriate. Avoid clichés, idioms, "
"and metaphors."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:54
msgid ""
"**Be consistent**: Use one term for each concept or action and use it "
"consistently."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:56
msgid ""
"**Avoid \"fancy\" words and phrases**: If there is a simpler word or "
"phrase, use it."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:59
#: ../../reference/collaboration/writing-guide.rst:151
#: ../../reference/collaboration/writing-guide.rst:202
#: ../../reference/collaboration/writing-guide.rst:213
#: ../../reference/collaboration/writing-guide.rst:258
#: ../../reference/collaboration/writing-guide.rst:368
msgid "For example:"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:62
msgid "Use this"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:62
msgid "Not this"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:64
msgid "start, begin"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:64
msgid "commence"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:65
msgid "so"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:65
msgid "consequently"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:66
msgid "more than"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:66
msgid "in excess of"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:67
msgid "if"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:67
msgid "in the event of"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:68
msgid "before"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:68
msgid "prior to"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:69
msgid "if you want"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:69
msgid "should one wish"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:70
msgid "use"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:70
msgid "utilize"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:71
msgid "example"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:71
msgid "instance"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:75
msgid "Avoid overuse of product name"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:77
msgid ""
"Use product names only when necessary. Typically, you can rewrite "
"sentences to remove the product name with no change in meaning, which "
"keeps the content concise and scannable."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:81
msgid "Avoid using the product name in page titles and headings."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:86
msgid "Make content scannable"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:88
msgid ""
"Organize your content to make it scannable for the reader, which helps "
"them find what they need quickly, and to understand the information more "
"efficiently."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:91
msgid ""
"**Put the most important content first.** Make sure your introduction "
"clearly communicates what the reader can find on the page. Present the "
"point of the document first, and organize supporting information towards "
"the end of the page."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:95
msgid ""
"**Write scannable headings.** Expect readers of documentation to skim and"
" scan the content, and to leave if they dont find what they need quickly."
" Good headings add organization to your content and help the reader to "
"find and understand content more effectively. Follow our guidelines for "
"writing effective `Headings`_."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:100
msgid ""
"**Write great link text.** Great link text tells the reader what they can"
" expect when they click on a link. It also helps make the page more "
"scannable. Follow our guidelines for writing `Link text`_."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:105
msgid "Headings"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:107
msgid "Use these guidelines to write effective headings:"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:109
msgid ""
"**Be concise and descriptive.** Use only the words necessary to describe "
"the section."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:111
msgid ""
"**Use sentence case.** Capitalize only the first word and proper nouns in"
" a heading."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:113
msgid ""
"**Avoid punctuation.** Unless your heading is a question, don't use "
"sentence punctuation in headings."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:115
msgid ""
"**Use parallel structure.** Headings at the same level should use the "
"same grammatical pattern. This provides structure to the document and "
"helps users find information more easily. See :ref:`parallelism`."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:118
msgid ""
"**Use strong verbs.** Strong, active verbs get to the point. Avoid -ing "
"verbs, such as *Running*, *Testing*, etc."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:121
msgid "For example, two headings at the same level:"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:123
#: ../../reference/collaboration/writing-guide.rst:153
#: ../../reference/collaboration/writing-guide.rst:173
#: ../../reference/collaboration/writing-guide.rst:189
#: ../../reference/collaboration/writing-guide.rst:215
#: ../../reference/collaboration/writing-guide.rst:225
#: ../../reference/collaboration/writing-guide.rst:239
#: ../../reference/collaboration/writing-guide.rst:260
#: ../../reference/collaboration/writing-guide.rst:270
#: ../../reference/collaboration/writing-guide.rst:285
#: ../../reference/collaboration/writing-guide.rst:401
msgid "**Use this:** ::"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:129
#: ../../reference/collaboration/writing-guide.rst:157
#: ../../reference/collaboration/writing-guide.rst:177
#: ../../reference/collaboration/writing-guide.rst:193
#: ../../reference/collaboration/writing-guide.rst:219
#: ../../reference/collaboration/writing-guide.rst:229
#: ../../reference/collaboration/writing-guide.rst:243
#: ../../reference/collaboration/writing-guide.rst:264
#: ../../reference/collaboration/writing-guide.rst:274
#: ../../reference/collaboration/writing-guide.rst:289
#: ../../reference/collaboration/writing-guide.rst:405
msgid "**Not this:** ::"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:136
msgid "Link text"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:138
msgid "All links in content should follow these guidelines:"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:140
msgid ""
"**Write descriptive link text**: Link text should describe where the link"
" goes, without having to read the surrounding text."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:142
msgid ""
"**Keep link text concise**: Use only the words needed to accurately "
"describe the destination."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:144
msgid ""
"**Use unique link text**: Each link on a page should be unique. If users "
"see the same link text twice on a page, they'll assume it goes to the "
"same place."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:146
msgid ""
"**Start link text with keywords**: Frontload the link text with the most "
"important words to help users scan the text."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:148
msgid ""
"**Avoid generic text**: Don't use generic, uninformative link text such "
"as \"click here\" or \"read more\"."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:162
msgid "Use strong verbs"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:164
msgid ""
"Passive verbs make writing stuffy and formal. Use strong verbs to get to "
"the point and avoid unnecessary words and phrases."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:168
msgid "Use imperatives"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:170
msgid ""
"Commands, also called imperatives, are the fastest and most direct way of"
" giving someone instructions. For example:"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:182
msgid "Use present tense"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:184
msgid ""
"Use simple present tense instead of future tense for most text. Search "
"for the words \"will\" or \"shall\" to find future tense instances. "
"Future tense is acceptable for conditional statements, such as in a "
"caution or a warning. For example:"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:198
msgid "Avoid nominalizations"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:200
msgid "Avoid nominalizations, which are nouns formed from verbs."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:205
msgid "Verb"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:205
msgid "Nominalization"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:207
msgid "complete"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:207
msgid "completion"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:208
msgid "provide"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:208
msgid "provision"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:209
msgid "fail"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:209
msgid "failure"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:210
msgid "install"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:210
msgid "installation"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:223
#: ../../reference/collaboration/writing-guide.rst:268
msgid "Or:"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:234
msgid "Avoid words ending in -ing"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:236
msgid ""
"Avoid using words ending in -ing unless they are part of a technical "
"name. For example:"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:248
msgid "Use the active voice"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:250
msgid ""
"Use active voice whenever possible to show who or what is performing an "
"action."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:253
msgid ""
"Active voice follows standard English word order: SUBJECTVERBOBJECT "
"(where the OBJECT is optional)."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:255
msgid ""
"Passive voice reverses the order and weakens the verb: OBJECTbe VERBby "
"SUBJECT (where the OBJECT is optional)."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:279
msgid "Avoid long noun phrases"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:281
msgid ""
"Noun phrases (a noun and other words that describe or modify it) can be "
"difficult to understand. Try to limit the number of modifiers in a noun "
"phrase to two. For example:"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:296
msgid "Parallelism"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:298
msgid ""
"Parallelism refers to the practice of using similar patterns of grammar, "
"and sometimes length, to coordinate words, phrases, and clauses."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:301
msgid ""
"Use parallel construction in lists. The table below shows some unparallel"
" structures and how they can be made parallel with a little rewording."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:305
msgid "Parallel (do)"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:305
msgid "Unparallel (don't)"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:307
msgid "Mount the panel."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:308
msgid "Install the battery."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:309
msgid "Wire the keypad."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:308
msgid "Battery installation."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:309
msgid "Wiring the keypad."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:311
msgid ""
"I like practicing my accordion, reading sci-fi, and eating peanut butter "
"and pickle sandwiches."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:311
msgid ""
"I like practicing my accordion, reading sci-fi, and to eat peanut butter "
"and pickle sandwiches."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:316
msgid "For breakfast he likes coffee and bacon."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:316
msgid "For breakfast he likes coffee and to fry bacon."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:319
msgid "Apples or bananas are a good snack."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:319
msgid "Apples or a banana are a good snack."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:324
msgid "Grammar and punctuation"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:326
msgid ""
"This section covers common grammatical topics relevant to our "
"documentation. For detailed explanations of correct grammar and "
"punctuation, use one of our :ref:`preferred references <references>`."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:331
msgid "Capitalization"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:333
msgid ""
"The capitalization style for all documentation is sentence case. Words "
"should only be capitalized when they are proper nouns or refer to "
"trademarked product names."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:338
msgid ""
"Do not capitalize a word to indicate it is more important than other "
"words. Never change the case of variable, function or file names - always"
" keep the original case."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:343
msgid "Menu capitalization"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:345
msgid ""
"When referring to software menu items by name, use the same "
"capitalization as seen in the actual menu."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:348
msgid "A few other tips when referring to menu items:"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:350
msgid ""
"Reference the specific menu item using \"Select :menuselection:`File --> "
"New`.\""
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:352
msgid ""
"Put the option to be selected last. \"Select :menuselection:`View --> "
"Side Bar --> Hide Side Bar`\""
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:355
msgid ""
"Do not include more than 3 navigation steps in a menu selection. If more "
"than three steps are needed, divide the steps using ``:guilabel:`` or "
"``:menuselection:``."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:359
msgid ""
"For example: \"Go to :guilabel:`File` and select :menuselection:`Print "
"--> Print Preview --> Set Up`.\""
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:363
msgid "Software version capitalization"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:365
msgid ""
"When listing software or hardware version numbers, the word “version” or "
"letter \"v\" are lowercase. The v is closed with the number (no period)."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:370
msgid "Widget Pro version 5.0"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:371
msgid "Widget Master v2.1.12"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:374
msgid "Contractions"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:376
msgid ""
"Avoid using contractions, such as it's, they're, and you're, because they"
" may be unclear to non-native English-speaking audiences."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:380
msgid "Quotation marks"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:382
msgid "Follow these guidelines for quotation marks:"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:384
msgid "Restrict use of quotation marks to terms as terms."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:385
msgid "Do not use quotation marks for emphasis; use *italics* for emphasis."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:386
msgid "Avoid using single-quote marks."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:389
msgid "Commas and colons"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:391
msgid ""
"This section addresses common use of commas, semicolons, and colons in "
"our documentation. Refer to one of our :ref:`preferred references "
"<references>` for further details."
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:396
msgid "Use the serial comma"
msgstr ""
#: ../../reference/collaboration/writing-guide.rst:398
msgid ""
"When writing a series of items, use the serial comma before the final "
"*and* and *or* to avoid confusion and ambiguity. For example:"
msgstr ""
@@ -0,0 +1,262 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../reference/compatible-hardware.rst:4
msgid "Compatible Hardware"
msgstr ""
#: ../../reference/compatible-hardware.rst:6
msgid ""
"This document describes hardware that has been tested and confirmed as "
"compatible with |CL-ATTR|. This list is not comprehensive and will "
"continue to grow."
msgstr ""
#: ../../reference/compatible-hardware.rst:10
msgid "**Table 1. Compatible Hardware**"
msgstr ""
#: ../../reference/compatible-hardware.rst:14
msgid "Processor SKU"
msgstr ""
#: ../../reference/compatible-hardware.rst:15
msgid "Platform"
msgstr ""
#: ../../reference/compatible-hardware.rst:17
#: ../../reference/compatible-hardware.rst:98
#: ../../reference/compatible-hardware.rst:110
msgid "Intel® Core™ i5-6260U"
msgstr ""
#: ../../reference/compatible-hardware.rst:20
msgid "Intel® Core™ i5-6560U"
msgstr ""
#: ../../reference/compatible-hardware.rst:21
msgid "Dell XPS\\* 13 9350"
msgstr ""
#: ../../reference/compatible-hardware.rst:23
#: ../../reference/compatible-hardware.rst:92
msgid "Intel® Celeron® J3455"
msgstr ""
#: ../../reference/compatible-hardware.rst:24
msgid "NUC6CAYS"
msgstr ""
#: ../../reference/compatible-hardware.rst:26
#: ../../reference/compatible-hardware.rst:65
msgid "Intel® Core™ i5-4250U"
msgstr ""
#: ../../reference/compatible-hardware.rst:29
#: ../../reference/compatible-hardware.rst:101
#: ../../reference/compatible-hardware.rst:107
msgid "Intel® Core™ i7-5557U"
msgstr ""
#: ../../reference/compatible-hardware.rst:32
msgid "Intel® Core™ i9-7900X"
msgstr ""
#: ../../reference/compatible-hardware.rst:33
msgid "Gigabyte\\* X299"
msgstr ""
#: ../../reference/compatible-hardware.rst:35
msgid "Intel® Core™ i3-4130"
msgstr ""
#: ../../reference/compatible-hardware.rst:36
msgid "Lenovo Thinkserver\\* TS140"
msgstr ""
#: ../../reference/compatible-hardware.rst:38
msgid "Intel® Core™ i7-7567U"
msgstr ""
#: ../../reference/compatible-hardware.rst:39
msgid "NUC7i7BNH"
msgstr ""
#: ../../reference/compatible-hardware.rst:41
msgid "Intel® Core™ i7-8809G"
msgstr ""
#: ../../reference/compatible-hardware.rst:42
msgid "NUC8i7HVK"
msgstr ""
#: ../../reference/compatible-hardware.rst:44
msgid "Intel® Core™ i5-7260U"
msgstr ""
#: ../../reference/compatible-hardware.rst:45
msgid "NUC7i5BNH"
msgstr ""
#: ../../reference/compatible-hardware.rst:47
msgid "Intel® Core™ i7-8650U"
msgstr ""
#: ../../reference/compatible-hardware.rst:48
msgid "NUC7i7DNKE"
msgstr ""
#: ../../reference/compatible-hardware.rst:50
msgid "Intel® Core™ i5-7300U"
msgstr ""
#: ../../reference/compatible-hardware.rst:51
msgid "NUC7i5DNHE"
msgstr ""
#: ../../reference/compatible-hardware.rst:53
msgid "Intel® Xeon® Gold 6138"
msgstr ""
#: ../../reference/compatible-hardware.rst:56
msgid "Intel® Xeon® E5-2699A v4"
msgstr ""
#: ../../reference/compatible-hardware.rst:57
msgid "Dell PowerEdge\\* R630"
msgstr ""
#: ../../reference/compatible-hardware.rst:59
msgid "Intel® Xeon® E5-2620 v3"
msgstr ""
#: ../../reference/compatible-hardware.rst:62
msgid "Intel® Core™ i5-6600"
msgstr ""
#: ../../reference/compatible-hardware.rst:63
msgid "Gigabyte\\* Z170X-UD5"
msgstr ""
#: ../../reference/compatible-hardware.rst:66
msgid "D54250WYK"
msgstr ""
#: ../../reference/compatible-hardware.rst:68
msgid "Intel® Xeon® E5-2699 v3"
msgstr ""
#: ../../reference/compatible-hardware.rst:69
msgid "S2600WT2"
msgstr ""
#: ../../reference/compatible-hardware.rst:71
msgid "Intel® Atom™ J3455"
msgstr ""
#: ../../reference/compatible-hardware.rst:72
#: ../../reference/compatible-hardware.rst:93
msgid "NUC6CAYB"
msgstr ""
#: ../../reference/compatible-hardware.rst:74
msgid "Intel® Xeon® Bronze 3104"
msgstr ""
#: ../../reference/compatible-hardware.rst:75
msgid "0W23H8"
msgstr ""
#: ../../reference/compatible-hardware.rst:77
msgid "Intel® Atom™ C2750"
msgstr ""
#: ../../reference/compatible-hardware.rst:78
msgid "SuperMicro\\* A1SAi"
msgstr ""
#: ../../reference/compatible-hardware.rst:80
msgid "Intel® Atom™ E3825"
msgstr ""
#: ../../reference/compatible-hardware.rst:81
msgid "CircuitCo MinnowBoard MAX\\*"
msgstr ""
#: ../../reference/compatible-hardware.rst:83
msgid "Intel® Core™ i7-8700"
msgstr ""
#: ../../reference/compatible-hardware.rst:84
msgid "Gigabyte\\* H370 WIFI"
msgstr ""
#: ../../reference/compatible-hardware.rst:86
msgid "Intel® Core™ i7-3667U"
msgstr ""
#: ../../reference/compatible-hardware.rst:87
msgid "Lenovo ThinkPad\\* X1 Carbon laptop"
msgstr ""
#: ../../reference/compatible-hardware.rst:89
msgid "Intel® Core™ i5-4210U"
msgstr ""
#: ../../reference/compatible-hardware.rst:90
msgid "Dell XPS\\* 13 laptop"
msgstr ""
#: ../../reference/compatible-hardware.rst:95
msgid "Intel® Core™ i7-4790"
msgstr ""
#: ../../reference/compatible-hardware.rst:96
msgid "Gigabyte\\* desktop"
msgstr ""
#: ../../reference/compatible-hardware.rst:99
msgid "NUC6I6SYH"
msgstr ""
#: ../../reference/compatible-hardware.rst:102
msgid "NUC5I7RYH"
msgstr ""
#: ../../reference/compatible-hardware.rst:104
msgid "Intel® Core™ i7-4700MQ"
msgstr ""
#: ../../reference/compatible-hardware.rst:105
msgid "Lenovo ThinkPad\\* T540p"
msgstr ""
#: ../../reference/compatible-hardware.rst:108
msgid "NUC5I7RYB"
msgstr ""
#: ../../reference/compatible-hardware.rst:111
msgid "NUC6I5SYH"
msgstr ""
#: ../../reference/compatible-hardware.rst:113
msgid "\\* Other names and brands may be claimed as the property of others."
msgstr ""
@@ -0,0 +1,191 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../reference/image-types.rst:4
msgid "|CL-ATTR| image types"
msgstr ""
#: ../../reference/image-types.rst:8
msgid ""
"|CL-ATTR| offers many types of `images`_ for different platforms and "
"environments."
msgstr ""
#: ../../reference/image-types.rst:12
msgid "The naming convention of a |CL| image filename is:"
msgstr ""
#: ../../reference/image-types.rst:18
msgid "The *[version number]* field specifies the version number."
msgstr ""
#: ../../reference/image-types.rst:20
msgid ""
"The *[image type]* field specifies the type of image and its "
"corresponding file format."
msgstr ""
#: ../../reference/image-types.rst:23
msgid ""
"The *[compression type]* field specifies the compression type. Two types "
"of compressions are used: GNU\\* zip (*.gz*) and XZ (*.xz*)."
msgstr ""
#: ../../reference/image-types.rst:28
msgid ""
"Table 1 lists the currently available images that are platform "
"independent. Table 2 lists the currently available images that are "
"platform specific."
msgstr ""
#: ../../reference/image-types.rst:31
msgid "Table 1: Types of platform-independent |CL| images"
msgstr ""
#: ../../reference/image-types.rst:35 ../../reference/image-types.rst:48
msgid "Image Type"
msgstr ""
#: ../../reference/image-types.rst:36 ../../reference/image-types.rst:49
msgid "Description"
msgstr ""
#: ../../reference/image-types.rst:38
msgid "live-desktop.img or live-desktop.iso"
msgstr ""
#: ../../reference/image-types.rst:39
msgid "Image for booting to GNOME\\* desktop to preview or install the OS."
msgstr ""
#: ../../reference/image-types.rst:41
msgid "live-server.img or live-server.iso"
msgstr ""
#: ../../reference/image-types.rst:42
msgid "Image for booting to server command prompt to preview or install the OS."
msgstr ""
#: ../../reference/image-types.rst:44
msgid "Table 2: Types of platform-specific |CL| images"
msgstr ""
#: ../../reference/image-types.rst:51
msgid "aws.img"
msgstr ""
#: ../../reference/image-types.rst:52
msgid "Image suitable for use with Amazon\\* AWS\\*."
msgstr ""
#: ../../reference/image-types.rst:54
msgid "azure.vhd"
msgstr ""
#: ../../reference/image-types.rst:55
msgid "Virtual Hard Disk for use on Microsoft\\* Azure\\* cloud platform."
msgstr ""
#: ../../reference/image-types.rst:57
msgid "azure-docker.vhd"
msgstr ""
#: ../../reference/image-types.rst:58
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with "
"Docker\\* pre-installed."
msgstr ""
#: ../../reference/image-types.rst:60
msgid "azure-machine-learning.vhd"
msgstr ""
#: ../../reference/image-types.rst:61
msgid ""
"Virtual Hard Disk for use on Microsoft Azure cloud platform with the "
"`machine-learning-basic` bundle installed."
msgstr ""
#: ../../reference/image-types.rst:63
msgid "cloudguest.img"
msgstr ""
#: ../../reference/image-types.rst:64
msgid ""
"Image with generic cloud guest virtual machine (VM) requirements "
"installed."
msgstr ""
#: ../../reference/image-types.rst:66
msgid "gce.tar"
msgstr ""
#: ../../reference/image-types.rst:67
msgid "Image with the Google Compute Engine (GCE) specific kernel."
msgstr ""
#: ../../reference/image-types.rst:69
msgid "hyperv.vhdx"
msgstr ""
#: ../../reference/image-types.rst:70
msgid ""
"Virtual Hard Disk for use with Microsoft Hyper-V\\* hypervisor. Includes "
"`optimized kernel`_ for Hyper-V."
msgstr ""
#: ../../reference/image-types.rst:72
msgid "kvm.img"
msgstr ""
#: ../../reference/image-types.rst:73
msgid ""
"Image for booting in a simple VM with start_qemu.sh. Includes `optimized "
"kernel`_ for KVM."
msgstr ""
#: ../../reference/image-types.rst:76
msgid "kvm-legacy.img"
msgstr ""
#: ../../reference/image-types.rst:77
msgid ""
"Image for booting in a simple VM using legacy BIOS, if using "
"start_qemu.sh make sure to remove -bios parameter."
msgstr ""
#: ../../reference/image-types.rst:79
msgid "pxe.tar"
msgstr ""
#: ../../reference/image-types.rst:80
msgid "Image suitable for use with PXE server."
msgstr ""
#: ../../reference/image-types.rst:82
msgid "vmware.vmdk"
msgstr ""
#: ../../reference/image-types.rst:83
msgid ""
"Virtual Machine Disk for VMware\\* platforms inclduing Player, "
"Workstation, and ESXi."
msgstr ""
@@ -0,0 +1,33 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../reference/index.rst:4
msgid "Reference"
msgstr ""
#: ../../reference/index.rst:6
msgid ""
"This section provides additional information on the |CL| project and "
"features."
msgstr ""
#~ msgid "Clear Linux concepts"
#~ msgstr ""
@@ -0,0 +1,284 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
msgid ""
msgstr "Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: 2019-09-04 16:21-0008\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh-Hans\n"
"Language-Team: zh-Hans\n"
"Plural-Forms: nplurals=2; plural=(n != 1)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Intel® International Developer Studio Version 4.1.273.0\n"
#: ../../reference/system-requirements.rst:4
msgid "Recommended minimum system requirements"
msgstr "建议的最低系统要求"
#: ../../reference/system-requirements.rst:6
msgid ""
"|CL-ATTR| can run on most modern hardware and is capable of running with "
"modest hardware resources. Out of the box, |CL| can run on a single CPU "
"core, 1 GB RAM, and 2 GB of disk space."
msgstr "|CL-ATTR| 可以在大多数现代硬件上运行,而且能够在占用最少硬件资源的情况下运行。默认情况下,|CL| 可以在单核 CPU、1 GB RAM 和 2 GB 硬盘空间配置下运行。"
#: ../../reference/system-requirements.rst:10
msgid ""
"For use cases requiring minimal resources, |CL| :ref:`about <about>` can "
"be used to create a highly customized installation that can even run on a"
" system with a 128MB of memory and 600MB of disk space, for example."
msgstr "对于需要最少资源的使用情况,可利用 |CL| :ref:`关于 <about>` 创建一个高度定制的安装,甚至可以在包含 128MB 内存和 600MB 磁盘空间的系统上运行。"
#: ../../reference/system-requirements.rst:16
msgid "Installer requirements"
msgstr "安装程序要求"
#: ../../reference/system-requirements.rst:18
msgid ""
"The *live desktop* installer requires at least 1 GB of RAM because more "
"resources are required to run in live mode than after |CL| is installed "
"onto persistent storage."
msgstr "*live desktop* 安装程序需要至少 1 GB 的 RAM,因为以实时模式运行比将 |CL| 安装在永久存储器上需要更多资源。"
#: ../../reference/system-requirements.rst:22
msgid ""
"For hardware with less resources, use the *live server* installer because"
" it has a smaller memory footprint."
msgstr "对于拥有资源较少的硬件,可以使用 *live server* 安装程序,因为占用内存空间更小。"
#: ../../reference/system-requirements.rst:25
msgid "See https://clearlinux.org/downloads for more download options."
msgstr "查看 https://clearlinux.org/downloads,获得更多下载选项。"
#: ../../reference/system-requirements.rst:29
msgid "System requirements"
msgstr "系统要求"
#: ../../reference/system-requirements.rst:31
msgid ""
"|CL| requires an x86 64-bit processor which supports Intel® Streaming "
"SIMD Extensions 4.1 (Intel® SSE 4.1), and it requires a system that "
"supports UEFI."
msgstr "|CL| 需要 x86 64 位处理器,支持 Intel® Streaming SIMD Extensions 4.1 (Intel® SSE 4.1),而且它要求采用支持 UEFI 的系统。"
#: ../../reference/system-requirements.rst:34
msgid ""
"The |CL| installer performs a system compatibility check upon booting. To"
" manually verify system compatibility with |CL|, run the "
":ref:`compatibility check tool<compatibility-check>` or go to "
"http://ark.intel.com and check for these features:"
msgstr "|CL| 安装程序在引导时执行系统兼容性检查。要手动确认 |CL| 的系统兼容性,需要运行 :ref:`检查兼容性的工具<compatibility-check>` 或转到 http://ark.intel.com 查看这些功能:"
#: ../../reference/system-requirements.rst:39
msgid "Instruction Set:"
msgstr "指令集:"
#: ../../reference/system-requirements.rst:41
msgid "64-bit"
msgstr "64 位"
#: ../../reference/system-requirements.rst:43
msgid "Instruction Set Extensions:"
msgstr "指令集扩展:"
#: ../../reference/system-requirements.rst:45
msgid "Supplemental Streaming SIMD Extension 3 (Intel® SSSE3)"
msgstr "Supplemental Streaming SIMD Extension 3 (Intel® SSSE3)"
#: ../../reference/system-requirements.rst:46
msgid "Intel® Streaming SIMD Extensions 4.1 (Intel® SSE 4.1)"
msgstr "Intel® Streaming SIMD Extensions 4.1 (Intel® SSE 4.1)"
#: ../../reference/system-requirements.rst:47
msgid "Intel® Streaming SIMD Extensions 4.2 (Intel® SSE 4.2)"
msgstr "Intel® Streaming SIMD Extensions 4.2 (Intel® SSE 4.2)"
#: ../../reference/system-requirements.rst:48
msgid "Intel® Advanced Encryption Standard New Instructions (Intel® AES-NI)"
msgstr "英特尔® 高级加密标准新指令(英特尔® AES-NI)"
#: ../../reference/system-requirements.rst:49
msgid "Carry-less Multiplication (PCLMUL)"
msgstr "Carry-less Multiplication (PCLMUL)"
#: ../../reference/system-requirements.rst:51
msgid "The following processor families have been verified to run |CL|:"
msgstr "下述处理器家族经过验证可以运行 |CL|:"
#: ../../reference/system-requirements.rst:53
msgid "Intel® Core™ Processor Family (2nd generation or greater)"
msgstr "英特尔® 酷睿™ 处理器家族(第二代以上)"
#: ../../reference/system-requirements.rst:54
msgid "Intel® Xeon® E3-xxxx processor"
msgstr "英特尔® 至强® E3-xxxx 处理器"
#: ../../reference/system-requirements.rst:55
msgid "Intel® Xeon® E5-xxxx processor"
msgstr "英特尔® 至强® E5-xxxx 处理器"
#: ../../reference/system-requirements.rst:56
msgid "Intel® Xeon® E7-xxxx processor"
msgstr "英特尔® 至强® E7-xxxx 处理器"
#: ../../reference/system-requirements.rst:57
msgid "Intel® Atom® processor C Series"
msgstr "英特尔 凌动® 处理器 C 系列"
#: ../../reference/system-requirements.rst:58
msgid "Intel® Atom® processor E Series"
msgstr "英特尔 凌动® 处理器 E 系列"
#: ../../reference/system-requirements.rst:62
msgid "Recommended configurations"
msgstr "建议配置"
#: ../../reference/system-requirements.rst:64
msgid "For general |CL| desktop use the recommended minimum requirements include:"
msgstr "对于一般 |CL| 桌面,使用建议的最低要求,包括:"
#: ../../reference/system-requirements.rst:67
msgid "Component"
msgstr "组件"
#: ../../reference/system-requirements.rst:67
msgid "Configuration"
msgstr "配置"
#: ../../reference/system-requirements.rst:69
msgid "Processor"
msgstr "处理器"
#: ../../reference/system-requirements.rst:69
msgid "Compatible x86 64-bit processor"
msgstr "兼容的 x86 64 位处理器"
#: ../../reference/system-requirements.rst:71
msgid "Memory"
msgstr "内存"
#: ../../reference/system-requirements.rst:71
msgid "4GB RAM"
msgstr "4 GB RAM"
#: ../../reference/system-requirements.rst:73
msgid "Disk"
msgstr "磁盘"
#: ../../reference/system-requirements.rst:73
msgid "20 GB"
msgstr "20 GB"
#: ../../reference/system-requirements.rst:75
msgid "Graphics"
msgstr "显卡"
#: ../../reference/system-requirements.rst:75
msgid "Device with openGL support (e.g. Intel HD/UHD Graphics)"
msgstr "支持 openGL 的设备(例如英特尔核芯显卡/超核芯显卡)"
#: ../../reference/system-requirements.rst:77
msgid "Network"
msgstr "网络"
#: ../../reference/system-requirements.rst:77
msgid "Active Internet connection"
msgstr "有效的互联网连接"
#~ msgid ""
#~ "|CL-ATTR| can run on very minimal"
#~ " hardware. For example, it can run"
#~ " on a system with a single core"
#~ " CPU, 128MB of memory, and 600MB "
#~ "of disk space."
#~ msgstr ""
#~ msgid ""
#~ "Different use cases and applications "
#~ "will require different configurations. For "
#~ "general |CL| use, in addition to a"
#~ " supported processor, the recommended "
#~ "minimum requirements include:"
#~ msgstr ""
#~ msgid "Processors:"
#~ msgstr ""
#~ msgid ""
#~ "|CL-ATTR| can run on any Intel®"
#~ " 64bit processors which support UEFI\\* "
#~ "and SSE\\* v4.1 streaming SIMD\\* "
#~ "instructions."
#~ msgstr ""
#~ msgid "2nd Generation, or later, Intel® Core™ processor family."
#~ msgstr ""
#~ msgid "Intel® Xeon® Processor E3"
#~ msgstr ""
#~ msgid "Intel® Xeon® Processor E5"
#~ msgstr ""
#~ msgid "Intel® Xeon® Processor E7"
#~ msgstr ""
#~ msgid ""
#~ "Intel® Atom™ processor C2000 product "
#~ "family for servers -- Q3 2013 "
#~ "version or later."
#~ msgstr ""
#~ msgid "Intel® Atom™ processor E3800 series -- Q4 2013 version or later."
#~ msgstr ""
#~ msgid ""
#~ "To help determine if a processor "
#~ "is supported, you can run a "
#~ ":ref:`compatibility check<compatibility-check>` or"
#~ " go to http://ark.intel.com and check "
#~ "for these features:"
#~ msgstr ""
#~ msgid "Instruction Set = 64-bit"
#~ msgstr ""
#~ msgid "Instruction Set Extensions = SSSE3"
#~ msgstr ""
#~ msgid "Instruction Set Extensions = SSE 4.1"
#~ msgstr ""
#~ msgid "Instruction Set Extensions = SSE 4.2"
#~ msgstr ""
#~ msgid "Instruction Set Extensions = AES"
#~ msgstr ""
#~ msgid "Instruction Set Extensions = PCLMUL"
#~ msgstr ""
#~ msgid "Memory: 4GB RAM"
#~ msgstr ""
#~ msgid "Hard Disk: 20GB HDD"
#~ msgstr ""
#~ msgid "Network: Active Internet connection"
#~ msgstr ""
#~ msgid "Graphics: Intel HD Graphics (required if running a GUI desktop)"
#~ msgstr ""
@@ -0,0 +1,248 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/apache-hadoop.rst:4
msgid "Apache\\* Hadoop\\*"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:6
msgid ""
"This tutorial walks you through the process of installing, configuring, "
"and running Apache Hadoop on |CL-ATTR|. The Apache Hadoop software "
"library is a framework for distributed processing of large data sets "
"across clusters of computers using simple programming models. It is "
"designed to scale up from single servers to thousands of machines, with "
"each machine offering local computation and storage."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:14
msgid "Prerequisites"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:16
msgid ""
"Before following this tutorial, you should follow the :ref:`bare-metal-"
"install-desktop` to ensure you have installed |CL|."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:19
msgid ""
"Before you install any new packages, update |CL| with the following "
"command:"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:25
msgid ""
"For the purposes of this tutorial, we will install Hadoop in a single "
"machine running both the master and slave daemons."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:29
msgid "Install Apache Hadoop"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:31
msgid ""
"Apache Hadoop is included in the `big-data-basic` bundle. To install the "
"framework, enter the following command:"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:39
msgid "Configure Apache Hadoop"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:41
msgid "To create the configuration directory, enter the following command:"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:47
msgid ""
"Copy the defaults from :file:`/usr/share/defaults/hadoop` to "
":file:`/etc/hadoop` with the following command:"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:54
msgid ""
"Since |CL| is a stateless system, you should never modify the files under"
" the :file:`/usr/share/defaults` directory. The software updater will "
"overwrite those files."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:58
msgid ""
"Once all the configuration files are in :file:`/etc/hadoop`, we must edit"
" them to fit our needs. The `NameNode` server is the master server. It "
"manages the namespace of the files system and regulates the clients' "
"access to files. The first file we edit, :file:`/etc/hadoop/core-"
"site.xml`, informs the Hadoop daemon where `NameNode` is running."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:64
msgid ""
"In this tutorial, our `NameNode` runs in our `localhost`. Follow these "
"steps to set it up correctly:"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:67
msgid ""
"Open the :file:`/etc/hadoop/core-site.xml` file using the editor of your "
"choice and modify the file as follows:"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:81
msgid ""
"Edit the :file:`/etc/hadoop/hdfs-site.xml` file. This file configures the"
" :abbr:`HDFS (Hadoop Distributed File System)` daemons. This "
"configuration includes the list of permitted and excluded data nodes and "
"the size of said blocks. In this example, we are setting the number of "
"block replication to 1 from the default of 3 as follows:"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:103
msgid ""
"Edit the :file:`/etc/hadoop/mapred-site.xml` file. This file configures "
"all daemons related to `MapReduce`: `JobTracker` and `TaskTrackers`. With"
" `MapReduce`, Hadoop can process big amounts of data in multiple systems."
" In our example, we set :abbr:`YARN (Yet Another Resource Manager)` as "
"our runtime framework for executing `MapReduce` jobs as follows:"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:121
msgid ""
"Edit the :file:`/etc/hadoop/yarn-site.xml` file. This file configures all"
" daemons related to `YARN`: `ResourceManager` and `NodeManager`. In our "
"example, we implement the `mapreduce_shuffle` service, which is the "
"default as follows:"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:142
msgid "Configure your SSH key"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:144
msgid "Create a SSH key. If you already have one, skip this step."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:151
msgid "Copy the key to your authorized keys."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:157
msgid ""
"Log into the localhost. If no password prompt appears, you are ready to "
"run the Hadoop daemons."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:165
msgid "Run the Hadoop daemons"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:167
msgid ""
"With all the configuration files properly edited, we are ready to start "
"the daemons."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:170
msgid ""
"When we format the `NameNode` server, it formats the meta-data related to"
" data nodes. Thus, all the information on the data nodes is lost and the "
"nodes can be reused for new data."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:174
msgid "Format the `NameNode` server with the following command:"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:180
msgid "Start the DFS in `NameNode` and `DataNodes` with the following command:"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:186 ../../tutorials/apache-hadoop.rst:211
msgid "The console output should be similar to:"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:196
msgid "Enter `yes` to continue."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:198
msgid ""
"Start the `YARN` daemons `ResourceManager` and `NodeManager` with the "
"following command:"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:205
msgid "Ensure everything is running as expected with the following command:"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:223
msgid "Run the MapReduce wordcount example"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:225
msgid "Create the input directory."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:231
msgid "Copy a file from the local file system to the HDFS."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:237
msgid "Run the `wordcount` example."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:243
msgid ""
"Read output file \"part-r-00000\". This file contains the number of times"
" each word appears in the file."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:250
msgid "**Congratulations!**"
msgstr ""
#: ../../tutorials/apache-hadoop.rst:252
msgid ""
"You successfully installed and setup a single node Hadoop cluster. "
"Additionally, you ran a simple wordcount example."
msgstr ""
#: ../../tutorials/apache-hadoop.rst:255
msgid "Your single node Hadoop cluster is up and running!"
msgstr ""
#~ msgid "Set up a single node cluster with Hadoop\\*"
#~ msgstr ""
#~ msgid ""
#~ "This tutorial walks you through the "
#~ "process of installing, configuring, and "
#~ "running Apache\\* Hadoop on |CL-ATTR|."
#~ " The Apache Hadoop software library "
#~ "is a framework for distributed "
#~ "processing of large data sets across "
#~ "clusters of computers using simple "
#~ "programming models. It is designed to"
#~ " scale up from single servers to "
#~ "thousands of machines, with each machine"
#~ " offering local computation and storage."
#~ msgstr ""
@@ -0,0 +1,179 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/apache-spark.rst:4
msgid "Apache\\* Spark\\*"
msgstr ""
#: ../../tutorials/apache-spark.rst:6
msgid ""
"This tutorial describes how to install, configure, and run Apache Spark "
"on |CL-ATTR|. Apache Spark is a fast general-purpose cluster computing "
"system with the following features:"
msgstr ""
#: ../../tutorials/apache-spark.rst:10
msgid "Provides high-level APIs in Java\\*, Scala\\*, Python\\*, and R\\*."
msgstr ""
#: ../../tutorials/apache-spark.rst:11
msgid "Includes an optimized engine that supports general execution graphs."
msgstr ""
#: ../../tutorials/apache-spark.rst:12
msgid ""
"Supports high-level tools including Spark SQL, MLlib, GraphX, and Spark "
"Streaming."
msgstr ""
#: ../../tutorials/apache-spark.rst:15
msgid ""
"In this tutorial, you will install Spark on a single machine running the "
"master daemon and a worker daemon."
msgstr ""
#: ../../tutorials/apache-spark.rst:19
msgid "Prerequisites"
msgstr ""
#: ../../tutorials/apache-spark.rst:21
msgid ""
"This tutorial assumes you have installed |CL| on your host system. For "
"detailed instructions on installing |CL| on a bare metal system, visit "
"the :ref:`bare metal installation guide <bare-metal-install-desktop>`."
msgstr ""
#: ../../tutorials/apache-spark.rst:25
msgid ""
"Before you install any new packages, update |CL| with the following "
"command:"
msgstr ""
#: ../../tutorials/apache-spark.rst:32
msgid "Install Apache Spark"
msgstr ""
#: ../../tutorials/apache-spark.rst:34
msgid ""
"Apache Spark is included in the :file:`big-data-basic` bundle. To install"
" the framework, enter:"
msgstr ""
#: ../../tutorials/apache-spark.rst:42
msgid "Configure Apache Spark"
msgstr ""
#: ../../tutorials/apache-spark.rst:44
msgid "Create the configuration directory with the command:"
msgstr ""
#: ../../tutorials/apache-spark.rst:50
msgid ""
"Copy the default templates from :file:`/usr/share/defaults/spark` to "
":file:`/etc/spark` with the command:"
msgstr ""
#: ../../tutorials/apache-spark.rst:57
msgid ""
"Since |CL| is a stateless system, you should never modify the files under"
" the :file:`/usr/share/defaults` directory. The software updater "
"overwrites those files."
msgstr ""
#: ../../tutorials/apache-spark.rst:62
msgid "Copy the template files below to create custom configuration files:"
msgstr ""
#: ../../tutorials/apache-spark.rst:70
msgid ""
"Edit the :file:`/etc/spark/spark-env.sh` file and add the "
":envvar:`SPARK_MASTER_HOST` variable. Replace the example address below "
"with your localhost IP address. View your IP address using the "
":command:`hostname -I` command."
msgstr ""
#: ../../tutorials/apache-spark.rst:79
msgid ""
"This optional step enables the master's web user interface to view "
"information needed later in this tutorial."
msgstr ""
#: ../../tutorials/apache-spark.rst:82
msgid ""
"Edit the :file:`/etc/spark/spark-defaults.conf` file and update the "
"`spark.master` variable with the `SPARK_MASTER_HOST` address and port "
"`7077`."
msgstr ""
#: ../../tutorials/apache-spark.rst:90
msgid "Start the master server and a worker daemon"
msgstr ""
#: ../../tutorials/apache-spark.rst:92
msgid "Start the master server using:"
msgstr ""
#: ../../tutorials/apache-spark.rst:98
msgid ""
"Start one worker daemon and connect it to the master using the "
"`spark.master` variable defined earlier:"
msgstr ""
#: ../../tutorials/apache-spark.rst:105
msgid ""
"Open an internet browser and view the worker daemon information using the"
" master's IP address and port `8080`:"
msgstr ""
#: ../../tutorials/apache-spark.rst:113
msgid "Run the Spark wordcount example"
msgstr ""
#: ../../tutorials/apache-spark.rst:115
msgid ""
"Run the wordcount example using a file on your local host and output the "
"results to a new file with the following command:"
msgstr ""
#: ../../tutorials/apache-spark.rst:122
msgid ""
"Open an internet browser and view the application information using the "
"master's IP address and port `8080`:"
msgstr ""
#: ../../tutorials/apache-spark.rst:129
msgid ""
"View the results of the wordcount application in the "
":file:`~/Documents/results` file."
msgstr ""
#: ../../tutorials/apache-spark.rst:131
msgid "**Congratulations!**"
msgstr ""
#: ../../tutorials/apache-spark.rst:133
msgid ""
"You successfully installed and set up a standalone Apache Spark cluster. "
"Additionally, you ran a simple wordcount example."
msgstr ""
#~ msgid "Set up a standalone cluster system using Apache\\* Spark\\*"
#~ msgstr ""
@@ -0,0 +1,104 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-07-12 12:18-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/kata_migration.rst:4
msgid "Migrate Clear Containers to Kata Containers\\*"
msgstr ""
#: ../../tutorials/kata_migration.rst:6
msgid ""
"`Clear Containers`_ and `Kata Containers`_ can co-exist in the same "
"system. Both can be installed through the :file:`containers-virt bundle`."
" However, we recommend that you migrate to Kata Containers because Clear "
"Containers is no longer maintained_ and will soon be deprecated on |CL-"
"ATTR|."
msgstr ""
#: ../../tutorials/kata_migration.rst:11
msgid "This guide describes how to migrate to Kata Containers and assumes that:"
msgstr ""
#: ../../tutorials/kata_migration.rst:13
msgid "Clear Containers is on a Docker\\* system."
msgstr ""
#: ../../tutorials/kata_migration.rst:14
msgid "Kata Containers is installed. See :ref:`kata`."
msgstr ""
#: ../../tutorials/kata_migration.rst:18
msgid "Stop Clear Containers instances"
msgstr ""
#: ../../tutorials/kata_migration.rst:20
msgid "As an unprivileged user, stop all running instances of Clear Containers:"
msgstr ""
#: ../../tutorials/kata_migration.rst:28
msgid "Manually migrate customized configuration files"
msgstr ""
#: ../../tutorials/kata_migration.rst:30
msgid ""
"If you have made changes to your `Clear Containers configuration`_, "
"review those changes and decide whether to manually apply those changes "
"to your `Kata Containers configuration`_."
msgstr ""
#: ../../tutorials/kata_migration.rst:34
msgid "Make any required changes before continuing this process."
msgstr ""
#: ../../tutorials/kata_migration.rst:38
msgid "You do not need to manually remove any Clear Containers packages."
msgstr ""
#: ../../tutorials/kata_migration.rst:42
msgid "Enable Kata Containers as default"
msgstr ""
#: ../../tutorials/kata_migration.rst:44
msgid "Configure Docker to use the Kata Containers runtime by default."
msgstr ""
#: ../../tutorials/kata_migration.rst:54
msgid "Restart the Docker systemd services."
msgstr ""
#: ../../tutorials/kata_migration.rst:61
msgid "Verify Docker is using Kata Containers."
msgstr ""
#: ../../tutorials/kata_migration.rst:69
msgid "Run Kata Containers"
msgstr ""
#: ../../tutorials/kata_migration.rst:71
msgid "Use the following command:"
msgstr ""
#: ../../tutorials/kata_migration.rst:77
msgid "**Congratulations!**"
msgstr ""
#: ../../tutorials/kata_migration.rst:79
msgid "You've successfully migrated from Clear Containers to Kata Containers."
msgstr ""
+998
View File
@@ -0,0 +1,998 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019.
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-29 17:26-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/dlrs.rst:4
msgid "Deep Learning Reference Stack"
msgstr ""
#: ../../tutorials/dlrs.rst:6
msgid ""
"This guide gives examples for using the Deep Learning Reference stack to "
"run real-world usecases, as well as benchmarking workloads for "
"TensorFlow\\*, PyTorch\\*, and Kubeflow\\* in |CL-ATTR|."
msgstr ""
#: ../../tutorials/dlrs.rst:14
msgid "Overview"
msgstr ""
#: ../../tutorials/dlrs.rst:16
msgid ""
"We created the Deep Learning Reference Stack to help AI developers "
"deliver the best experience on Intel® Architecture. This stack reduces "
"complexity common with deep learning software components, provides "
"flexibility for customized solutions, and enables you to quickly "
"prototype and deploy Deep Learning workloads. Use this guide to run "
"benchmarking workloads on your solution."
msgstr ""
#: ../../tutorials/dlrs.rst:23
msgid "The Deep Learning Reference Stack is available in the following versions:"
msgstr ""
#: ../../tutorials/dlrs.rst:25
msgid ""
"`Intel MKL-DNN-VNNI`_, which is optimized using Intel® Math Kernel "
"Library for Deep Neural Networks (Intel® MKL-DNN) primitives and "
"introduces support for Intel® AVX-512 Vector Neural Network Instructions "
"(VNNI)."
msgstr ""
#: ../../tutorials/dlrs.rst:28
msgid ""
"`Intel MKL-DNN`_, which includes the TensorFlow framework optimized using"
" Intel® Math Kernel Library for Deep Neural Networks (Intel® MKL-DNN) "
"primitives."
msgstr ""
#: ../../tutorials/dlrs.rst:31
msgid "`Eigen`_, which includes `TensorFlow`_ optimized for Intel® architecture."
msgstr ""
#: ../../tutorials/dlrs.rst:32
msgid "`PyTorch with OpenBLAS`_, which includes PyTorch with OpenBlas."
msgstr ""
#: ../../tutorials/dlrs.rst:33
msgid ""
"`PyTorch with Intel MKL-DNN`_, which includes PyTorch optimized using "
"Intel® Math Kernel Library (Intel® MKL) and Intel MKL-DNN."
msgstr ""
#: ../../tutorials/dlrs.rst:38
msgid ""
"To take advantage of the Intel® AVX-512 and VNNI functionality (including"
" the MKL-DNN releases) with the Deep Learning Reference Stack, you must "
"use the following hardware:"
msgstr ""
#: ../../tutorials/dlrs.rst:41
msgid "Intel® AVX-512 images require an Intel® Xeon® Scalable Platform"
msgstr ""
#: ../../tutorials/dlrs.rst:42
msgid "VNNI requires a 2nd generation Intel® Xeon® Scalable Platform"
msgstr ""
#: ../../tutorials/dlrs.rst:45
msgid "Stack features"
msgstr ""
#: ../../tutorials/dlrs.rst:47
msgid "`DLRS V4.0`_ release announcement, including benchmark results."
msgstr ""
#: ../../tutorials/dlrs.rst:48
msgid "`DLRS V3.0`_ release announcement."
msgstr ""
#: ../../tutorials/dlrs.rst:49
msgid "Deep Learning Reference Stack v2.0 including current `PyTorch benchmark`_."
msgstr ""
#: ../../tutorials/dlrs.rst:51
msgid ""
"Deep Learning Reference Stack v1.0 including current `TensorFlow "
"benchmark`_ results."
msgstr ""
#: ../../tutorials/dlrs.rst:53
msgid ""
"`DLRS Release notes`_ on Github\\* for the latest release of Deep "
"Learning Reference Stack."
msgstr ""
#: ../../tutorials/dlrs.rst:58
msgid ""
"The Deep Learning Reference Stack is a collective work, and each piece of"
" software within the work has its own license. Please see the `DLRS "
"Terms of Use`_ for more details about licensing and usage of the Deep "
"Learning Reference Stack."
msgstr ""
#: ../../tutorials/dlrs.rst:63
msgid "Prerequisites"
msgstr ""
#: ../../tutorials/dlrs.rst:65
msgid ":ref:`Install <bare-metal-install-desktop>` |CL| on your host system"
msgstr ""
#: ../../tutorials/dlrs.rst:66
msgid ":command:`containers-basic` bundle"
msgstr ""
#: ../../tutorials/dlrs.rst:67
msgid ":command:`cloud-native-basic` bundle"
msgstr ""
#: ../../tutorials/dlrs.rst:69
msgid ""
"In |CL|, :command:`containers-basic` includes Docker\\*, which is "
"required for TensorFlow and PyTorch benchmarking. Use the "
":command:`swupd` utility to check if :command:`containers-basic` and "
":command:`cloud-native-basic` are present:"
msgstr ""
#: ../../tutorials/dlrs.rst:78
msgid ""
"To install the :command:`containers-basic` or :command:`cloud-native-"
"basic` bundles, enter:"
msgstr ""
#: ../../tutorials/dlrs.rst:85
msgid ""
"Docker is not started upon installation of the :command:`containers-"
"basic` bundle. To start Docker, enter:"
msgstr ""
#: ../../tutorials/dlrs.rst:92
msgid ""
"To ensure that Kubernetes is correctly installed and configured, follow "
"the instructions in :ref:`kubernetes`."
msgstr ""
#: ../../tutorials/dlrs.rst:96
msgid "Version compatibility"
msgstr ""
#: ../../tutorials/dlrs.rst:98
msgid "We validated these steps against the following software package versions:"
msgstr ""
#: ../../tutorials/dlrs.rst:100
msgid "|CL| 26240 (Minimum supported version)"
msgstr ""
#: ../../tutorials/dlrs.rst:101
msgid "Docker 18.06.1"
msgstr ""
#: ../../tutorials/dlrs.rst:102
msgid "Kubernetes 1.11.3"
msgstr ""
#: ../../tutorials/dlrs.rst:103
msgid "Go 1.11.12"
msgstr ""
#: ../../tutorials/dlrs.rst:108
msgid ""
"The Deep Learning Reference Stack was developed to provide the best user "
"experience when executed on a |CL| host. However, as the stack runs in a"
" container environment, you should be able to complete the following "
"sections of this guide on other Linux* distributions, provided they "
"comply with the Docker*, Kubernetes* and Go* package versions listed "
"above. Look for your distribution documentation on how to update packages"
" and manage Docker services."
msgstr ""
#: ../../tutorials/dlrs.rst:113
msgid "TensorFlow single and multi-node benchmarks"
msgstr ""
#: ../../tutorials/dlrs.rst:115
msgid ""
"This section describes running the `TensorFlow Benchmarks`_ in single "
"node. For multi-node testing, replicate these steps for each node. These "
"steps provide a template to run other benchmarks, provided that they can "
"invoke TensorFlow."
msgstr ""
#: ../../tutorials/dlrs.rst:122
msgid ""
"Performance test results for the Deep Learning Reference Stack and for "
"this guide were obtained using `runc` as the runtime."
msgstr ""
#: ../../tutorials/dlrs.rst:125
msgid ""
"Download either the `Eigen`_ or the `Intel MKL-DNN`_ Docker image from "
"`Docker Hub`_."
msgstr ""
#: ../../tutorials/dlrs.rst:128 ../../tutorials/dlrs.rst:170
msgid "Run the image with Docker:"
msgstr ""
#: ../../tutorials/dlrs.rst:137 ../../tutorials/dlrs.rst:178
msgid ""
"Launching the Docker image with the :command:`-i` argument starts "
"interactive mode within the container. Enter the following commands in "
"the running container."
msgstr ""
#: ../../tutorials/dlrs.rst:141
msgid "Clone the benchmark repository in the container:"
msgstr ""
#: ../../tutorials/dlrs.rst:147 ../../tutorials/dlrs.rst:188
msgid "Execute the benchmark script:"
msgstr ""
#: ../../tutorials/dlrs.rst:155
msgid ""
"You can replace the model with one of your choice supported by the "
"TensorFlow benchmarks."
msgstr ""
#: ../../tutorials/dlrs.rst:158
msgid ""
"If you are using an FP32 based model, it can be converted to an int8 "
"model using `Intel® quantization tools`_."
msgstr ""
#: ../../tutorials/dlrs.rst:162
msgid "PyTorch single and multi-node benchmarks"
msgstr ""
#: ../../tutorials/dlrs.rst:164
msgid ""
"This section describes running the `PyTorch benchmarks`_ for Caffe2 in "
"single node."
msgstr ""
#: ../../tutorials/dlrs.rst:167
msgid ""
"Download either the `PyTorch with OpenBLAS`_ or the `PyTorch with Intel "
"MKL-DNN`_ Docker image from `Docker Hub`_."
msgstr ""
#: ../../tutorials/dlrs.rst:182
msgid "Clone the benchmark repository:"
msgstr ""
#: ../../tutorials/dlrs.rst:198
msgid "Kubeflow multi-node benchmarks"
msgstr ""
#: ../../tutorials/dlrs.rst:200
msgid ""
"The benchmark workload runs in a Kubernetes cluster. The guide uses "
"`Kubeflow`_ for the Machine Learning workload deployment on three nodes."
msgstr ""
#: ../../tutorials/dlrs.rst:205
msgid ""
"If you choose the Intel® MKL-DNN or Intel® MKL-DNN-VNNI image, your "
"platform must support the Intel® AVX-512 instruction set. Otherwise, an "
"*illegal instruction* error may appear, and you wont be able to complete"
" this guide."
msgstr ""
#: ../../tutorials/dlrs.rst:211
msgid "Kubernetes setup"
msgstr ""
#: ../../tutorials/dlrs.rst:213
msgid ""
"Follow the instructions in the :ref:`kubernetes` tutorial to get set up "
"on |CL|. The Kubernetes community also has instructions for creating a "
"cluster, described in `Creating a single control-plane cluster with "
"kubeadm`_."
msgstr ""
#: ../../tutorials/dlrs.rst:218
msgid "Kubernetes networking"
msgstr ""
#: ../../tutorials/dlrs.rst:220
msgid ""
"We used `flannel`_ as the network provider for these tests. If you prefer"
" a different network layer, refer to the Kubernetes network documentation"
" described in `Creating a single control-plane cluster with kubeadm`_ for"
" setup."
msgstr ""
#: ../../tutorials/dlrs.rst:225
msgid "Kubectl"
msgstr ""
#: ../../tutorials/dlrs.rst:227
msgid ""
"You can use kubectl to run commands against your Kubernetes cluster. "
"Refer to the `Overview of kubectl`_ for details on syntax and operations."
" Once you have a working cluster on Kubernetes, use the following YAML "
"script to start a pod with a simple shell script, and keep the pod open."
msgstr ""
#: ../../tutorials/dlrs.rst:232
msgid "Copy this example.yaml script to your system:"
msgstr ""
#: ../../tutorials/dlrs.rst:249
msgid "Execute the script with kubectl:"
msgstr ""
#: ../../tutorials/dlrs.rst:255
msgid ""
"This script opens a single pod. More robust solutions would create a "
"deployment or inject a python script or larger shell script into the "
"container."
msgstr ""
#: ../../tutorials/dlrs.rst:259
msgid "Images"
msgstr ""
#: ../../tutorials/dlrs.rst:261
msgid ""
"You must add `launcher.py`_ to the Docker image to include the Deep "
"Learning Reference Stack and put the benchmarks repo in the correct "
"location. Note that this guide uses Kubeflow v0.4.0, and cannot guarantee"
" results if you use a different version."
msgstr ""
#: ../../tutorials/dlrs.rst:265
msgid "From the Docker image, run the following:"
msgstr ""
#: ../../tutorials/dlrs.rst:274
msgid "Your entry point becomes: :file:`/opt/launcher.py`."
msgstr ""
#: ../../tutorials/dlrs.rst:276
msgid "This builds an image that can be consumed directly by TFJob from Kubeflow."
msgstr ""
#: ../../tutorials/dlrs.rst:279
msgid "ksonnet\\*"
msgstr ""
#: ../../tutorials/dlrs.rst:281
msgid ""
"Kubeflow uses ksonnet\\* to manage deployments, so you must install it "
"before setting up Kubeflow."
msgstr ""
#: ../../tutorials/dlrs.rst:284
msgid ""
"ksonnet was added to the :command:`cloud-native-basic` bundle in |CL| "
"version 27550. If you are using an older |CL| version (not recommended), "
"you must manually install ksonnet as described below."
msgstr ""
#: ../../tutorials/dlrs.rst:288
msgid "On |CL|, follow these steps:"
msgstr ""
#: ../../tutorials/dlrs.rst:299
msgid ""
"After the ksonnet installation is complete, ensure that binary `ks` is "
"accessible across the environment."
msgstr ""
#: ../../tutorials/dlrs.rst:303
msgid "Kubeflow"
msgstr ""
#: ../../tutorials/dlrs.rst:305
msgid ""
"Once you have Kubernetes running on your nodes, set up `Kubeflow`_ by "
"following these instructions from the `Getting Started with Kubeflow`_ "
"guide."
msgstr ""
#: ../../tutorials/dlrs.rst:323
msgid "Next, deploy the primary package for our purposes: tf-job-operator."
msgstr ""
#: ../../tutorials/dlrs.rst:333
msgid ""
"This creates the CustomResourceDefinition (CRD) endpoint to launch a "
"TFJob."
msgstr ""
#: ../../tutorials/dlrs.rst:336
msgid "Run a TFJob"
msgstr ""
#: ../../tutorials/dlrs.rst:338
msgid "Get the ksonnet registries for deploying TFJobs from `dlrs-tfjob`_."
msgstr ""
#: ../../tutorials/dlrs.rst:340
msgid "Install the TFJob components as follows:"
msgstr ""
#: ../../tutorials/dlrs.rst:348
msgid "Export the image name to use for the deployment:"
msgstr ""
#: ../../tutorials/dlrs.rst:356
msgid "Replace <docker_name> with the image name you specified in previous steps."
msgstr ""
#: ../../tutorials/dlrs.rst:358
msgid ""
"Generate Kubernetes manifests for the workloads and apply them using "
"these commands:"
msgstr ""
#: ../../tutorials/dlrs.rst:368
msgid "This replicates and deploys three test setups in your Kubernetes cluster."
msgstr ""
#: ../../tutorials/dlrs.rst:371
msgid "Results of running this section"
msgstr ""
#: ../../tutorials/dlrs.rst:373
msgid ""
"You must parse the logs of the Kubernetes pod to retrieve performance "
"data. The pods will still exist post-completion and will be in "
"Completed state. You can get the logs from any of the pods to inspect "
"the benchmark results. More information about Kubernetes logging is "
"available in the Kubernetes `Logging Architecture`_ documentation."
msgstr ""
#: ../../tutorials/dlrs.rst:381
msgid "TensorFlow Training (TFJob) with Kubeflow and DLRS"
msgstr ""
#: ../../tutorials/dlrs.rst:383
msgid ""
"A `TFJob`_ is Kubeflow's custom resource used to run TensorFlow training"
" jobs on Kubernetes. This example shows how to use a TFJob within the "
"DLRS container."
msgstr ""
#: ../../tutorials/dlrs.rst:385 ../../tutorials/dlrs.rst:509
msgid "Pre-requisites:"
msgstr ""
#: ../../tutorials/dlrs.rst:387 ../../tutorials/dlrs.rst:511
#: ../../tutorials/dlrs.rst:532
msgid "A running :ref:`kubernetes` cluster"
msgstr ""
#: ../../tutorials/dlrs.rst:389
msgid "Deploying Kubeflow with kfctl/kustomize in |CL|"
msgstr ""
#: ../../tutorials/dlrs.rst:393
msgid ""
"This example proposes a Kubeflow installation with the binary kfctl "
"maintained by `Arrikto`_. Please download the `kfctl tarball`_ to "
"complete the following steps"
msgstr ""
#: ../../tutorials/dlrs.rst:395
msgid "Download, untar and add to your PATH if necessary"
msgstr ""
#: ../../tutorials/dlrs.rst:404
msgid "Install `MetalLB`_"
msgstr ""
#: ../../tutorials/dlrs.rst:410
msgid "Install Kubeflow resource and TFJob operators"
msgstr ""
#: ../../tutorials/dlrs.rst:425
msgid "List the resources"
msgstr ""
#: ../../tutorials/dlrs.rst:427
msgid ""
"Deployment takes around 15 minutes (or more depending on the hardware) to"
" be ready to use. After that you can use kubectl to list all the Kubeflow"
" resources deployed and monitor their status."
msgstr ""
#: ../../tutorials/dlrs.rst:434
msgid "Submitting TFJobs"
msgstr ""
#: ../../tutorials/dlrs.rst:436
msgid ""
"We provide several `DLRS TFJob`_ examples that use the Deep Learning "
"Reference Stack as the base image for creating the containers to run "
"training workloads in your Kubernetes cluster."
msgstr ""
#: ../../tutorials/dlrs.rst:441
msgid "Customizing a TFJob"
msgstr ""
#: ../../tutorials/dlrs.rst:443
msgid ""
"A TFJob is a resource with a YAML representation like the one below. Edit"
" to use the DLRS image containing the code to be executed and modify the "
"command for your own training code."
msgstr ""
#: ../../tutorials/dlrs.rst:445
msgid ""
"If you'd like to modify the number and type of replicas, resources, "
"persistent volumes and environment variables, please refer to the "
"`Kubeflow documentation`_"
msgstr ""
#: ../../tutorials/dlrs.rst:499
msgid ""
"For more information, please refer to: * `Distributed TensorFlow`_ * "
"`TFJobs`_"
msgstr ""
#: ../../tutorials/dlrs.rst:505
msgid "PyTorch Training (PyTorch Job) with Kubeflow and DLRS"
msgstr ""
#: ../../tutorials/dlrs.rst:507
msgid ""
"A `PyTorch Job`_ is Kubeflow's custom resource used to run PyTorch "
"training jobs on Kubernetes. This example builds on the framework set up "
"in the previous example."
msgstr ""
#: ../../tutorials/dlrs.rst:512
msgid ""
"Please follow steps 1 - 5 of the previous example to set up your "
"environment."
msgstr ""
#: ../../tutorials/dlrs.rst:516
msgid "Submitting PyTorch Jobs"
msgstr ""
#: ../../tutorials/dlrs.rst:518
msgid ""
"We provide several `DLRS PytorchJob`_ examples that use the Deep Learning"
" Reference Stack as the base image for creating the container(s) that "
"will run training workloads in your Kubernetes cluster. Select one form "
"the list below:"
msgstr ""
#: ../../tutorials/dlrs.rst:526
msgid "Using Kubeflow Seldon and OpenVINO* with the Deep Learning Reference Stack"
msgstr ""
#: ../../tutorials/dlrs.rst:528
msgid ""
"`Seldon Core`_ is an open source platform for deploying machine learning"
" models on a Kubernetes cluster. Seldon Core is supported in the `DLRS "
"V4.0`_ release."
msgstr ""
#: ../../tutorials/dlrs.rst:531
msgid "Pre-requisites"
msgstr ""
#: ../../tutorials/dlrs.rst:536
msgid ""
"Instead of using Arrikto's configuration manifest as shown in the "
"preceeding example, you should use the manifest provided by `Istio`_, for"
" this example, as Seldon deployments depend on it."
msgstr ""
#: ../../tutorials/dlrs.rst:538
msgid "Install deployment tools"
msgstr ""
#: ../../tutorials/dlrs.rst:550
msgid "Install Helm*"
msgstr ""
#: ../../tutorials/dlrs.rst:558
msgid "Clean the environment"
msgstr ""
#: ../../tutorials/dlrs.rst:564
msgid "Prepare the DLRS image"
msgstr ""
#: ../../tutorials/dlrs.rst:566
msgid ""
"The DLRS base image needs to be rebuilt with the "
"`Dockerfile_openvino_base`_ to add Seldon and the OpenVINO inference "
"engine."
msgstr ""
#: ../../tutorials/dlrs.rst:572
msgid "Mount pre-trained models into a persistent volume"
msgstr ""
#: ../../tutorials/dlrs.rst:574
msgid "This will also apply all PV manifests to the cluster"
msgstr ""
#: ../../tutorials/dlrs.rst:582
msgid "Start a shell for the container used as pv:"
msgstr ""
#: ../../tutorials/dlrs.rst:588
msgid "Save pre-trained models"
msgstr ""
#: ../../tutorials/dlrs.rst:590
msgid ""
"Now that you're inside the running container, fetch your pre-trained "
"models and save them at `/opt/ml`"
msgstr ""
#: ../../tutorials/dlrs.rst:598
msgid "Deploy the model server"
msgstr ""
#: ../../tutorials/dlrs.rst:600
msgid "Now you're ready to deploy the model server using the Helm chart provided."
msgstr ""
#: ../../tutorials/dlrs.rst:615
msgid "Using the Intel® OpenVINO Model Optimizer"
msgstr ""
#: ../../tutorials/dlrs.rst:617
msgid ""
"The Intel OpenVINO toolkit has two primary tools for deep learning, the "
"inference engine and the model optimizer. The inference engine is "
"integrated into the Deep Learning Reference Stack. It is better to use "
"the model optimizer after training the model, and before inference "
"begins. This example will explain how to use the model optimizer by going"
" through a test case with a pre-trained TensorFlow model."
msgstr ""
#: ../../tutorials/dlrs.rst:619
msgid ""
"This example uses resources found in the following OpenVino Toolkit "
"documentation."
msgstr ""
#: ../../tutorials/dlrs.rst:621
msgid "`Converting a TensorFlow Model`_"
msgstr ""
#: ../../tutorials/dlrs.rst:623
msgid "`Converting TensorFlow Object Detection API Models`_"
msgstr ""
#: ../../tutorials/dlrs.rst:625
msgid "In this example, you will:"
msgstr ""
#: ../../tutorials/dlrs.rst:627 ../../tutorials/dlrs.rst:632
msgid "Download a TensorFlow model"
msgstr ""
#: ../../tutorials/dlrs.rst:628 ../../tutorials/dlrs.rst:645
msgid "Clone the Model Optimizer"
msgstr ""
#: ../../tutorials/dlrs.rst:629
msgid "Install Prerequisites"
msgstr ""
#: ../../tutorials/dlrs.rst:630 ../../tutorials/dlrs.rst:678
msgid "Run the Model Optimizer"
msgstr ""
#: ../../tutorials/dlrs.rst:634
msgid ""
"We will be using an OpenVINO supported topology with the Model Optimizer."
" We will use a TensorFlow Inception V2 frozen model."
msgstr ""
#: ../../tutorials/dlrs.rst:636
msgid ""
"Navigate to the `OpenVINO TensorFlow Model page`_. Then scroll down to "
"the second section titled \"Supported Frozen Topologies from TensorFlow "
"Object Detection Models Zoo\" and download \"SSD Inception V2 COCO.\""
msgstr ""
#: ../../tutorials/dlrs.rst:638
msgid ""
"Unpack the file into your chosen working directory. For example, if the "
"tar file is in your Downloads folder and you have navigated to the "
"directory you want to extract it into, run:"
msgstr ""
#: ../../tutorials/dlrs.rst:647
msgid ""
"Next we need the model optimizer directory, named `dldt`_. This example"
" assumes the parent directory is on the same level as the model "
"directory, ie:"
msgstr ""
#: ../../tutorials/dlrs.rst:656
msgid "To clone the Model Optimizer, run this from inside the working directory:"
msgstr ""
#: ../../tutorials/dlrs.rst:663
msgid ""
"If you explore the :file:`dldt` directory, you'll see both the inference "
"engine and the model optimizer. We are only concerned with the model "
"optimizer at this stage. Navigating into the model optimizer folder "
"you'll find several python scripts and text files. These are the scripts "
"you call to run the model optimizer."
msgstr ""
#: ../../tutorials/dlrs.rst:666
msgid "Install Prerequisites for Model Optimizer"
msgstr ""
#: ../../tutorials/dlrs.rst:668
msgid ""
"Install the Python packages required to run the model optimizer by "
"running the script dldt/model-"
"optimizer/install_prerequisites/install_prerequisites_tf.sh."
msgstr ""
#: ../../tutorials/dlrs.rst:680
msgid ""
"Running the model optimizer is as simple as calling the appropriate "
"script, however there are many configuration options that are explainedin"
" the documentation"
msgstr ""
#: ../../tutorials/dlrs.rst:691
msgid ""
"You should now see three files in your working directory, "
":file:`frozen_inference_graph.bin`, "
":file:`frozen_inference_graph.mapping`, and "
":file:`frozen_inference_graph.xml`. These are your new models in the "
"Intermediate Representation (IR) format and they are ready for use in the"
" OpenVINO Inference Engine."
msgstr ""
#: ../../tutorials/dlrs.rst:694
msgid "Using the OpenVino Inference Engine"
msgstr ""
#: ../../tutorials/dlrs.rst:696
msgid ""
"This example walks through the basic instructions for using the inference"
" engine."
msgstr ""
#: ../../tutorials/dlrs.rst:698
msgid "Starting the Model Server"
msgstr ""
#: ../../tutorials/dlrs.rst:700
msgid ""
"The process is similar to how we start `Jupter notebooks` on our "
"containers"
msgstr ""
#: ../../tutorials/dlrs.rst:702
msgid "Run this command to spin up a OpenVino model fetched from GCP"
msgstr ""
#: ../../tutorials/dlrs.rst:709
msgid ""
"Once the server is setup, use a :command:`grpc` client to communicate "
"with served model:"
msgstr ""
#: ../../tutorials/dlrs.rst:723
msgid "The results of these commands will look like this:"
msgstr ""
#: ../../tutorials/dlrs.rst:766
msgid "Use Jupyter Notebook"
msgstr ""
#: ../../tutorials/dlrs.rst:768
msgid ""
"This example uses the `PyTorch with OpenBLAS`_ container image. After it "
"is downloaded, run the Docker image with :command:`-p` to specify the "
"shared port between the container and the host. This example uses port "
"8888."
msgstr ""
#: ../../tutorials/dlrs.rst:776
msgid ""
"After you start the container, launch the Jupyter Notebook. This command "
"is executed inside the container image."
msgstr ""
#: ../../tutorials/dlrs.rst:783
msgid ""
"After the notebook has loaded, you will see output similar to the "
"following:"
msgstr ""
#: ../../tutorials/dlrs.rst:791
msgid ""
"From your host system, or any system that can access the host's IP "
"address, start a web browser with the following. If you are not running "
"the browser on the host system, replace :command:`127.0.0.1` with the IP "
"address of the host."
msgstr ""
#: ../../tutorials/dlrs.rst:799
msgid "Your browser displays the following:"
msgstr ""
#: ../../tutorials/dlrs.rst:805
msgid "Figure 1: :guilabel:`Jupyter Notebook`"
msgstr ""
#: ../../tutorials/dlrs.rst:808
msgid ""
"To create a new notebook, click :guilabel:`New` and select "
":guilabel:`Python 3`."
msgstr ""
#: ../../tutorials/dlrs.rst:814
msgid "Figure 2: Create a new notebook"
msgstr ""
#: ../../tutorials/dlrs.rst:816
msgid "A new, blank notebook is displayed, with a cell ready for input."
msgstr ""
#: ../../tutorials/dlrs.rst:823
msgid ""
"To verify that PyTorch is working, copy the following snippet into the "
"blank cell, and run the cell."
msgstr ""
#: ../../tutorials/dlrs.rst:837
msgid "When you run the cell, your output will look something like this:"
msgstr ""
#: ../../tutorials/dlrs.rst:843
msgid ""
"You can continue working in this notebook, or you can download existing "
"notebooks to take advantage of the Deep Learning Reference Stack's "
"optimized deep learning frameworks. Refer to `Jupyter Notebook`_ for "
"details."
msgstr ""
#: ../../tutorials/dlrs.rst:848
msgid "Uninstallation"
msgstr ""
#: ../../tutorials/dlrs.rst:850
msgid ""
"To uninstall the Deep Learning Reference Stack, you can choose to stop "
"the container so that it is not using system resources, or you can stop "
"the container and delete it to free storage space."
msgstr ""
#: ../../tutorials/dlrs.rst:854
msgid "To stop the container, execute the following from your host system:"
msgstr ""
#: ../../tutorials/dlrs.rst:856
msgid "Find the container's ID"
msgstr ""
#: ../../tutorials/dlrs.rst:862
msgid "This will result in output similar to the following:"
msgstr ""
#: ../../tutorials/dlrs.rst:869
msgid ""
"You can then use the ID or container name to stop the container. This "
"example uses the name \"oss\":"
msgstr ""
#: ../../tutorials/dlrs.rst:877
msgid "Verify that the container is not running"
msgstr ""
#: ../../tutorials/dlrs.rst:884
msgid "To delete the container from your system you need to know the Image ID:"
msgstr ""
#: ../../tutorials/dlrs.rst:890
msgid "This command results in output similar to the following:"
msgstr ""
#: ../../tutorials/dlrs.rst:898
msgid "To remove an image use the image ID:"
msgstr ""
#: ../../tutorials/dlrs.rst:914
msgid ""
"Note that you can execute the :command:`docker rmi` command using only "
"the first few characters of the image ID, provided they are unique on the"
" system."
msgstr ""
#: ../../tutorials/dlrs.rst:916
msgid "Once you have removed the image, you can verify it has been deleted with:"
msgstr ""
#: ../../tutorials/dlrs.rst:923
msgid "Compiling AIXPRT with OpenMP on DLRS"
msgstr ""
#: ../../tutorials/dlrs.rst:925
msgid ""
"To compile AIXPRT for DLRS, you will have to get the community edition of"
" AIXPRT and update the `compile_AIXPRT_source.sh` file.AIXPRT utilizes "
"build configuration files, so to build AIXPRT on the image, copy, the "
"build files from the base image, this can be done by adding these "
"commands to the end of the stacks-tensorflow-mkl dockerfile:"
msgstr ""
#: ../../tutorials/dlrs.rst:938
msgid ""
"AIXPRT requires OpenCV. On |CL|, the OpenCV bundle also installs the DLDT"
" components. To use AIXPRT in the DLRS environment you need to either "
"remove the shared libraries for DLDT from :file:`/usr/lib64` before you "
"run the tests, or ensure that the DLDT components in the "
":file:`/usr/local/lib` are being used for AIXPRT. This can be achieved "
"using adding LD_LIBRARY_PATH environment variable before testing."
msgstr ""
#: ../../tutorials/dlrs.rst:945
msgid ""
"The updates to the AIXPRT community edition have been captured in the "
"diff file :file:`compile_AIXPRT_source.sh.patch`. The core of these "
"changes relate to the version of model files(2019_R1) we download from "
"the `OpenCV open model zoo`_ and location of the build files, which in "
"our case is `/dldt`. Please refer to the patch files and make changes as "
"necessary to the compile_AIXPRT_source.sh file as required for your "
"environment."
msgstr ""
#: ../../tutorials/dlrs.rst:949
msgid "Related topics"
msgstr ""
#: ../../tutorials/dlrs.rst:951
msgid "`DLRS V3.0`_ release announcement"
msgstr ""
#: ../../tutorials/dlrs.rst:952
msgid "`TensorFlow Benchmarks`_"
msgstr ""
#: ../../tutorials/dlrs.rst:953
msgid "`PyTorch benchmarks`_"
msgstr ""
#: ../../tutorials/dlrs.rst:954
msgid "`Kubeflow`_"
msgstr ""
#: ../../tutorials/dlrs.rst:955
msgid ":ref:`kubernetes` tutorial"
msgstr ""
#: ../../tutorials/dlrs.rst:956
msgid "`Jupyter Notebook`_"
msgstr ""
@@ -0,0 +1,372 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/docker.rst:4
msgid "Docker\\*"
msgstr ""
#: ../../tutorials/docker.rst:6
msgid ""
"|CL-ATTR| supports multiple containerization platforms, including a "
"Docker solution. |CL| has many unique features including a minimal "
"default installation, which makes it compelling to use as a host for "
"container workloads, management, and orchestration."
msgstr ""
#: ../../tutorials/docker.rst:11
msgid "This tutorial covers:"
msgstr ""
#: ../../tutorials/docker.rst:18
msgid ""
"This tutorial focuses on the installaton of the Docker ecosystem. If you "
"want to use |CL| as a Docker container image, refer to the official |CL| "
"container image `published on Docker* Hub "
"<https://hub.docker.com/_/clearlinux/>`_ and our guide to :ref:`custom-"
"clear-container`."
msgstr ""
#: ../../tutorials/docker.rst:25
msgid "Prerequisites"
msgstr ""
#: ../../tutorials/docker.rst:27
msgid ""
"This tutorial assumes you have installed |CL| on your host system. For "
"detailed instructions on installing |CL| on a bare metal system, follow "
"the :ref:`bare metal installation instructions<bare-metal-install-"
"server>`."
msgstr ""
#: ../../tutorials/docker.rst:31
msgid ""
"Before you install any new packages, update |CL| with the following "
"command:"
msgstr ""
#: ../../tutorials/docker.rst:37
msgid "Additionally, you should have:"
msgstr ""
#: ../../tutorials/docker.rst:39
msgid "A basic understanding of Linux\\* and Docker."
msgstr ""
#: ../../tutorials/docker.rst:41
msgid ""
"|CL| environment that has transparent network access to the Internet. If "
"you are behind a HTTP proxy server, in a corporate setting for example, "
"please refer to the `Docker proxy instructions`_ ."
msgstr ""
#: ../../tutorials/docker.rst:46
msgid "Install the containers-basic bundle"
msgstr ""
#: ../../tutorials/docker.rst:48
msgid ""
"Software in |CL| is offered in the form of :ref:`bundles` to provide a "
"complete function. The *containers-basic* provides all the required "
"software packages to run Docker images as containers."
msgstr ""
#: ../../tutorials/docker.rst:52
msgid ""
"First, install the *containers-basic* bundle by running this "
":command:`swupd` command:"
msgstr ""
#: ../../tutorials/docker.rst:59
msgid "Start the Docker daemon through systemd manager by running this command:"
msgstr ""
#: ../../tutorials/docker.rst:65
msgid ""
"If you want Docker to start automatically on boot, enable the systemd "
"service by running this command:"
msgstr ""
#: ../../tutorials/docker.rst:72
msgid ""
"Finally, verify :command:`docker` has been installed by running this "
"command and checking the version output for both *client* and *server*:"
msgstr ""
#: ../../tutorials/docker.rst:79
msgid ""
"Congratulations! At this point, you have a working installation of Docker"
" on |CL|. You are ready to start using container images on your system."
msgstr ""
#: ../../tutorials/docker.rst:83
msgid "Integration with Kata Containers\\* (optional)"
msgstr ""
#: ../../tutorials/docker.rst:85
msgid ""
"`Kata Containers`_, is an open source project aiming to increase security"
" of containers by using a hardware-backed virtual machine container "
"runtime rather than software namespace containers that are provided by "
"the standard Docker *runc* runtime."
msgstr ""
#: ../../tutorials/docker.rst:90
msgid ""
"|CL| provides easy integration of the *kata-runtime* with Docker. More "
"information on installing and using the *kata-runtime* may be found at "
":ref:`kata`."
msgstr ""
#: ../../tutorials/docker.rst:96
msgid ""
"The remaining sections of this tutorial are standard to Docker setup and "
"configuration. If you are familiar with Docker basics, you do not need to"
" continue reading. The following sections are provided here for sake of "
"completeness."
msgstr ""
#: ../../tutorials/docker.rst:104
msgid "Additional Docker configuration"
msgstr ""
#: ../../tutorials/docker.rst:106
msgid ""
"Perform additional Docker daemon configuration via a configuration file "
"typically located at :file:`/etc/docker/daemon.json`. |CL| features a "
":ref:`stateless` system so the configuration file :file:`daemon.json` "
"does *NOT* exist by default."
msgstr ""
#: ../../tutorials/docker.rst:111
msgid "Create the :file:`daemon.json` by running this command:"
msgstr ""
#: ../../tutorials/docker.rst:119
msgid ""
"Refer to the `Docker documentation on daemon configuration`_ for the full"
" list of available configuration options and examples."
msgstr ""
#: ../../tutorials/docker.rst:122
msgid ""
"For production systems, we follow Docker's recommendation to use the "
"`OverlayFS storage driver`_ `overlay2`, shown below:"
msgstr ""
#: ../../tutorials/docker.rst:133
msgid ""
"A testing version is found in `Docker Device Mapper storage driver`_. If "
"using this storage driver, a warning message may appear: \"usage of "
"loopback devices is strongly discouraged for production use\"."
msgstr ""
#: ../../tutorials/docker.rst:137
msgid "Save and close :file:`daemon.json`."
msgstr ""
#: ../../tutorials/docker.rst:139
msgid ""
"Once you've made any required changes, be sure to restart the Docker "
"daemon through systemd manager by running this command:"
msgstr ""
#: ../../tutorials/docker.rst:147
msgid "Pulling and running an image from Docker Hub"
msgstr ""
#: ../../tutorials/docker.rst:149
msgid ""
"`Docker Hub`_ is a publically available container image repository which "
"comes pre-configured with Docker. In the example below we will pull and "
"run an the official Docker image for nginx\\*, an open source reverse "
"proxy server."
msgstr ""
#: ../../tutorials/docker.rst:153
msgid ""
"First, pull a container image from Docker Hub using the :command:`docker "
"pull` command. Download the latest nginx\\* Docker container image by "
"running this command:"
msgstr ""
#: ../../tutorials/docker.rst:161
msgid ""
"Create and launch a new container using the :command:`docker run` "
"command. Launch a nginx container by running this command:"
msgstr ""
#: ../../tutorials/docker.rst:170
msgid ""
"Below is an explanation of switches used in the command above. For "
"detailed :command:`docker run` switches and syntax, refer to the `Docker "
"Documentation`_ ."
msgstr ""
#: ../../tutorials/docker.rst:174
msgid ""
"The *--name* switch lets you provide a friendly name to target the "
"container for future operations"
msgstr ""
#: ../../tutorials/docker.rst:177
msgid "The *-d* switch launches the container in the background"
msgstr ""
#: ../../tutorials/docker.rst:179
msgid ""
"The *-p* switch allows the container's HTTP port (80) to be accessible "
"from the |CL| host on port 8080"
msgstr ""
#: ../../tutorials/docker.rst:182
msgid ""
"You can access the Welcome to Nginx! splash page running in the container"
" by browsing to \\http://127.0.0.1:8080 or by running this "
":command:`curl` command from your |CL| machine:"
msgstr ""
#: ../../tutorials/docker.rst:190
msgid ""
"Finally, stop and delete the nginx container by running the "
":command:`docker stop` and :command:`docker rm` commands."
msgstr ""
#: ../../tutorials/docker.rst:198
msgid ""
"Congratulations! At this point, you have successfully pulled a nginx "
"container image from `Docker Hub`_ and have run an example container."
msgstr ""
#: ../../tutorials/docker.rst:202
msgid "Creating a Docker swarm cluster"
msgstr ""
#: ../../tutorials/docker.rst:204
msgid "Clusters of Docker hosts are referred to as *swarms*."
msgstr ""
#: ../../tutorials/docker.rst:206
msgid ""
"The process in this tutorial can be repeated to install Docker on "
"multiple |CL| hosts with the intent to form a Docker swarm cluster."
msgstr ""
#: ../../tutorials/docker.rst:209
msgid ""
"The `Docker documentation on swarm key concepts`_ and `Docker "
"documentation on creating a swarm`_ can be referenced for further "
"instructions on setting up a swarm."
msgstr ""
#: ../../tutorials/docker.rst:214
msgid "Related topics"
msgstr ""
#: ../../tutorials/docker.rst:216
msgid "`Docker Home`_"
msgstr ""
#: ../../tutorials/docker.rst:217
msgid "`Docker Documentation`_"
msgstr ""
#: ../../tutorials/docker.rst:218
msgid "`Docker Hub`_"
msgstr ""
#: ../../tutorials/docker.rst:219
msgid "`Kata Containers`_"
msgstr ""
#~ msgid ""
#~ "|CL-ATTR| supports multiple containerization"
#~ " platforms, including a Docker\\* solution."
#~ " |CL| has many `unique features`_ "
#~ "including a minimal default installation, "
#~ "which makes it compelling to use "
#~ "as a host for container workloads, "
#~ "management, and orchestration."
#~ msgstr ""
#~ msgid "A basic understanding of Linux and Docker."
#~ msgstr ""
#~ msgid "Integration with Kata Containers (optional)"
#~ msgstr ""
#~ msgid ""
#~ "The proceeding sections of this tutorial"
#~ " are standard to Docker setup and "
#~ "configuration. If you are familiar with"
#~ " Docker basics, you do not need "
#~ "to continue reading. The following "
#~ "sections are provided here for sake "
#~ "of completeness."
#~ msgstr ""
#~ msgid ""
#~ "Perform additional Docker daemon configuration"
#~ " via a configuration file typically "
#~ "located at :file:`/etc/docker/daemon.json`. |CL| "
#~ "features a `stateless system`_ so the"
#~ " configuration file :file:`daemon.json` does "
#~ "*NOT* exist by default."
#~ msgstr ""
#~ msgid ""
#~ "`Docker Hub`_ is a publically available"
#~ " container image repository which comes "
#~ "preconfigured with Docker. In the "
#~ "example below we will pull and run"
#~ " an the official Docker image for "
#~ "nginx, an open source reverse proxy "
#~ "server."
#~ msgstr ""
#~ msgid ""
#~ "First, pull a container image from "
#~ "Docker Hub using the :command:`docker "
#~ "pull` command. Download the latest nginx"
#~ " Docker container image by running "
#~ "this command:"
#~ msgstr ""
#~ msgid "Run Docker\\* on |CL-ATTR|"
#~ msgstr ""
#~ msgid ""
#~ "Software in |CL| is offered in the"
#~ " form of `bundles`_ to provide a "
#~ "complete function. The *containers-basic* "
#~ "provides all the required software "
#~ "packages to run Docker images as "
#~ "containers."
#~ msgstr ""
#~ msgid ""
#~ "`Docker Hub`_ is a publically available"
#~ " container image repository which comes "
#~ "preconfigured with Docker. In the "
#~ "example below we will pull and run"
#~ " an the official Docker image for "
#~ "nginx\\*, an open source reverse proxy"
#~ " server."
#~ msgstr ""
@@ -0,0 +1,246 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-09-06 11:29-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/flatpak.rst:4
msgid "Flatpak\\*"
msgstr ""
#: ../../tutorials/flatpak.rst:6
msgid ""
"`Flatpak`_ is a framework for building and distributing desktop apps on "
"Linux\\*. It allows you to build a single app and install it on different"
" distributions of Linux. Flatpak apps are available through `Flathub`_ or"
" the `Clear Linux Store`_."
msgstr ""
#: ../../tutorials/flatpak.rst:11
msgid ""
"This tutorial shows how to install a Flatpak app on |CL| using Gnome\\* "
"Software and the command line."
msgstr ""
#: ../../tutorials/flatpak.rst:15
msgid "Prerequisites"
msgstr ""
#: ../../tutorials/flatpak.rst:17
msgid "|CL| installed on host system"
msgstr ""
#: ../../tutorials/flatpak.rst:19
msgid "Refer to :ref:`Get started <get-started>` for installation instructions."
msgstr ""
#: ../../tutorials/flatpak.rst:21
msgid "`desktop-autostart` bundle installed"
msgstr ""
#: ../../tutorials/flatpak.rst:23
msgid ""
"Flatpak is included via `desktop`, which is included in the `desktop-"
"autostart` bundle. The Flathub repository is pre-configured when the "
"`desktop-autostart` bundle is installed."
msgstr ""
#: ../../tutorials/flatpak.rst:27
msgid "Install the `desktop-autostart` bundle with the following command:"
msgstr ""
#: ../../tutorials/flatpak.rst:34
msgid "Install a Flatpak app with Gnome Software"
msgstr ""
#: ../../tutorials/flatpak.rst:36
msgid ""
"|CL| desktop comes with `Gnome Software` installed. Flatpak apps can be "
"installed from within `Gnome Software`."
msgstr ""
#: ../../tutorials/flatpak.rst:39
msgid "Launch `Gnome Software` from your desktop."
msgstr ""
#: ../../tutorials/flatpak.rst:41
msgid "Search for the Flatpak app that you want to install, as shown in Figure 1."
msgstr ""
#: ../../tutorials/flatpak.rst:47
msgid "Figure 1: Searching for Filezilla app in Gnome Software"
msgstr ""
#: ../../tutorials/flatpak.rst:49
msgid ""
"When you find the app you want to install, click it to view application "
"details."
msgstr ""
#: ../../tutorials/flatpak.rst:52
msgid ""
"On the app detail page, click the :guilabel:`Install` button, as shown in"
" Figure 2."
msgstr ""
#: ../../tutorials/flatpak.rst:59
msgid "Figure 2: Filezilla Flatpak detail page in Gnome Software"
msgstr ""
#: ../../tutorials/flatpak.rst:61
msgid ""
"After installation is complete, you will see the new application in your "
"Gnome applications list, as shown in Figure 3."
msgstr ""
#: ../../tutorials/flatpak.rst:68
msgid "Figure 3: Newly installed Filezilla application"
msgstr ""
#: ../../tutorials/flatpak.rst:70
msgid "Click the application icon to launch the application."
msgstr ""
#: ../../tutorials/flatpak.rst:73
msgid "Install a Flatpak with the command line"
msgstr ""
#: ../../tutorials/flatpak.rst:75
msgid ""
"Both Flathub and the Clear Linux Store provide the command line "
"instructions for installing a Flatpak. Figure 4 shows the command line "
"instructions to install Filezilla from the Clear Linux Store:"
msgstr ""
#: ../../tutorials/flatpak.rst:83
msgid ""
"Figure 4: Command line instructions to install Filezilla from the Clear "
"Linux Store"
msgstr ""
#: ../../tutorials/flatpak.rst:85
msgid "In this example, we install Filezilla."
msgstr ""
#: ../../tutorials/flatpak.rst:87
msgid "Open a terminal and enter the install command for the desired app:"
msgstr ""
#: ../../tutorials/flatpak.rst:93
msgid "You may be prompted to select which repository to use:"
msgstr ""
#: ../../tutorials/flatpak.rst:120
msgid "After installation, run the application with the following command:"
msgstr ""
#~ msgid "Use Flatpak\\* to install applications on |CL-ATTR|"
#~ msgstr ""
#~ msgid ""
#~ "This tutorial provides all the required"
#~ " steps to install Flatpak as well "
#~ "as downloading, installing, and running "
#~ "LibreOffice\\* on |CL-ATTR|."
#~ msgstr ""
#~ msgid ""
#~ "Please visit the `Flatpak website`_ for"
#~ " more information about Flatpak and "
#~ "how to use it. You can also "
#~ "`download it here`_."
#~ msgstr ""
#~ msgid "Before you begin"
#~ msgstr ""
#~ msgid ""
#~ "This tutorial assumes you have installed"
#~ " |CL| on your host system. For "
#~ "detailed instructions on installing |CL| "
#~ "on a bare metal system, visit our"
#~ " :ref:`bare metal installation guide "
#~ "<bare-metal-install-desktop>`."
#~ msgstr ""
#~ msgid "Install Flatpak on your host system"
#~ msgstr ""
#~ msgid ""
#~ "Flatpak is included as part of the"
#~ " bundle `desktop`. To install the "
#~ "application, log in to your user "
#~ "account and enter the following command:"
#~ msgstr ""
#~ msgid "Install and run the LibreOffice Flatpak image"
#~ msgstr ""
#~ msgid ""
#~ "Application developers have the option "
#~ "to bundle their applications using "
#~ "Flatpak to allow the installation of "
#~ "a single distribution of their "
#~ "application on different distributions of "
#~ "Linux, including |CL|. Flatpak provides "
#~ "a `list of applications`_ available "
#~ "through Flathub."
#~ msgstr ""
#~ msgid "|CL| enables the Flathub repository by default."
#~ msgstr ""
#~ msgid "Installing using gnome software"
#~ msgstr ""
#~ msgid ""
#~ "All you need to do is to "
#~ "launch `gnome software`, search for the"
#~ " LibreOffice app, and click the "
#~ "install button."
#~ msgstr ""
#~ msgid "Figure 1: Installing LibreOffice using gnome-software"
#~ msgstr ""
#~ msgid "Installing using the command line"
#~ msgstr ""
#~ msgid ""
#~ "Open the `gnome-terminal` and type "
#~ "the following command to install the "
#~ "LibreOffice app."
#~ msgstr ""
#~ msgid "Launch LibreOffice"
#~ msgstr ""
#~ msgid ""
#~ "A new set of icons will appear "
#~ "in your Gnome applications list titled"
#~ " :guilabel:`LibreOffice.` To execute the "
#~ "application, highlight the application and "
#~ "click on the :guilabel:`LibreOffice` icon. "
#~ "LibreOffice will start normally."
#~ msgstr ""
#~ msgid "Figure 2: Select :guilabel:`LibreOffice` app"
#~ msgstr ""
#~ msgid "Using the command line"
#~ msgstr ""
+206
View File
@@ -0,0 +1,206 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/fmv.rst:4
msgid "Function multi-versioning"
msgstr ""
#: ../../tutorials/fmv.rst:6
msgid ""
"CPU architectures often gain interesting new instructions as they evolve "
"but application developers find it difficult to take advantage of those "
"instructions. The reluctance to lose backward-compatibility is one of the"
" main roadblocks slowing developers from using advancements in newer "
"computing architectures. :abbr:`FMV (Function Multi-Versioning)`, which "
"first appeared in `GCC`_ 4.8, is a way to have multiple implementations "
"of a function, each using a different architecture specialized "
"instruction-set extensions. GCC 6 introduces changes to FMV to make it "
"even easier to bring architecture- based optimizations to the application"
" code."
msgstr ""
#: ../../tutorials/fmv.rst:16
msgid ""
"In this tutorial we will use FMV on general code and on :abbr:`FFT (Fast "
"Fourier Transform)` library code (FFTW). Upon completing the tutorial, "
"you will be able to use this technology on your code and use the "
"libraries to deploy architecture-based optimizations to your application "
"code."
msgstr ""
#: ../../tutorials/fmv.rst:22
msgid "Install and configure a |CL| host on bare metal"
msgstr ""
#: ../../tutorials/fmv.rst:23
msgid ""
"First, follow our guide to :ref:`bare-metal-install-desktop`. Once the "
"bare metal installation and initial configuration are complete, add the "
"`desktop-dev` bundle to the system. `desktop-dev`: contains the necessary"
" development tools like GCC and Perl\\*."
msgstr ""
#: ../../tutorials/fmv.rst:28
msgid ""
"To install the bundles, run the following command in the :file:`$HOME` "
"directory:"
msgstr ""
#: ../../tutorials/fmv.rst:36
msgid "Detect loop vectorization candidates"
msgstr ""
#: ../../tutorials/fmv.rst:38
msgid ""
"Now, we need to detect the loop vectorization candidates to be cloned for"
" multiple platforms with FMV. As an example, we will use the following "
"simple C code:"
msgstr ""
#: ../../tutorials/fmv.rst:67
msgid ""
"Save the example code as :file:`example.c` in the current directory and "
"build with the following flags:"
msgstr ""
#: ../../tutorials/fmv.rst:74
msgid "The build generates the following output:"
msgstr ""
#: ../../tutorials/fmv.rst:81
msgid "The output shows that line 11 is a good candidate for vectorization:"
msgstr ""
#: ../../tutorials/fmv.rst:89
msgid "Generate the FMV patch"
msgstr ""
#: ../../tutorials/fmv.rst:91
msgid ""
"To generate the FMV patch with the `make-fmv-patch`_ project, we must "
"clone the project and generate a log file with the loop vectorized "
"information:"
msgstr ""
#: ../../tutorials/fmv.rst:100
msgid "To generate the patch files, execute:"
msgstr ""
#: ../../tutorials/fmv.rst:106
msgid ""
"The :file:`make-fmv-patch.pl` script takes two arguments: `<buildlog>` "
"and `<sourcecode>`. Replace `<buildlog>` and `<sourcecode>` with the "
"proper values and execute:"
msgstr ""
#: ../../tutorials/fmv.rst:114
msgid "The command generates the following :file:`example.c.patch` patch:"
msgstr ""
#: ../../tutorials/fmv.rst:129
msgid ""
"We recommend you use the :file:`make-fmv-patch` script to add the "
"attribute generating the target clones on the function `foo`. Thus, we "
"can have the following code:"
msgstr ""
#: ../../tutorials/fmv.rst:158
msgid ""
"Changing the value of the `$avx2` variable, we can change the target "
"clones when adding the patches or in the :file:`make-fmv-patch.pl` "
"script:"
msgstr ""
#: ../../tutorials/fmv.rst:165
msgid ""
"Compile the code again with FMV and add the option to analyze the "
"`objdump` log:"
msgstr ""
#: ../../tutorials/fmv.rst:173
msgid "You can see the multiple clones of the `foo` function:"
msgstr ""
#: ../../tutorials/fmv.rst:181
msgid ""
"The cloned functions use AVX2 registers and vectorized instructions. To "
"verify, enter the following commands:"
msgstr ""
#: ../../tutorials/fmv.rst:190
msgid "FFT project example using FFTW"
msgstr ""
#: ../../tutorials/fmv.rst:192
msgid ""
"To follow the same approach with a package like FFTW, we must use the "
"`-fopt-info-vec` flag to get a build log file similar to:"
msgstr ""
#: ../../tutorials/fmv.rst:210
msgid ""
"For example, the :file:`fftw-3.3.6-pl2/tools/fftw-wisdom.c.patch` file "
"generates the following patches:"
msgstr ""
#: ../../tutorials/fmv.rst:262
msgid ""
"With these patches, we can select where to apply the FMV technology "
"making bringing architecture-based optimizations to application code even"
" easier."
msgstr ""
#: ../../tutorials/fmv.rst:265
msgid "**Congratulations!**"
msgstr ""
#: ../../tutorials/fmv.rst:267
msgid ""
"You have successfully installed an FMV development environment on |CL|. "
"Furthermore, you used cutting edge compiler technology to improve the "
"performance of your application based on Intel Architecture technology "
"and profiling of the specific execution of your application."
msgstr ""
#~ msgid ""
#~ "In this tutorial we will use FMV"
#~ " on general code and on :abbr:`FFT"
#~ " (Fast Fourier Transform)` library code."
#~ " Upon completing the tutorial, you "
#~ "will be able to use this "
#~ "technology on your code and use "
#~ "the libraries to deploy architecture-"
#~ "based optimizations to your application "
#~ "code."
#~ msgstr ""
#~ msgid "FTT project example"
#~ msgstr ""
#~ msgid ""
#~ "To follow the same approach with a"
#~ " package like FFT, we must use "
#~ "the `-fopt-info-vec` flag to get"
#~ " a build log file similar to:"
#~ msgstr ""
#~ msgid "Use the function multi-version patch generator"
#~ msgstr ""
@@ -0,0 +1,36 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/index.rst:4
msgid "Tutorials"
msgstr ""
#: ../../tutorials/index.rst:6
msgid "Explore our tutorials to discover what you can do with |CL|!"
msgstr ""
#: ../../tutorials/index.rst:15
msgid "Archive"
msgstr ""
#: ../../tutorials/index.rst:17
msgid "Older tutorials that may still be relevant to some users."
msgstr ""
+166
View File
@@ -0,0 +1,166 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/kata.rst:4
msgid "Kata Containers\\*"
msgstr ""
#: ../../tutorials/kata.rst:6
msgid ""
"This tutorial describes how to install, configure, and run `Kata "
"Containers`_ on |CL-ATTR|."
msgstr ""
#: ../../tutorials/kata.rst:14
msgid "Description"
msgstr ""
#: ../../tutorials/kata.rst:16
msgid ""
"Kata Containers is an open source project developing a lightweight "
"implementation of :abbr:`VMs (Virtual Machines)` that offer the speed of "
"containers and the security of VMs."
msgstr ""
#: ../../tutorials/kata.rst:21
msgid "Prerequisites"
msgstr ""
#: ../../tutorials/kata.rst:23
msgid ""
"This tutorial assumes you have installed |CL| on your host system. For "
"detailed instructions on installing |CL| on a bare metal system, follow "
"the :ref:`bare metal installation tutorial<bare-metal-install-desktop>`."
msgstr ""
#: ../../tutorials/kata.rst:27
msgid ""
"If you have Clear Containers installed on your |CL| system, then follow "
"the :ref:`migrate Clear Containers to Kata Containers "
"tutorial<kata_migration>`."
msgstr ""
#: ../../tutorials/kata.rst:30
msgid ""
"Before you install any new packages, update |CL| with the following "
"command:"
msgstr ""
#: ../../tutorials/kata.rst:37
msgid "Install Kata Containers"
msgstr ""
#: ../../tutorials/kata.rst:39
msgid ""
"Kata Containers is included in the :file:`containers-virt` bundle. To "
"install the framework, enter the following command:"
msgstr ""
#: ../../tutorials/kata.rst:46
msgid "Restart the Docker\\* and Kata Containers systemd services."
msgstr ""
#: ../../tutorials/kata.rst:54
msgid "Run Kata Containers"
msgstr ""
#: ../../tutorials/kata.rst:62
msgid ""
"If you use a proxy server and your proxy environment variables are "
"already set, run the following commands as a shell script to configure "
"Docker:"
msgstr ""
#: ../../tutorials/kata.rst:79
msgid "**Congratulations!**"
msgstr ""
#: ../../tutorials/kata.rst:81
msgid "You've successfully installed and set up Kata Containers on |CL|."
msgstr ""
#: ../../tutorials/kata.rst:84
msgid "More information about Docker"
msgstr ""
#: ../../tutorials/kata.rst:86
msgid ""
"Docker on |CL| provides a :file:`docker.service` file to start the Docker"
" daemon. The daemon will use runc or kata-runtime depending on the "
"environment:"
msgstr ""
#: ../../tutorials/kata.rst:90
msgid ""
"If you are running |CL| on bare metal or on a VM with Nested "
"Virtualization activated, Docker uses kata-runtime as the default "
"runtime."
msgstr ""
#: ../../tutorials/kata.rst:93
msgid ""
"If you are running |CL| on a VM without Nested Virtualization, Docker "
"uses runc as the default runtime."
msgstr ""
#: ../../tutorials/kata.rst:96
msgid ""
"You do not need to manually configure the runtime for Docker, because it "
"automatically uses the runtime supported by the system."
msgstr ""
#: ../../tutorials/kata.rst:100
msgid "Troubleshooting"
msgstr ""
#: ../../tutorials/kata.rst:102
msgid ""
"To change the Docker storage driver, see :ref:`additional-docker-"
"configuration`."
msgstr ""
#: ../../tutorials/kata.rst:105
msgid ""
"For some |CL| versions before 27000, you may need to manually configure "
"Docker\\* to use Kata Containers by default."
msgstr ""
#: ../../tutorials/kata.rst:108
msgid "To do so, enter:"
msgstr ""
#: ../../tutorials/kata.rst:118
msgid "To check the version of |CL| on your system, enter:"
msgstr ""
#~ msgid "Install Kata Containers\\*"
#~ msgstr ""
#~ msgid ""
#~ "This tutorial describes how to install,"
#~ " configure, and run `Kata Containers`_ "
#~ "on |CL-ATTR|. Kata Containers is "
#~ "an open source project developing a "
#~ "lightweight implementation of :abbr:`VMs "
#~ "(Virtual Machines)` that offer the speed"
#~ " of containers and the security of"
#~ " VMs."
#~ msgstr ""
@@ -0,0 +1,140 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/kubernetes-bp.rst:4
msgid "Kubernetes\\* Best Practices"
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:7
msgid "Use swupd to update clusters"
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:9
msgid ""
"This tutorial shows you how to manage your Kubernetes cluster while using"
" :command:`swupd` to update |CL-ATTR|."
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:12
msgid ""
"In our tutorial :ref:`kubernetes`, we explain how to set up a Kubernetes "
"cluster on |CL| using `kubeadm`. `Kubeadm documentation`_ often builds on"
" the assumption that the distribution uses a traditional package manager "
"(e.g., RPM/DEB)."
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:17
msgid ""
"In contrast, |CL| uses `swupd` to update the OS, which in this case "
"updates all of the kubernetes node and client binaries simultaneously, as"
" part of the `cloud-native-basic` bundle (e.g., kubectl, kubeadm, "
"kubelet). Running :command:`sudo swupd update` requires special care to "
"ensure the OS incorporates the latest Kubernetes upgrades."
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:23
msgid ""
"This document describes best practices to manage cluster upgrades with "
"`kubeadm` on a |CL|-based cluster."
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:27
msgid "Prerequisites"
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:29
msgid "Assure that you:"
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:31
msgid "Completed :ref:`kubernetes`"
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:32
msgid "Installed the bundle `cloud-native-basic`"
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:36
msgid ""
"Other Linux\\* distros shown in Kubernetes upgrade documentation reflect "
"`apt-get update`, `apt-mark hold kubeadm`, and similar commands; however,"
" such commands **are not valid** on |CL|."
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:40
msgid "Update the control plane"
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:42
msgid "Read kubernetes documentation `before you begin`_."
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:44
msgid "On your master node, run the command:"
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:52
msgid ""
"If the minor version of Kubernetes changes, |CL| shows a message-of-the-"
"day, or `motd`. When the `motd` appears, you **must postpone** a kubelet "
"restart on master and nodes until the control plane is properly updated. "
":command:`swupd update` does not restart services automatically unless "
"explicitly configured to do so."
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:54
msgid "Now follow these instructions in kubernetes documentation."
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:56
msgid "`Upgrade control plane`_"
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:57
msgid "`Drain control plane node`_"
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:58 ../../tutorials/kubernetes-bp.rst:73
msgid "`Restart Kubelet and undrain node`_"
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:61
msgid "Update worker nodes"
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:63
msgid "On each worker node, run the command:"
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:69
msgid "Now follow these instructions in kubernetes documentation:"
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:71
msgid "`Drain node`_"
msgstr ""
#: ../../tutorials/kubernetes-bp.rst:72
msgid "`Update kubelet configuration`_"
msgstr ""
#~ msgid "Kubernetes Best Practices on |CL|"
#~ msgstr ""
@@ -0,0 +1,527 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/kubernetes.rst:4
msgid "Kubernetes\\*"
msgstr ""
#: ../../tutorials/kubernetes.rst:6
msgid ""
"This tutorial describes how to install, configure, and run the "
"`Kubernetes container orchestration system`_ on |CL-ATTR| using CRI+O and"
" kata-runtime."
msgstr ""
#: ../../tutorials/kubernetes.rst:15
msgid "Description"
msgstr ""
#: ../../tutorials/kubernetes.rst:17
msgid ""
"Kubernetes is an open source system for automating deployment, scaling, "
"and management of containerized applications. It groups containers that "
"make up an application into logical units for easy management and "
"discovery. Get up and running quickly with our `Cloud native setup "
"automation`_."
msgstr ""
#: ../../tutorials/kubernetes.rst:22
msgid ""
"Kata Containers\\* kata-runtime adheres to :abbr:`OCI (Open Container "
"Initiative*)` guidelines and works seamlessly with Kubernetes. `Kata "
"Containers`_ provides strong isolation for untrusted workloads or multi-"
"tenant scenarios. Kata Containers can be allocated on a per-pod basis, so"
" you can mix and match both on the same host to suit your needs."
msgstr ""
#: ../../tutorials/kubernetes.rst:30
msgid "Prerequisites"
msgstr ""
#: ../../tutorials/kubernetes.rst:32
msgid ""
"This tutorial assumes you have already installed |CL|. For detailed "
"instructions on installing |CL| on a bare metal system, follow the "
":ref:`bare metal installation tutorial<bare-metal-install-desktop>`. "
"Learn about the benefits of having an up-to-date system for cloud "
"orchestration on the :ref:`swupd-guide` page."
msgstr ""
#: ../../tutorials/kubernetes.rst:38
msgid ""
"Before you install any new packages, update |CL| with the following "
"command:"
msgstr ""
#: ../../tutorials/kubernetes.rst:45
msgid "Install Kubernetes and CRI runtimes"
msgstr ""
#: ../../tutorials/kubernetes.rst:47
msgid ""
"Kubernetes, a set of supported :abbr:`CRI (Container Runtime Interface)` "
"runtimes, and networking plugins, are included in the `cloud-native-"
"basic`_ bundle."
msgstr ""
#: ../../tutorials/kubernetes.rst:51
msgid "To install this framework, enter the following command:"
msgstr ""
#: ../../tutorials/kubernetes.rst:59
msgid "For more on networking plugins, see `Install pod network add-on`_."
msgstr ""
#: ../../tutorials/kubernetes.rst:62
msgid "Configure Kubernetes"
msgstr ""
#: ../../tutorials/kubernetes.rst:64
msgid ""
"This tutorial uses the basic default Kubernetes configuration for "
"simplicity. You must define your Kubernetes configuration according to "
"your specific deployment and your security needs."
msgstr ""
#: ../../tutorials/kubernetes.rst:68
msgid "Enable IP forwarding to avoid kubeadm `preflight check`_ errors:"
msgstr ""
#: ../../tutorials/kubernetes.rst:70
msgid ""
"Create (or edit if it exists) the file :file:`/etc/sysctl.d/60-k8s.conf` "
"and include the following line:"
msgstr ""
#: ../../tutorials/kubernetes.rst:77
msgid "Apply the change:"
msgstr ""
#: ../../tutorials/kubernetes.rst:83
msgid "Enable the kubelet service:"
msgstr ""
#: ../../tutorials/kubernetes.rst:89
msgid "Disable swap using one of the following methods, either:"
msgstr ""
#: ../../tutorials/kubernetes.rst:91
msgid "Temporarily:"
msgstr ""
#: ../../tutorials/kubernetes.rst:99
msgid "Swap will be enabled at next reboot, causing failures in your cluster."
msgstr ""
#: ../../tutorials/kubernetes.rst:102
msgid "or:"
msgstr ""
#: ../../tutorials/kubernetes.rst:104
msgid "Permanently:"
msgstr ""
#: ../../tutorials/kubernetes.rst:106
msgid "Mask the swap partition:"
msgstr ""
#: ../../tutorials/kubernetes.rst:115
msgid ""
"On systems with limited resources, some performance degradation may be "
"observed while swap is disabled."
msgstr ""
#: ../../tutorials/kubernetes.rst:118
msgid "Switch to root to modify the `hosts` file:"
msgstr ""
#: ../../tutorials/kubernetes.rst:124
msgid ""
"Create (or edit if it exists) the hosts file that Kubernetes will read to"
" locate the master's host:"
msgstr ""
#: ../../tutorials/kubernetes.rst:131
msgid "Exit root:"
msgstr ""
#: ../../tutorials/kubernetes.rst:138
msgid "Configure and run Kubernetes"
msgstr ""
#: ../../tutorials/kubernetes.rst:140
msgid ""
"This section describes how to configure and run Kubernetes with CRI-O and"
" kata-runtime."
msgstr ""
#: ../../tutorials/kubernetes.rst:144
msgid "Configure and run CRI-O + kata-runtime"
msgstr ""
#: ../../tutorials/kubernetes.rst:146
msgid "Enable the CRI-O service:"
msgstr ""
#: ../../tutorials/kubernetes.rst:152
msgid "Enter the commands:"
msgstr ""
#: ../../tutorials/kubernetes.rst:159
msgid ""
"Initialize the master control plane with the command below and follow the"
" displayed instructions to set up `kubectl`:"
msgstr ""
#: ../../tutorials/kubernetes.rst:166
msgid "Register kata-runtime as a RuntimeClass handler:"
msgstr ""
#: ../../tutorials/kubernetes.rst:185
msgid "Install pod network add-on"
msgstr ""
#: ../../tutorials/kubernetes.rst:187
msgid ""
"You must choose and install a `pod network add-on`_ to allow your pods to"
" communicate. Check whether or not your add-on requires special flags "
"when you initialize the master control plane."
msgstr ""
#: ../../tutorials/kubernetes.rst:191
msgid "**Notes about flannel add-on**"
msgstr ""
#: ../../tutorials/kubernetes.rst:193
msgid ""
"If you choose the `flannel` add-on, then you must add the following to "
"the `kubeadm init` command:"
msgstr ""
#: ../../tutorials/kubernetes.rst:200
msgid ""
"Furthermore, if you are using CRI-O and `flannel` and you want to use "
"Kata Containers, edit the :file:`/etc/crio/crio.conf` file to add:"
msgstr ""
#: ../../tutorials/kubernetes.rst:209
msgid "Use your cluster"
msgstr ""
#: ../../tutorials/kubernetes.rst:211
msgid ""
"Once your master control plane is successfully initialized, instructions "
"on how to use your cluster and its *IP*, *token*, and *hash* values are "
"displayed. It is important that you record the cluster values because "
"they are needed when joining worker nodes to the cluster. Some values "
"have a valid period. The values are presented in a format similar to:"
msgstr ""
#: ../../tutorials/kubernetes.rst:221
msgid "**Congratulations!**"
msgstr ""
#: ../../tutorials/kubernetes.rst:223
msgid ""
"You've successfully installed and set up Kubernetes in |CL| using CRI-O "
"and kata-runtime. You are now ready to follow on-screen instructions to "
"deploy a pod network to the cluster and join worker nodes with the "
"displayed token and IP information."
msgstr ""
#: ../../tutorials/kubernetes.rst:229
msgid "Related topics"
msgstr ""
#: ../../tutorials/kubernetes.rst:231
msgid "Read the Kubernetes documentation to learn more about:"
msgstr ""
#: ../../tutorials/kubernetes.rst:233
msgid "Deploying Kubernetes with a `cloud-native-setup`_"
msgstr ""
#: ../../tutorials/kubernetes.rst:235
msgid ":ref:`Kubernetes best practices <kubernetes-bp>`"
msgstr ""
#: ../../tutorials/kubernetes.rst:237
msgid "`Understanding basic Kubernetes architecture`_"
msgstr ""
#: ../../tutorials/kubernetes.rst:239
msgid "`Deploying an application to your cluster`_"
msgstr ""
#: ../../tutorials/kubernetes.rst:241
msgid "Installing a `pod network add-on`_"
msgstr ""
#: ../../tutorials/kubernetes.rst:243
msgid "`Joining your nodes`_"
msgstr ""
#: ../../tutorials/kubernetes.rst:246
msgid "Cloud native setup automation"
msgstr ""
#: ../../tutorials/kubernetes.rst:248
msgid ""
"Optional: Clone the `cloud-native-setup`_ repository on your system and "
"follow the instructions. This repository includes helper scripts to "
"automate configuration."
msgstr ""
#: ../../tutorials/kubernetes.rst:253
msgid "Package configuration customization (optional)"
msgstr ""
#: ../../tutorials/kubernetes.rst:255
msgid ""
"|CL| is a stateless system that looks for user-defined package "
"configuration files in the :file:`/etc/<package-name>` directory to be "
"used as default. If user-defined files are not found, |CL| uses the "
"distribution-provided configuration files for each package."
msgstr ""
#: ../../tutorials/kubernetes.rst:260
msgid ""
"If you customize any of the default package configuration files, you "
"**must** store the customized files in the :file:`/etc/` directory. If "
"you edit any of the distribution-provided default files, your changes "
"will be lost in the next system update."
msgstr ""
#: ../../tutorials/kubernetes.rst:265
msgid ""
"For example, to customize CRI-O configuration in your system, run the "
"following commands:"
msgstr ""
#: ../../tutorials/kubernetes.rst:274
msgid "Learn more about :ref:`stateless` in |CL|."
msgstr ""
#: ../../tutorials/kubernetes.rst:277
msgid "Proxy configuration (optional)"
msgstr ""
#: ../../tutorials/kubernetes.rst:279
msgid ""
"If you use a proxy server, you must set your proxy environment variables "
"and create an appropriate proxy configuration file for both CRI-O "
"services. Consult your IT department if you are behind a corporate proxy "
"for the appropriate values. Ensure that your local IP is **explicitly "
"included** in the environment variable *NO_PROXY*. (Setting *localhost* "
"is not enough.)"
msgstr ""
#: ../../tutorials/kubernetes.rst:285
msgid ""
"If you have already set your proxy environment variables, run the "
"following commands as a shell script to configure all of these services "
"in one step:"
msgstr ""
#: ../../tutorials/kubernetes.rst:303
msgid "Troubleshooting"
msgstr ""
#: ../../tutorials/kubernetes.rst:305
msgid "<HOSTNAME> not found in <IP> message."
msgstr ""
#: ../../tutorials/kubernetes.rst:307
msgid ""
"Your DNS server may not be appropriately configured. Try adding an entry "
"to the :file:`/etc/hosts` file with your host's IP and Name."
msgstr ""
#: ../../tutorials/kubernetes.rst:310
msgid "For example: 100.200.50.20 myhost"
msgstr ""
#: ../../tutorials/kubernetes.rst:312
msgid ""
"Use the commands :command:`hostname` and :command:`hostname -I` to "
"retrieve them."
msgstr ""
#: ../../tutorials/kubernetes.rst:315
msgid "Images cannot be pulled."
msgstr ""
#: ../../tutorials/kubernetes.rst:317
msgid ""
"You may be behind a proxy server. Try configuring your proxy settings, "
"using the environment variables *HTTP_PROXY*, *HTTPS_PROXY*, and "
"*NO_PROXY* as required in your environment."
msgstr ""
#: ../../tutorials/kubernetes.rst:321
msgid "Connection refused error."
msgstr ""
#: ../../tutorials/kubernetes.rst:323
msgid ""
"If you are behind a proxy server, you may need to add the master's IP to "
"the environment variable *NO_PROXY*."
msgstr ""
#: ../../tutorials/kubernetes.rst:326
msgid "Connection timed-out or Access Refused errors."
msgstr ""
#: ../../tutorials/kubernetes.rst:328
msgid ""
"You must ensure that the appropriate proxy settings are available from "
"the same terminal where you will initialize the control plane. To verify "
"the proxy settings that Kubernetes will actually use, run the commands:"
msgstr ""
#: ../../tutorials/kubernetes.rst:338
msgid ""
"If the displayed proxy values are different from your assigned values, "
"the cluster initialization will fail. Contact your IT support team to "
"learn how to set the proxy variables permanently, and how to make them "
"available for all the types of access that you will use, such as remote "
"SSH access."
msgstr ""
#: ../../tutorials/kubernetes.rst:343
msgid ""
"If the result of the above commands is blank, you may need to add a "
"``profile`` to the :file:`/etc` directory. To do so, follow these steps."
msgstr ""
#: ../../tutorials/kubernetes.rst:346
msgid "Create a `profile` in :file:`/etc`"
msgstr ""
#: ../../tutorials/kubernetes.rst:352
msgid ""
"With your preferred editor, open `profile`, and enter your proxy "
"settings. An example is shown below."
msgstr ""
#: ../../tutorials/kubernetes.rst:364
msgid "<master IP> can be obtained by running :command:`ifconfig`."
msgstr ""
#: ../../tutorials/kubernetes.rst:366
msgid "Save and exit the `profile`."
msgstr ""
#: ../../tutorials/kubernetes.rst:368
msgid ""
"Update your system's environment settings by executing the following "
"command:"
msgstr ""
#: ../../tutorials/kubernetes.rst:375
msgid "To ensure your system isn't running previous session variables, run:"
msgstr ""
#: ../../tutorials/kubernetes.rst:381
msgid "Continue below while passing `-E` in the command as shown."
msgstr ""
#: ../../tutorials/kubernetes.rst:383
msgid "Missing environment variables."
msgstr ""
#: ../../tutorials/kubernetes.rst:385
msgid ""
"If you are behind a proxy server, pass environment variables by adding "
"*-E* to the command that initializes the master control plane."
msgstr ""
#~ msgid ""
#~ "Learn more about `Stateless`_ in |CL|"
#~ " and view the |CL| `documentation`_."
#~ msgstr ""
#~ msgid "Run Kubernetes\\*"
#~ msgstr ""
#~ msgid ""
#~ "Kubernetes\\* is an open source system"
#~ " for automating deployment, scaling, and"
#~ " management of containerized applications. "
#~ "It groups containers that make up "
#~ "an application into logical units for"
#~ " easy management and discovery."
#~ msgstr ""
#~ msgid ""
#~ "Kata Containers\\* kata-runtime adheres "
#~ "to :abbr:`OCI (Open Container Initiative*)`"
#~ " guidelines and work seamlessly with "
#~ "Kubernetes. `Kata Containers`_ provide strong"
#~ " isolation for untrusted workloads or "
#~ "multi-tenant scenarios. Kata Containers "
#~ "can be allocated on a per-pod "
#~ "basis so you can mix and match "
#~ "both on the same host to suit "
#~ "your needs."
#~ msgstr ""
#~ msgid ""
#~ "This tutorial assumes you have already"
#~ " installed |CL|. For detailed instructions"
#~ " on installing |CL| on a bare "
#~ "metal system, follow the :ref:`bare "
#~ "metal installation tutorial<bare-metal-"
#~ "install-desktop>`. Learn about the benefits"
#~ " of having an up-to-date system"
#~ " for cloud orchestration on the :ref"
#~ ":`swupd-about` page."
#~ msgstr ""
#~ msgid "Cloud native setup automation (optional)"
#~ msgstr ""
#~ msgid ""
#~ "Clone the `cloud-native-setup`_ "
#~ "repository on your system and follow "
#~ "the instructions. This repository includes "
#~ "helper scripts to automate configuration."
#~ msgstr ""
#~ msgid ""
#~ "Learn more about :ref:`stateless` in "
#~ "|CL| and view the |CL| `documentation`_."
#~ msgstr ""
#~ msgid "Next steps"
#~ msgstr ""
#~ msgid ":ref:`kubernetes-bp`"
#~ msgstr ""
#~ msgid ""
#~ "With a preferred editor, open `profile`,"
#~ " and enter your proxy settings. "
#~ "Example shown below."
#~ msgstr ""
#~ msgid "Run:"
#~ msgstr ""
@@ -0,0 +1,338 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/nvidia-cuda.rst:4
msgid "NVIDIA\\* CUDA Toolkit"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:6
msgid ""
"NVIDIA is a manufacturer of graphics processing units (GPU), also known "
"as graphics cards."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:9
msgid ""
"CUDA is a parallel computing platform and application programming "
"interface model created by NVIDIA. It allows software developers and "
"software engineers to use a CUDA-enabled graphics processing unit"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:13
msgid ""
"These instructions show how to install the CUDA Toolkit on |CL| after the"
" :ref:`proprietary NVIDIA drivers <nvidia>` have been installed."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:18
msgid ""
"Software installed outside of :ref:`swupd <swupd-guide>` is not updated "
"with |CL| updates and must be updated and maintained manually."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:29
msgid "Prerequisites"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:31
msgid ""
"A |CL| system with a `CUDA-Enabled NVIDIA device "
"<https://developer.nvidia.com/cuda-gpus>`_"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:32
msgid "The :ref:`proprietary NVIDIA drivers <nvidia>` have been installed."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:38
msgid "Compatibility"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:41
msgid "Check compatibility of NVIDIA components"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:43
msgid ""
"To install the appropriate NVIDIA CUDA Toolkit version, it is important "
"to understand the compute capability and compatible driver versions of "
"your NVIDIA hardware."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:47
msgid ""
"Information about NVIDIA compute capability, driver, and toolkit "
"compatibility can be found at: https://developer.nvidia.com/cuda-gpus "
"and https://docs.nvidia.com/deploy/cuda-compatibility/"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:54
msgid "Check GCC compatibility"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:58
msgid ""
"This is only required for the development or compilation of CUDA "
"applications. It is not required to run pre-built applications that have "
"a dependency on CUDA."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:62
msgid "From the NVIDIA documentation:"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:64
msgid ""
"The CUDA development environment relies on tight integration with the "
"host development environment, including the host compiler and C runtime "
"libraries, and is therefore only supported on distribution versions that "
"have been qualified for this CUDA Toolkit release."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:69
msgid ""
"Refer to the `NVIDIA documentation on CUDA system requirements "
"<https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html"
"#system-requirements>`_ for the latest kernel and compiler compatibility."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:73
msgid ""
"For example, CUDA 10.1 on a system with the latest Linux kernel requires "
"GCC7, which is older than the default GCC version for |CL|."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:76
msgid "Install the compatible version of GCC, if required:"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:78
msgid "Install the :ref:`bundle <bundles>` with the appropriate GCC version."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:84
msgid "Create the directory :file:`/usr/local/cuda/bin`:"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:91
msgid ""
"Add symlinks to the older GCC version in the :file:`/usr/local/cuda/bin` "
"directory. This will cause the older version of GCC to be used when "
":file:`/usr/local/cuda/bin` is in the $PATH environment variable."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:103
msgid "Downloading and Installation"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:107
msgid "Download the NVIDIA CUDA Toolkit"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:109
msgid ""
"Go to the `NVIDIA CUDA downloads website`_ to get the latest CUDA "
"Toolkit. If an older version of the CUDA Toolkit is required, go to the "
"`CUDA Toolkit Archive <https://developer.nvidia.com/cuda-toolkit-"
"archive>`_."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:113
msgid "Choose the following settings and click *Download*."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:115
msgid "Operating System: *Linux*"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:116
msgid "Architecture: *x86_64*"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:117
msgid "Distribution: *any*"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:118
msgid "Version: *any*"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:119
msgid "Installer Type: *runfile(local)*"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:123
msgid ""
"Open a terminal and navigate to where the "
":file:`cuda_<VERSION>_linux.run` file was saved. In this example, it was "
"saved in the Downloads folder."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:131
msgid "Make the :file:`cuda_<VERSION>_linux.run` file executable:"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:140
msgid "Install the NVIDIA CUDA Toolkit"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:142
msgid ""
"The NVIDIA CUDA installer will be directed to install files under "
":file:`/opt/cuda` as much as possible to keep its contents isolated from "
"the rest of the |CL| files under :file:`/usr`."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:146
msgid ""
"The CUDA installer automatically creates a symbolic link that allows the "
"CUDA Toolkit to be accessed from :file:`/usr/local/cuda` regardless of "
"where it was installed."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:151
msgid ""
"Configure the dynamic linker to look for and cache shared libraries under"
" :file:`/opt/cuda/lib64` where the NVIDIA installer will place libraries."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:160
msgid ""
"The CUDA installer will automatically create a file "
":file:`/etc/ld.so.conf.d/cuda-<VERSION>.conf`"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:163
msgid "Navigate into the directory where the NVIDIA installer was downloaded:"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:170
msgid "Run the installer with the advanced options below:"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:182
msgid ""
"Validate the CUDA Toolkit was installed by checking the NVIDIA CUDA "
"compiler version:"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:190
msgid ""
"The CUDA Toolkit is now installed and can be used to compile and run CUDA"
" applications."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:195
msgid "Using the NVIDIA CUDA Toolkit"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:197
msgid ""
"Verify that the NVIDIA device characters files /dev/nvidia* exist and "
"have the correct (0666) file permissions. The character devices should be"
" automatically created on system with the NVIDIA driver loaded through X "
"server, but will not be on systems that do not automatically load the "
"NVIDIA driver."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:208
msgid ""
"If your system does not have the NVIDIA character devices created "
"automatically, run the `script from NVIDIA documentation "
"<https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html"
"#runfile-verifications>`_ with root privileges."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:214
msgid ""
"Alternatively a setuid utility, :command:`nvidia-modprobe`, can be "
"compiled and installed to automatically create the device character files"
" on-demand."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:227
msgid ""
"When the CUDA toolkit is needed, export PATH variables pointing to the "
"CUDA directories. This will temporarily add CUDA files to the PATH and "
"use the specified linked version of GCC for the terminal session."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:237
msgid ""
"Source code for CUDA sample located at "
":file:`/usr/local/cuda/NVIDIA_CUDA-<VERSION>_Samples`. See the `CUDA "
"documentation on compiling samples <https://docs.nvidia.com/cuda/cuda-"
"installation-guide-linux/index.html#compiling-examples>`_ to learn more."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:245
msgid "Uninstalling"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:247
msgid ""
"The NVIDIA drivers and associated software can be uninstalled and nouveau"
" driver restored by:"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:250
msgid "Run the :command:`sudo /usr/local/cuda/bin/cuda-uninstaller`."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:252
msgid "Follow the prompts on the screen and reboot the system."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:256
msgid "Debugging"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:258
msgid ""
"The NVIDIA CUDA installer places logs under :file:`/tmp/cuda-"
"installer.log`."
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:263
msgid "Additional resources"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:264
msgid "`NVIDIA CUDA Toolkit Documentation <https://docs.nvidia.com/cuda/>`_"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:266
msgid ""
"`Why aren't the NVIDIA Linux drivers open source? "
"<https://nvidia.custhelp.com/app/answers/detail/a_id/1849/kw/Linux>`_"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:268
msgid ""
"`Where can I get support for NVIDIA Linux drivers? "
"<https://nvidia.custhelp.com/app/answers/detail/a_id/44/kw/linux>`_"
msgstr ""
#: ../../tutorials/nvidia-cuda.rst:270
msgid ""
"`NVIDIA Accelerated Linux Graphics Driver Installation Guides "
"<https://download.nvidia.com/XFree86/Linux-x86_64/>`_"
msgstr ""
@@ -0,0 +1,531 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/nvidia.rst:4
msgid "NVIDIA\\* Drivers"
msgstr ""
#: ../../tutorials/nvidia.rst:6
msgid ""
"NVIDIA manufactures graphics processing units (GPU), also known as "
"graphics cards."
msgstr ""
#: ../../tutorials/nvidia.rst:9
msgid ""
"NVIDIA devices on Linux\\* have two popular device driver options: the "
"opensource drivers from the `nouveau project`_ or the proprietary drivers"
" published by NVIDIA. The nouveau drivers are built into the |CL-ATTR| "
"kernel and are loaded automatically at system boot if a compatible card "
"is detected."
msgstr ""
#: ../../tutorials/nvidia.rst:15
msgid ""
"These instructions show how to use the proprietary NVIDIA drivers, which "
"require a manual installation."
msgstr ""
#: ../../tutorials/nvidia.rst:20
msgid ""
"Software installed outside of :ref:`swupd <swupd-guide>` is not updated "
"with |CL| updates and must be updated and maintained manually."
msgstr ""
#: ../../tutorials/nvidia.rst:23
msgid ""
"For example, the file :file:`/usr/lib/libGL.so` conflicts with the file "
"provided by the mesa package in |CL| and the file NVIDIA provides. If a "
"|CL| update overwrites these files, a reinstallation of the NVIDIA driver"
" might be required."
msgstr ""
#: ../../tutorials/nvidia.rst:32
msgid "Prerequisites"
msgstr ""
#: ../../tutorials/nvidia.rst:34
msgid "A |CL| system with a desktop installed"
msgstr ""
#: ../../tutorials/nvidia.rst:35
msgid "An NVIDIA device installed"
msgstr ""
#: ../../tutorials/nvidia.rst:38
msgid "Install DKMS"
msgstr ""
#: ../../tutorials/nvidia.rst:40
msgid ""
"The :ref:`Dynamic Kernel Module System (DKMS) <kernel-modules-dkms>` "
"allows the NVIDIA kernel modules to be automatically integrated when "
"kernel updates occur in |CL|."
msgstr ""
#: ../../tutorials/nvidia.rst:44
msgid "Install the appropriate DKMS bundle using the instructions below:"
msgstr ""
#: ../../tutorials/nvidia.rst:47
msgid ""
"The Long Term Support (LTS) kernel variant is more likely to remain "
"compatible between updates with NVIDIA drivers."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:3
msgid ""
"The :command:`kernel-native-dkms` bundle provides the :command:`dkms` "
"program and Linux kernel headers, which are required for compiling kernel"
" modules."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:6
msgid "The :command:`kernel-native-dkms` bundle also:"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:8
msgid ""
"Adds a `systemd` update trigger (:file:`/usr/lib/systemd/system/dkms-new-"
"kernel.service`) to automatically run DKMS to rebuild modules after a "
"kernel upgrade occurs with :ref:`swupd update <swupd-guide>`."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:13
msgid ""
"Disables kernel module signature verification by appending a kernel "
"command-line parameter (:command:`module.sig_unenforce`) from the "
":file:`/usr/share/kernel/cmdline.d/clr-ignore-mod-sig.conf` file."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:17
msgid ""
"Adds a notification to the Message of the Day (MOTD) indicating kernel "
"module signature verification is disabled."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:22
msgid ""
"We recommend that you always review the :command:`swupd update` output to"
" make sure kernel modules were successfully rebuilt against the new "
"kernel. This is especially important for systems where a successful boot "
"relies on a kernel module."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:27
msgid ""
"Install the :command:`kernel-native-dkms` or :command:`kernel-lts-dkms` "
"bundle:"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:30
msgid ""
"Determine which kernel variant is running on |CL|. Only the *native* and "
"*lts* kernels are enabled to build and load out-of-tree kernel modules "
"with DKMS."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:39
msgid "Ensure *.native* or *.lts* is in the kernel name."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:41
msgid ""
"Install the DKMS bundle corresponding to the installed kernel. Use "
":command:`kernel-native-dkms` for the native kernel or :command:`kernel-"
"lts-dkms` for the lts kernel."
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:49
msgid "or"
msgstr ""
#: ../../guides/kernel/kernel-modules-dkms.rst:56
msgid "Update the |CL| bootloader and reboot."
msgstr ""
#: ../../tutorials/nvidia.rst:55
msgid "Download and install the NVIDIA drivers"
msgstr ""
#: ../../tutorials/nvidia.rst:58
msgid "Download the NVIDIA drivers for Linux"
msgstr ""
#: ../../tutorials/nvidia.rst:60
msgid "Identify the NVIDIA GPU model that is installed."
msgstr ""
#: ../../tutorials/nvidia.rst:66
msgid ""
"Go to the `NVIDIA Driver Downloads website`_ . Search for and download "
"the appropriate driver based on the NVIDIA GPU model you have with *Linux"
" 64-bit* selected as the Operating System ."
msgstr ""
#: ../../tutorials/nvidia.rst:70
msgid ""
"Open a terminal and navigate to where the :file:`NVIDIA-"
"Linux-x86_64-<VERSION>.run` file was saved. In this example, it was saved"
" in the Downloads folder."
msgstr ""
#: ../../tutorials/nvidia.rst:78
msgid "Make the :file:`NVIDIA-Linux-x86_64-<VERSION>.run` file executable."
msgstr ""
#: ../../tutorials/nvidia.rst:85
msgid "Disable the nouveau driver"
msgstr ""
#: ../../tutorials/nvidia.rst:87
msgid ""
"The proprietary NVIDIA driver is incompatible with the nouveau driver and"
" must be disabled before installation can continue."
msgstr ""
#: ../../tutorials/nvidia.rst:90
msgid ""
"Disable the nouveau driver by creating a blacklist file under "
":file:`/etc/modprobe.d` and reboot."
msgstr ""
#: ../../tutorials/nvidia.rst:99
msgid ""
"Reboot the system and log back in. It is normal for the graphical "
"environment not to start without the NVIDIA driver loaded."
msgstr ""
#: ../../tutorials/nvidia.rst:103
msgid "Configure alternative software paths"
msgstr ""
#: ../../tutorials/nvidia.rst:105
msgid ""
"The NVIDIA installer is directed to install files under "
":file:`/opt/nvidia` as much as possible to keep its contents isolated "
"from the rest of the |CL| system files under :file:`/usr`. The dynamic "
"linker and X server must be configured to use the content under "
":file:`/opt/nvidia`."
msgstr ""
#: ../../tutorials/nvidia.rst:111
msgid ""
"Configure the dynamic linker to look for and to cache shared libraries "
"under :file:`/opt/nvidia/lib` and :file:`/opt/nvidia/lib32` in addition "
"to the default paths."
msgstr ""
#: ../../tutorials/nvidia.rst:122
msgid "Reload the dynamic linker run-time bindings and library cache."
msgstr ""
#: ../../tutorials/nvidia.rst:128
msgid ""
"Create a Xorg configuration file to search for modules under "
":file:`/opt/nvidia` in addition to the default path."
msgstr ""
#: ../../tutorials/nvidia.rst:143
msgid "Install the NVIDIA drivers"
msgstr ""
#: ../../tutorials/nvidia.rst:145
msgid ""
"A terminal not running on */dev/tty1* is useful to view uninterrupted "
"installation progress. Switch to a secondary virtual terminal by pushing "
":command:`CTRL + ALT + F2` or remotely login over SSH."
msgstr ""
#: ../../tutorials/nvidia.rst:149
msgid "Navigate to the directory where the NVIDIA installer was downloaded."
msgstr ""
#: ../../tutorials/nvidia.rst:155
msgid "Run the installer with the advanced options below."
msgstr ""
#: ../../tutorials/nvidia.rst:179
msgid ""
"The graphical interface may automatically start after the NVIDIA driver "
"is loaded. Return to the working terminal and log back in if necessary."
msgstr ""
#: ../../tutorials/nvidia.rst:182
msgid "Confirm that the NVIDIA kernel modules are loaded."
msgstr ""
#: ../../tutorials/nvidia.rst:188
msgid ""
"Run a |CL| system verification to restore files that the NVIDIA installer"
" likely deleted."
msgstr ""
#: ../../tutorials/nvidia.rst:197
msgid ""
"The NVIDIA software places some files under the :file:`/usr` subdirectory"
" that are not managed by |CL| and conflict with the |CL| stateless "
"design."
msgstr ""
#: ../../tutorials/nvidia.rst:200
msgid ""
"Although a limited version of :command:`swupd repair` is run above, other"
" uses of the :command:`swupd repair` command should be avoided with the "
"proprietary NVIDIA drivers installed."
msgstr ""
#: ../../tutorials/nvidia.rst:205
msgid "Updating the NVIDIA drivers"
msgstr ""
#: ../../tutorials/nvidia.rst:207
msgid ""
"The proprietary NVIDIA drivers are installed manually outside of "
":ref:`swupd <swupd-guide>` and must be updated manually when needed."
msgstr ""
#: ../../tutorials/nvidia.rst:210
msgid ""
"Updating the NVIDIA drivers follows the same steps as initial "
"installation, however the desktop environment must first be stopped so "
"that the drivers are not in use."
msgstr ""
#: ../../tutorials/nvidia.rst:214
msgid ""
"Follow the steps in the `Download the NVIDIA Drivers for Linux`_ section "
"to get the latest NVIDIA drivers."
msgstr ""
#: ../../tutorials/nvidia.rst:217
msgid ""
"Temporarily set the default boot target to the *multi-user*, which is a "
"non-graphical runtime."
msgstr ""
#: ../../tutorials/nvidia.rst:224
msgid ""
"Reboot the system and log back in. It is normal for the graphical "
"environment not to start."
msgstr ""
#: ../../tutorials/nvidia.rst:227
msgid ""
"Follow the steps in the `Install the NVIDIA Drivers`_ section to update "
"the NVIDIA drivers. This installation will overwrite the previous NVIDIA "
"drivers and files."
msgstr ""
#: ../../tutorials/nvidia.rst:231
msgid "Set the default boot target back to the *graphical* target."
msgstr ""
#: ../../tutorials/nvidia.rst:237
msgid "Reboot the system and log back in."
msgstr ""
#: ../../tutorials/nvidia.rst:239
msgid ""
"Trigger a flatpak update that will download the runtime corresponding "
"with the new NVIDIA drivers for the flatpak apps that require it."
msgstr ""
#: ../../tutorials/nvidia.rst:247
msgid "Uninstalling the NVIDIA drivers"
msgstr ""
#: ../../tutorials/nvidia.rst:249
msgid ""
"The NVIDIA drivers and associated software can be uninstalled and nouveau"
" driver restored with the instructions in this section."
msgstr ""
#: ../../tutorials/nvidia.rst:252
msgid "Remove the :file:`modprobe.d` file that prevents nouveau from loading."
msgstr ""
#: ../../tutorials/nvidia.rst:258
msgid "Remove the :file:`xorg.conf.d` file that adds a search path for X modules."
msgstr ""
#: ../../tutorials/nvidia.rst:264
msgid "Run the :command:`sudo /opt/nvidia/bin/nvidia-uninstall`"
msgstr ""
#: ../../tutorials/nvidia.rst:266
msgid "Follow the prompts on the screen and reboot the system."
msgstr ""
#: ../../tutorials/nvidia.rst:269
msgid "Debugging installation of NVIDIA drivers"
msgstr ""
#: ../../tutorials/nvidia.rst:271
msgid ""
"The NVIDIA driver places installer and uninstaller logs under "
":file:`/var/log/nvidia-install` and :file:`/var/log/nvidia-uninstall`."
msgstr ""
#: ../../tutorials/nvidia.rst:274
msgid ""
":file:`NVIDIA-Linux-x86_64-<VERSION>.run --advanced-options` shows many "
"parameters to control installation behavior."
msgstr ""
#: ../../tutorials/nvidia.rst:277
msgid ""
":file:`NVIDIA-Linux-x86_64-<VERSION>.run --extract-only` extracts "
"installation files into a directory named :file:`NVIDIA-"
"Linux-x86_64-<VERSION>`."
msgstr ""
#: ../../tutorials/nvidia.rst:282
msgid "Additional resources"
msgstr ""
#: ../../tutorials/nvidia.rst:284
msgid ""
"`Why aren't the NVIDIA Linux drivers open source? "
"<https://nvidia.custhelp.com/app/answers/detail/a_id/1849/kw/Linux>`_"
msgstr ""
#: ../../tutorials/nvidia.rst:286
msgid ""
"`Where can I get support for NVIDIA Linux drivers? "
"<https://nvidia.custhelp.com/app/answers/detail/a_id/44/kw/linux>`_"
msgstr ""
#: ../../tutorials/nvidia.rst:288
msgid ""
"`NVIDIA Accelerated Linux Graphics Driver Installation Guides "
"<https://download.nvidia.com/XFree86/Linux-x86_64/>`_"
msgstr ""
#~ msgid ""
#~ "The *kernel-native-dkms* bundle provides"
#~ " the :command:`dkms` program and Linux "
#~ "kernel headers, which are required for"
#~ " compiling kernel modules."
#~ msgstr ""
#~ msgid "The *kernel-native-dkms* bundle also:"
#~ msgstr ""
#~ msgid ""
#~ "Adds a systemd update trigger "
#~ "(:file:`/usr/lib/systemd/system/dkms-new-kernel.service`)"
#~ " to automatically run DKMS to rebuild"
#~ " modules after a kernel upgrade "
#~ "occurs with :ref:`swupd update <swupd-"
#~ "guide>`."
#~ msgstr ""
#~ msgid "Install NVIDIA\\* Drivers"
#~ msgstr ""
#~ msgid ""
#~ "Software installed outside of :ref:`swupd "
#~ "<swupd-about>` is not updated with "
#~ "|CL| updates and must be updated "
#~ "and maintained manually."
#~ msgstr ""
#~ msgid ""
#~ "For example, the file "
#~ ":file:`/usr/lib/libGL.so` conflicts between the "
#~ "one provided by the mesa package "
#~ "in |CL| and the one NVIDIA "
#~ "provides. If a |CL| update overwrites"
#~ " these files, a reinstallation of the"
#~ " NVIDIA driver might be required."
#~ msgstr ""
#~ msgid "Download and install the NVIDIA Drivers"
#~ msgstr ""
#~ msgid "Download the NVIDIA Drivers for Linux"
#~ msgstr ""
#~ msgid "Identify the model of NVIDIA GPU that is installed."
#~ msgstr ""
#~ msgid ""
#~ "Go to the `NVIDIA Driver Downloads "
#~ "website`_ . Search for and download "
#~ "the appropriate driver based on the "
#~ "model of NVIDIA GPU you have with"
#~ " *Linux 64-bit* selected as the "
#~ "Operating System ."
#~ msgstr ""
#~ msgid "Disable the nouveau Driver"
#~ msgstr ""
#~ msgid "Configure Alternative Software Paths"
#~ msgstr ""
#~ msgid ""
#~ "The NVIDIA installer will be directed"
#~ " to install files under :file:`/opt/nvidia`"
#~ " as much as possible to keep "
#~ "its contents isolated from the rest "
#~ "of the |CL| system files under "
#~ ":file:`/usr`. The dynamic linker and X"
#~ " server must be configured to use "
#~ "the content under :file:`/opt/nvidia`."
#~ msgstr ""
#~ msgid "Install the NVIDIA Drivers"
#~ msgstr ""
#~ msgid "Navigate into the directory where the NVIDIA installer was downloaded."
#~ msgstr ""
#~ msgid ""
#~ "The NVIDIA software places some files"
#~ " under the :file:`/usr` subdirectory which"
#~ " are not managed by |CL| and "
#~ "conflict with the |CL| stateless design."
#~ msgstr ""
#~ msgid "Updating the NVIDIA Drivers"
#~ msgstr ""
#~ msgid ""
#~ "The proprietary NVIDIA drivers are "
#~ "installed manually outside of :ref:`swupd "
#~ "<swupd-about>` and must be updated "
#~ "manually when needed."
#~ msgstr ""
#~ msgid ""
#~ "Trigger a flatpak update which will "
#~ "download the runtime corresponding with "
#~ "the new NVIDIA drivers for the "
#~ "flatpak apps that require it."
#~ msgstr ""
#~ msgid "Uninstalling the NVIDIA Drivers"
#~ msgstr ""
#~ msgid "Debugging Installation of NVIDIA Drivers"
#~ msgstr ""
@@ -0,0 +1,198 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019.
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-29 17:26-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/parallels.rst:4
msgid "Parallels\\* Desktop for Mac\\*"
msgstr ""
#: ../../tutorials/parallels.rst:6
msgid ""
"This tutorial describes how to run |CL| Server in :abbr:`CLI (command-"
"line interface)` mode as a guest OS in Parallels Desktop 14 for Mac."
msgstr ""
#: ../../tutorials/parallels.rst:10
msgid ""
"Parallels Desktop for Mac is virtualization software that allows other "
"operating systems, such as Linux, to run side-by-side with macOS\\*."
msgstr ""
#: ../../tutorials/parallels.rst:14
msgid "Prerequisites"
msgstr ""
#: ../../tutorials/parallels.rst:16
msgid "Install Parallels Desktop 14 for Mac."
msgstr ""
#: ../../tutorials/parallels.rst:19
msgid "Download ISO image"
msgstr ""
#: ../../tutorials/parallels.rst:21
msgid ""
"Download a live-server ISO installation file from "
"https://clearlinux.org/downloads. This tutorial uses |CL| Server 30140 as"
" its example."
msgstr ""
#: ../../tutorials/parallels.rst:24
msgid "Unzip the ISO image with the command:"
msgstr ""
#: ../../tutorials/parallels.rst:31
msgid "Initialize new VM"
msgstr ""
#: ../../tutorials/parallels.rst:33
msgid ""
"Start Parallels and initialize your :abbr:`VM (Virtual Machine)` with the"
" following steps."
msgstr ""
#: ../../tutorials/parallels.rst:36
msgid "Go to :menuselection:`File > New`."
msgstr ""
#: ../../tutorials/parallels.rst:38
msgid ""
"In the opening dialog window, select :guilabel:`Install Windows or "
"another OS from a DVD or image`, then click :guilabel:`Continue`. (See "
"Figure 1.)"
msgstr ""
#: ../../tutorials/parallels.rst:45
msgid "Figure 1: Parallels opening dialog"
msgstr ""
#: ../../tutorials/parallels.rst:47
msgid ""
"On the next screen, select :guilabel:`Image File`, then click "
":guilabel:`Select a file...` as shown in Figure 2."
msgstr ""
#: ../../tutorials/parallels.rst:53
msgid "Figure 2: Dialog to select source for VM"
msgstr ""
#: ../../tutorials/parallels.rst:55
msgid ""
"Select your ISO file. The system displays the warning message \"Unable to"
" detect operating system\", as shown in Figure 3. This message is "
"expected and can be ignored. Click :guilabel:`Continue`."
msgstr ""
#: ../../tutorials/parallels.rst:62
msgid "Figure 3: Warning that OS is not detected"
msgstr ""
#: ../../tutorials/parallels.rst:64
msgid ""
"You are prompted to select your OS, as shown in Figure 4. Select "
":menuselection:`More Linux > Other Linux` from the drop-down menu and "
"click :guilabel:`Continue`."
msgstr ""
#: ../../tutorials/parallels.rst:71
msgid "Figure 4: Select OS from drop-down menu"
msgstr ""
#: ../../tutorials/parallels.rst:73
msgid ""
"Name your VM and check :guilabel:`Customize settings before "
"installation`. (See Figure 5.)"
msgstr ""
#: ../../tutorials/parallels.rst:79
msgid "Figure 5: Name and Location screen"
msgstr ""
#: ../../tutorials/parallels.rst:81
msgid ""
"Click :guilabel:`Create`. The Configuration window for the new VM opens, "
"as shown in Figure 6."
msgstr ""
#: ../../tutorials/parallels.rst:84
msgid "Select :menuselection:`Hardware > Boot Order`."
msgstr ""
#: ../../tutorials/parallels.rst:89
msgid "Figure 6: VM Configuration window"
msgstr ""
#: ../../tutorials/parallels.rst:91
msgid ""
"Expand :guilabel:`Advanced Settings`. Set :guilabel:`BIOS` to “EFI "
"64-bit” and in the :guilabel:`Boot flags` field, enter “vm.bios.efi=1” as"
" shown in Figure 7."
msgstr ""
#: ../../tutorials/parallels.rst:98
msgid "Figure 7: Advanced configuration settings"
msgstr ""
#: ../../tutorials/parallels.rst:100
msgid "Close the Configuration window and click :guilabel:`Continue`."
msgstr ""
#: ../../tutorials/parallels.rst:102
msgid ""
"If camera and microphone access restriction warnings are displayed, you "
"can ignore them."
msgstr ""
#: ../../tutorials/parallels.rst:106
msgid "Install |CL| on VM"
msgstr ""
#: ../../tutorials/parallels.rst:108
msgid ""
"Follow the prompts and install |CL| using the text-based installer as "
"shown in Figure 8."
msgstr ""
#: ../../tutorials/parallels.rst:111
msgid ""
"Refer to :ref:`bare-metal-install-server` for additional installation "
"instructions."
msgstr ""
#: ../../tutorials/parallels.rst:117
msgid "Figure 8: On screen instructions from text-based installer"
msgstr ""
#: ../../tutorials/parallels.rst:119
msgid ""
"After installation, reboot the VM. You are prompted to log in, as shown "
"in Figure 9. Log in with the credentials you used when you installed |CL|"
" on the VM."
msgstr ""
#: ../../tutorials/parallels.rst:126
msgid "Figure 9: Log in prompt"
msgstr ""
#: ../../tutorials/parallels.rst:129
msgid ""
"Congratulations! You have successfully set up a |CL| VM using Parallels "
"Desktop for Mac."
msgstr ""
+127
View File
@@ -0,0 +1,127 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/proxy.rst:4
msgid "Proxy configuration"
msgstr ""
#: ../../tutorials/proxy.rst:6
msgid ""
"This tutorial shows you how to configure your system for use behind an "
"outbound proxy to access the Internet."
msgstr ""
#: ../../tutorials/proxy.rst:9
msgid "|CL| applications already benefit from the :ref:`autoproxy` feature."
msgstr ""
#: ../../tutorials/proxy.rst:17
msgid "Prerequisites"
msgstr ""
#: ../../tutorials/proxy.rst:19
msgid ""
"This tutorial assumes you have installed |CL| on your host system. For "
"detailed instructions on installing |CL| on a bare metal system, visit "
"the :ref:`bare metal installation guide <bare-metal-install-desktop>`."
msgstr ""
#: ../../tutorials/proxy.rst:24
msgid "Shells and programs in a desktop session"
msgstr ""
#: ../../tutorials/proxy.rst:27
msgid "Terminal"
msgstr ""
#: ../../tutorials/proxy.rst:29
msgid "Add the following to your ~/.bashrc:"
msgstr ""
#: ../../tutorials/proxy.rst:45
msgid "wget"
msgstr ""
#: ../../tutorials/proxy.rst:47
msgid "Run this command to enable downloading from websites from the terminal:"
msgstr ""
#: ../../tutorials/proxy.rst:59
msgid "System service (Docker)"
msgstr ""
#: ../../tutorials/proxy.rst:61
msgid ""
"For Docker (and other services that use systemd), you can follow these "
"steps to configure and check proxy settings:"
msgstr ""
#: ../../tutorials/proxy.rst:65
msgid "Be sure to use :command:`sudo`, as you will need elevated permissions."
msgstr ""
#: ../../tutorials/proxy.rst:67
msgid ""
"Create :file:`/etc/systemd/system/docker.service.d` directory to host "
"configuration information for the Docker service."
msgstr ""
#: ../../tutorials/proxy.rst:70
msgid ""
"Create :file:`/etc/systemd/system/docker.service.d/http-proxy.conf` and "
"add:"
msgstr ""
#: ../../tutorials/proxy.rst:78
msgid "Load the changes and restart the service:"
msgstr ""
#: ../../tutorials/proxy.rst:85
msgid "Verify that changes have loaded:"
msgstr ""
#: ../../tutorials/proxy.rst:97
msgid ""
"This process enables the ability to successfully run ``docker pull``. "
"Containers themselves must be configured independently."
msgstr ""
#: ../../tutorials/proxy.rst:101
msgid "git over ssh"
msgstr ""
#: ../../tutorials/proxy.rst:103
msgid "Add the following to your :file:`~/.ssh/config`:"
msgstr ""
#: ../../tutorials/proxy.rst:114
msgid ""
"Though netcat is included with Clear Linux, it is not the BSD version, "
"which is the one usually used to enable git over ssh."
msgstr ""
#~ msgid "Setting up proxy"
#~ msgstr ""
#~ msgid ""
#~ "|CL| :ref:`tooling` applications already "
#~ "benefit from the :ref:`autoproxy` feature."
#~ msgstr ""
+186
View File
@@ -0,0 +1,186 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2019, many
# This file is distributed under the same license as the Clear Linux*
# Project Docs package.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2019.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Clear Linux* Project Docs latest\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-08-09 14:33-0700\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
#: ../../tutorials/redis.rst:4
msgid "Redis\\*"
msgstr ""
#: ../../tutorials/redis.rst:6
msgid ""
"Redis is an in-memory key:value store designed for quick lookups, "
"accessible over the network. In this tutorial, you'll install redis and "
"launch a redis-server on |CL|, plus learn a few basic redis commands. We "
"also invite you to pull our `Clear Linux Redis instance`_ on dockerhub\\*"
" for application or infrastructure development."
msgstr ""
#: ../../tutorials/redis.rst:12
msgid ""
"While the `redis data structure store`_ can serve as a NoSQL database for"
" a Web application, it's also easy to integrate in an existing stack. For"
" example, you could use the Redis caching layer for real-time responses "
"on a leaderboard in a gaming app. Redis offers many client libraries with"
" language-specific bindings for Python, Perl, Ruby, and more."
msgstr ""
#: ../../tutorials/redis.rst:19
msgid "Prerequisites"
msgstr ""
#: ../../tutorials/redis.rst:20
msgid "Install the `redis-native` bundle in |CL|"
msgstr ""
#: ../../tutorials/redis.rst:21
msgid "Install the `containers-basic` bundle in |CL| (only required in Example 2)"
msgstr ""
#: ../../tutorials/redis.rst:24
msgid "Install the redis bundle"
msgstr ""
#: ../../tutorials/redis.rst:26
msgid "In |CL|, find redis in the `redis-native` bundle."
msgstr ""
#: ../../tutorials/redis.rst:28
msgid "Open a Terminal and login as an administrative user."
msgstr ""
#: ../../tutorials/redis.rst:30
msgid "Add :file:`redis-native`."
msgstr ""
#: ../../tutorials/redis.rst:38
msgid "If the bundle already exists, no action is required."
msgstr ""
#: ../../tutorials/redis.rst:41
msgid "Start the redis-server"
msgstr ""
#: ../../tutorials/redis.rst:43
msgid ""
"A `systemd` service unit is available to control the redis server. By "
"default, redis runs on port 6379."
msgstr ""
#: ../../tutorials/redis.rst:46
msgid "Start the service."
msgstr ""
#: ../../tutorials/redis.rst:54
msgid "To stop redis run :command:`systemctl stop redis`."
msgstr ""
#: ../../tutorials/redis.rst:56
msgid "Assure the service is running."
msgstr ""
#: ../../tutorials/redis.rst:62
msgid "Verify the redis-server sends a reply."
msgstr ""
#: ../../tutorials/redis.rst:70
msgid "Expected output: `PONG`."
msgstr ""
#: ../../tutorials/redis.rst:72
msgid ""
"Optional: If you wish to apply advanced configuration, copy the "
"`redis.conf` into /etc/ directory."
msgstr ""
#: ../../tutorials/redis.rst:79
msgid "The redis-server is now ready to use on |CL|. Try some examples below."
msgstr ""
#: ../../tutorials/redis.rst:82
msgid "Example 1: Use the redis-cli and try commands"
msgstr ""
#: ../../tutorials/redis.rst:84
msgid ""
"One advantage of redis over other NoSQL databases is that developers can "
"easily access data structures like lists, sets, sorted sets, strings, and"
" hashes using collection operations commands similar to those found in "
"many programming languages. These exercises are inspired by `try redis "
"io`_."
msgstr ""
#: ../../tutorials/redis.rst:89
msgid "After your `redis-server` is running, try some basic commands."
msgstr ""
#: ../../tutorials/redis.rst:91
msgid "Enter the `redis-cli`. It provides syntax suggestions as you type."
msgstr ""
#: ../../tutorials/redis.rst:97
msgid "SET key to hold string value. In the set create connections and increment."
msgstr ""
#: ../../tutorials/redis.rst:108
msgid "If the key does not exist or hold a key value, `nil` is returned."
msgstr ""
#: ../../tutorials/redis.rst:126
msgid "Create a `friends` list and insert new values at the end of the list."
msgstr ""
#: ../../tutorials/redis.rst:140
msgid "Modify `friends` list, using a common slice method with a 0-index."
msgstr ""
#: ../../tutorials/redis.rst:162
msgid ""
"Consider using a hash, a very useful data type, which maps string fields "
"and string values, offering multiple lookup methods."
msgstr ""
#: ../../tutorials/redis.rst:165
msgid "Enter many user key:values with `HMSET`. Then try `HGET` and `HGETALL`."
msgstr ""
#: ../../tutorials/redis.rst:185
msgid "Example 2: Run the |CL| redis docker image"
msgstr ""
#: ../../tutorials/redis.rst:187
msgid ""
"We also provide a `Clear Linux Redis instance`_, which is updated "
"continuously and maintained by |CL| development."
msgstr ""
#: ../../tutorials/redis.rst:203
msgid "Next Steps"
msgstr ""
#: ../../tutorials/redis.rst:205
msgid "Follow the `redis quickstart tutorial`_ to expand potential uses."
msgstr ""
#: ../../tutorials/redis.rst:207
msgid "Learn to :ref:`docker`."
msgstr ""
#~ msgid "Run Redis on |CL-ATTR|"
#~ msgstr ""

Some files were not shown because too many files have changed in this diff Show More