GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — 3.7 translation of tutorial/venv.po by tai271828 · Pull Request #17 · python/python-docs-zh-tw

Conversation

@tai271828

@tai271828 tai271828 commented Jul 12, 2018

Copy link
Copy Markdown
Collaborator

This PR merged the work of https://github.com/python/python-docs-zh-tw/pull/10/files and completed the whole session of tutorial/venv.po

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
zztin and others added 3 commits July 12, 2018 19:59
@zztin
Translational venv
b47f209
@tai271828
Translation of tutorial/venv.po
650414b
@tai271828
Merge zztin translation work
c072560
@tai271828 tai271828 mentioned this pull request Jul 12, 2018
Translation of tutorial/venv #10
Closed
@tai271828
Issue python#8 fix typo
85ab858
@tai271828
tai271828 force-pushed the 3.7 branch from 6d804ea to 85ab858 Compare July 12, 2018 13:08
adrianliaw
adrianliaw requested changes Jul 13, 2018
View reviewed changes

@adrianliaw adrianliaw left a comment

Copy link
Copy Markdown
Collaborator

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for contributing! I've commented some suggestions in the code review, and they're mostly about conventions or formatting, and some syntax corrections. Please feel free to give comments if you don't agree with some of my suggestions.

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
Comment thread tutorial/venv.po Outdated
#: ../../tutorial/venv.rst:6
msgid "Virtual Environments and Packages"
msgstr ""
msgstr "虛擬環境與相關套件"

@adrianliaw adrianliaw Jul 12, 2018

Copy link
Copy Markdown
Collaborator

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

這邊翻譯成「相關」套件有特別的原因嗎？

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions

@tai271828 tai271828 Aug 14, 2018

Copy link
Copy Markdown
Collaborator Author

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, just redundant words, will fix. Thanks for the review.

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
Comment thread tutorial/venv.po Outdated
"bug has been fixed or the application may be written using an obsolete "
"version of the library's interface."
msgstr ""
"Python 應用程式通常會用到不會和標準函式庫一起釋出的套件與模組。應用程式有時後"

@adrianliaw adrianliaw Jul 12, 2018

Copy link
Copy Markdown
Collaborator

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/有時後/有時候/

另外我覺得第一句有一點點不太通暢，也許「不會和標準函式庫一起釋出的套件與模組」可以改成「不在標準函式庫的套件和模組」？

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
tai271828 reacted with thumbs up emoji
All reactions
  • 👍 1 reaction
Comment thread tutorial/venv.po Outdated
msgstr ""
"這意味著不太可能安裝一套 Python 就可以滿足所有應用程式的要求。如果應用程式 A "
"需要一個特別的模組的 1.0 版，但另外一個應用程式 B 需要 2.0 版，那麼這整個需求"
"不管安裝 1.0 或是 2.0 都會衝突，以至於應用程式無法使用。"

@adrianliaw adrianliaw Jul 12, 2018

Copy link
Copy Markdown
Collaborator

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/以至於/以致於/

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
tai271828 reacted with thumbs up emoji tai271828 reacted with laugh emoji
All reactions
  • 👍 1 reaction
  • 😄 1 reaction
Comment thread tutorial/venv.po Outdated
"application unable to run."
msgstr ""
"這意味著不太可能安裝一套 Python 就可以滿足所有應用程式的要求。如果應用程式 A "
"需要一個特別的模組的 1.0 版，但另外一個應用程式 B 需要 2.0 版，那麼這整個需求"

@adrianliaw adrianliaw Jul 12, 2018

Copy link
Copy Markdown
Collaborator

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

我覺得「a particular module」也許翻譯成「一個特定模組」會比較順一點？

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
tai271828 reacted with thumbs up emoji
All reactions
  • 👍 1 reaction
Comment thread tutorial/venv.po Outdated
"self-contained directory tree that contains a Python installation for a "
"particular version of Python, plus a number of additional packages."
msgstr ""
"解決方案是創建一個 :term:`虛擬環境`，這是一個獨立的資料夾，並且裡面裝好的特定"

@adrianliaw adrianliaw Jul 12, 2018

Copy link
Copy Markdown
Collaborator

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/裝好的/裝好了/

另外，這個 rST 語法會讓 sphinx 無法辨識，因為「虛擬環境」並沒有出現在 glossary 頁面裡（glossary 裡面的是 "virtual environment"），這邊可以把這個：

:term:`虛擬環境`

替代成：

:term:`虛擬環境 <virtual environment>`

就不會有找不到 term 的問題了。

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
tai271828 reacted with hooray emoji
All reactions
  • 🎉 1 reaction
Comment thread tutorial/venv.po Outdated
"the output uses the format that ``pip install`` expects. A common convention "
"is to put this list in a ``requirements.txt`` file:"
msgstr ""
"``pip freeze`` 可以複製一個整已經安裝套件的清單，但是輸出使用 ``pip "

@adrianliaw adrianliaw Jul 13, 2018

Copy link
Copy Markdown
Collaborator

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/已經安裝套件的清單/已經安裝的套件清單/

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
Comment thread tutorial/venv.po Outdated
msgstr ""
"``pip freeze`` 可以複製一個整已經安裝套件的清單，但是輸出使用 ``pip "
"install`` 可以讀懂的格式。一個常見的慣例是放這整個清單到一個叫做 "
"``requirements.txt`` 的檔案:"

@adrianliaw adrianliaw Jul 13, 2018

Copy link
Copy Markdown
Collaborator

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

冒號

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
Comment thread tutorial/venv.po Outdated
"packages with ``install -r``:"
msgstr ""
"``requirements.txt`` 可以提交到版本控制，並且作為釋出應用程式的一部分。使用者"
"可以透過``install -r`` 安裝對應的的套件。"

@adrianliaw adrianliaw Jul 13, 2018

Copy link
Copy Markdown
Collaborator

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

``install -r`` 前面少一個空格

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
Comment thread tutorial/venv.po Outdated
"want to make it available on the Python Package Index, consult the :ref:"
"`distributing-index` guide."
msgstr ""
"``pip`` 有更多功能。可以參考 :ref:`installing-index` 說明書來取得完整的 "

@adrianliaw adrianliaw Jul 13, 2018

Copy link
Copy Markdown
Collaborator

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

參考 L166

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
Comment thread tutorial/venv.po Outdated
msgstr ""
"``pip`` 有更多功能。可以參考 :ref:`installing-index` 說明書來取得完整的 "
"``pip`` 參考資料。當你撰寫了一個套件並且想要讓他可以在 Python Package Index "
"上可以取得的話，可以參考 :ref:`distributing-index` 說明。"

@adrianliaw adrianliaw Jul 13, 2018

Copy link
Copy Markdown
Collaborator

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/可以// （已經出現在句子前面一段）

ref 則同上，請參考 L166

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
@tai271828
Issue python#8 fix according to PR17 comments
c4f9131
@tai271828

tai271828 commented Aug 14, 2018

Copy link
Copy Markdown
Collaborator Author

Fixed all stuff suggested in the previous review.
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
@tai271828
Rm heading space
6be26e4
@tai271828

tai271828 commented Aug 15, 2018

Copy link
Copy Markdown
Collaborator Author

I have built the html to check the syntax. I think the PR is ready to review again now. The only question I have is the quote:

有好幾個子指令： 「search」，」install」，」uninstall」, 「freeze」, 等等。

It looks good in my po file. However, it shows a bit weird in the translated text. Is this expected or a build process bug?
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
@adrianliaw

adrianliaw commented Aug 16, 2018

Copy link
Copy Markdown
Collaborator

It seems like a problem from Docutils' localised smart quotes [1], there was a same problem in the Japanese translation, thus there was a docutils.conf added in CPython's Doc directory [2] that disables ja localisation's smart quotes. Let's just keep it correct inside the po file for now, I'll send an email to the Doc-SIG some time.

[1] http://docutils.sourceforge.net/docs/user/smartquotes.html#localisation
[2] python/cpython#4006
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
@adrianliaw
adrianliaw merged commit 6be26e4 into python:3.7 Aug 22, 2018
adrianliaw added a commit that referenced this pull request Aug 22, 2018
@adrianliaw
Merge pull request #17 from tai271828/3.7
42cc776
beccalzh pushed a commit to beccalzh/python-docs-zh-tw that referenced this pull request Sep 4, 2024
@adrianliaw
Merge pull request python#17 from tai271828/3.7
8982d2b
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@adrianliaw adrianliaw adrianliaw requested changes

Uh oh!

There was an error while loading. Please reload this page.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Uh oh!

There was an error while loading. Please reload this page.

3 participants

@tai271828 @adrianliaw @zztin
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.