1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/wtklbm-rust-library-chinese

Клонировать/Скачать
BuildHtml.md 4.8 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
gitlife-traslator Отправлено 30.11.2024 10:45 da6cbad

Создание офлайн HTML-документа

Вы можете создать автономный HTML-документ для личного использования. Прежде чем создавать автономный HTML-документ, вам необходимо изучить некоторые операции Git и процесс сборки Rust. Здесь мы предоставляем только команду для создания автономного HTML-документа, а для получения более подробной информации обратитесь к официальному репозиторию Rust.

Приведённый ниже скрипт для создания HTML-документа не всегда эффективен. Если вы никогда не создавали документы Rust из исходного кода, то лучше не пытаться это делать, так как могут возникнуть различные проблемы. Если вы хотите создать документ из исходного кода, самый быстрый и прямой способ — перейти на официальный репозиторий Rust, изучить процесс сборки Rust и самостоятельно исследовать лучшие способы создания HTML-документов.

Ранее коллега cxping создал автономный двуязычный документ, но он давно не обновлялся и кажется устаревшим, поэтому был удалён. В настоящее время никто не хочет обновлять локальную HTML-версию документа, поэтому даже если вы создадите HTML-документ, не отправляйте PR в этот репозиторий.

Первый шаг: клонирование и замена

# Выполните в терминале

# Клонируйте официальный репозиторий Rust
git clone https://github.com/rust-lang/rust.git rust

# Примечание: последующие операции будут выполнены в этом каталоге
cd rust

# Измените версию
# Обратите внимание: эта версия должна соответствовать версии китайского документа
# Особенно обратите внимание: следующую строку нельзя скопировать напрямую, номер версии 1.55.0 должен быть изменён
git checkout 1.55.0

# Удалите каталог rust/library
rm -rf ./library

# Клонируйте подрепозитории
git clone https://github.com/rust-lang/rust-installer.git src/tools/rust-installer
git clone https://github.com/rust-lang/cargo.git src/tools/cargo
git clone https://github.com/rust-lang/rls.git src/tools/rls
git clone https://github.com/rust-lang/miri.git src/tools/miri
git clone https://github.com/rust-lang/stdarch.git library/stdarch
git clone https://github.com/rust-lang/backtrace-rs.git library/backtrace
git clone https://github.com/rust-lang/libbacktrace library/backtrace/crates/backtrace-sys/src/libbacktrace

# Замените китайский документ
# Адрес загрузки документа: https://github.com/wtklbm/rust-library-i18n/tree/main/dist
# Скопируйте китайский документ в каталог rust/library, если он уже существует, просто замените его

# Локальное сохранение один раз
git add -A
git commit -m none

Второй шаг: добавление конфигурации

# Linux/macOS Bash
echo -e "changelog-seen = 2\n[llvm]\nninja = false" >> config.toml

# Windows PowerShell
Write-Output "changelog-seen = 2`n[llvm]`nninja = false" >> config.toml

Третий шаг: создание автономного документа

# Создайте автономный статический HTML-документ
# Почему выполнение этой команды может создать документ, перейдите на официальный репозиторий Rust
# Любые вопросы о команде также задавайте в соответствующем репозитории
python x.py doc library/std

# Результат сборки будет автоматически сохранён в каталоге rust/build/x86_64-pc-windows-msvc/doc
# После завершения сборки откройте файл rust/build/x86_64-pc-windows-msvc/doc/std/index.html в браузере
1
https://api.gitlife.ru/oschina-mirror/wtklbm-rust-library-chinese.git
git@api.gitlife.ru:oschina-mirror/wtklbm-rust-library-chinese.git
oschina-mirror
wtklbm-rust-library-chinese
wtklbm-rust-library-chinese
main