Translate english doc

Author: jondy

pyarmor/docs/gendoc.py

@@ -2,7 +2,7 @@
 # -*- coding: utf-8 -*-
 #
 
-"""根据设计文档生成用户手册"""
+"""Generate user doc"""
 
 import argparse
 import logging

pyarmor/docs/index.rst

@@ -3,12 +3,16 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Pyarmor |version| Documentation
-===============================
+.. important::
+
+   Here only includes Pyarmor 9.1 new features, other functions please check `Pyarmor 9.0 Documentation <https://pyarmor.readthedocs.io/en/latest/>`_
+
+Table of Contents
+=================
 
 .. toctree::
+   :numbered:
    :maxdepth: 2
-   :caption: Content
 
    user/features
    user/concepts

pyarmor/docs/reference/platforms.rst

@@ -2,6 +2,6 @@
  Platforms
 ===========
 
-支持的 Python 版本，操作系统，CPU 架构
+Python 3.7~3.13
 
-支持的 Python 解释器，CPython, IPython, WASM 等等
+Windows, Linux, Darwin, FreeBSD etc.

pyarmor/docs/reference/ranges.rst

@@ -1,10 +1,3 @@
 ========
  Ranges
 ========
-
-支持的有效值的范围
-
-譬如
-
-VMC 模式中 for 语句最大的嵌套层数目前支持的是 8 层
-VMC 模式中最大的变量数目是 2 的 32 次幂

pyarmor/docs/user/concepts.rst

@@ -1,42 +1,46 @@
 ============
- 概念和定义
+ Concepts
 ============
 
-.. contents:: 目录
+.. contents:: Content
    :depth: 2
    :local:
    :backlinks: top
 
 .. highlight:: console
 
-术语表
-======
+Terms
+=====
 
 .. glossary::
 
-   工程
-       工程是用来组织需要加密的脚本和如何加密脚本的选项集合
+   Project
+       Project is used to manage scripts and options
 
-   迷你型脚本
-       使用 :term:`pyarmor` 命令生成的一种加密脚本，需要扩展模块 :term:`pyarmor_mini` 才能正常运行
+   Mini Script
+       Python script, generated by :term:`pyarmor`
 
-   重构型脚本
-       使用 :term:`pyarmor` 命令生成的加密脚本，主要是对脚本中函数，类和方法等名称进行了重命名，不需要任何额外的扩展模块即可运行
+       It need import Python extension :term:`pyarmor_mini` to run
+
+   RFT Script
+       Python script, generated by :term:`pyarmor`, only functions, classes, attributes etc. in the scripts are renamed
+
+       It need not any other extension to run
 
    pyarmor
-       实现 Pyarmor 所有功能的命令行工具
+       One cli application to generate obfuscated scripts
 
    pyarmor_mini
-       Python 扩展模块，由 Pyarmor 开发组预编译，并发布在包 :term:`pyarmor.mini` 中
+       Python extension, published in PyPI package :term:`pyarmor.mini`
 
    pyarmor.cli
-       Python 包，用来创建 :term:`pyarmor` ，由 Pyarmor 开发组发布
+       Python package, published in PyPI
 
    pyarmor.mini
-       Python 包，提供运行加密脚本需要的预编译扩展模块，由 Pyarmor 开发组发布在 PyPI 上面
+       Python package, published in PyPI, provide extension :term:`pyarmor_mini`
 
-工程
-====
+Project
+=======
 
 .. graphviz::
 
@@ -52,17 +56,17 @@
 
    }
 
-迷你型加密脚本
-==============
+Mini Script
+===========
 
 .. code:: python
 
    from pyarmor_mini import __pyarmor__
    __pyarmor__(__name__, b'xxxx')
 
 
-重构型加密脚本
-==============
+RFT Script
+==========
 
 .. code:: python
 
@@ -71,8 +75,8 @@
 
    pyarmor__1('abc')
 
-pyarmor 命令
-==============
+pyarmor commands
+================
 
 .. graphviz::
 
@@ -84,31 +88,31 @@ pyarmor 命令
      C3 [label="pyarmor build"]
    }
 
-功能结构图
-==========
+Function Diagram
+================
 
 .. graphviz::
 
    digraph Structure {
 
-     P1 [label="工程" shape=component]
+     P1 [label="Project" shape=component]
 
      C1 [label="pyarmor init" shape=rect]
      C2 [label="pyarmor env" shape=rect]
      C3 [label="pyarmor build" shape=rect]
 
-     X1 [label="选项"]
+     X1 [label="Options"]
 
-     S1 [label="迷你型脚本" shape=component]
-     S2 [label="重构型脚本" shape=component]
+     S1 [label="Mini Script" shape=component]
+     S2 [label="RFT Script" shape=component]
 
      X1->C1
-     C1->P1 [taillabel="创建"]
+     C1->P1 [taillabel="create"]
 
      X1->C2
-     C2->P1 [taillabel="修改"]
+     C2->P1 [taillabel="update"]
 
      P1->C3
-     C3->S1 [label="生成" labelfloat=true]
+     C3->S1 [label="generate" labelfloat=true]
      C3->S2
    }