Rust lang master

.github/workflows/main.yml

@@ -1,7 +1,5 @@
 name: CI
-on:
-  pull_request:
-  merge_group:
+on: [pull_request, merge_group]
 
 env:
   MDBOOK_VERSION: 0.4.40
@@ -12,13 +10,13 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
-    - name: Update rustup
-      run: rustup self update
-    - name: Install Rust
-      run: |
-        rustup set profile minimal
-        rustup toolchain install nightly -c rust-docs
-        rustup default nightly
+    - name: Setup Rust Toolchain
+      uses: actions-rust-lang/[email protected]
+      with:
+        toolchain: nightly
+        components: rust-docs
+    - run: rustup default nightly
+            
     - name: Install mdbook
       run: |
         mkdir bin
@@ -31,11 +29,26 @@ jobs:
         mdbook --version
     - name: Run tests
       run: mdbook test
-    - name: Check for broken links
-      run: |
-        curl -sSLo linkcheck.sh \
-          https://raw.githubusercontent.com/rust-lang/rust/master/src/tools/linkchecker/linkcheck.sh
-        sh linkcheck.sh --all nomicon
+
+    # - name: Cache/Restore linkcheck
+    #   id: cache
+    #   uses: actions/[email protected]
+    #   with:
+    #     path: linkchecker
+    #     key: linkchecker-${{ runner.os }}
+
+    # - name: Install linkcheck and Check links
+    #   # if: steps.cache.outputs.cache-hit != 'true'
+    #   run: |
+    #     curl -sSLo linkcheck.sh \
+    #       https://raw.githubusercontent.com/rust-lang/rust/master/src/tools/linkchecker/linkcheck.sh
+    #       sh linkcheck.sh --all nomicon
+
+    # - name: Check links
+    #   if: steps.cache.outputs.cache-hit == 'true'
+    #   run: |
+    #     cd linkchecker
+    #     cargo run --release linkcheck
 
   # The success job is here to consolidate the total success/failure state of
   # all other jobs. This job is then included in the GitHub branch protection

.github/workflows/mdbook.yml

@@ -0,0 +1,59 @@
+# Sample workflow for building and deploying a mdBook site to GitHub Pages
+#
+# To get started with mdBook see: https://rust-lang.github.io/mdBook/index.html
+#
+name: mdBook -> Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["master"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup Rust Toolchain
+        uses: actions-rust-lang/[email protected]
+        with:
+          toolchain: nightly
+          components: rust-docs
+      - run: cargo install mdbook
+      - name: Setup Pages
+        id: pages
+        uses: actions/configure-pages@v5
+      - name: Build with mdBook
+        run: mdbook build
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./book
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

README.md

@@ -1,71 +1,64 @@
-# The Rustonomicon
+# 러스토노미콘
 
-The Dark Arts of Advanced and Unsafe Rust Programming
+심오하고 *불안전한* 러스트 프로그래밍의 흑마법들
 
-Nicknamed "the Nomicon."
+짧게 "노미콘"이라고 부릅니다.
 
-## NOTE: This is a draft document, and may contain serious errors
+## 주의: 이것은 미완성 문서이고, 심각한 오류들을 포함할 수 있습니다.
 
-> Instead of the programs I had hoped for, there came only a shuddering
-blackness and ineffable loneliness; and I saw at last a fearful truth which no
-one had ever dared to breathe before — the unwhisperable secret of secrets — The
-fact that this language of stone and stridor is not a sentient perpetuation of
-Rust as London is of Old London and Paris of Old Paris, but that it is in fact
-quite unsafe, its sprawling body imperfectly embalmed and infested with queer
-animate things which have nothing to do with it as it was in compilation.
+> 내가 바랐던 프로그램들 대신, 살떨리는 어둠과 표현할 수 없는 외로움만이 있었다. 그리고 난 마침내 보고야 말았다.
+  아무도 그 앞에서 감히 숨도 쉬지 못한 두려운 진실, 속삭일 수조차 없는 비밀들 중의 비밀을 보고야 만 것이다.
+  이 돌과 끼긱거리는 소리로 이루어진 언어가 러스트의 의식적인 후계가 아니라는 것이었다. 런던은 옛날 정겨운
+  런던이었고 파리도 그랬지만, 이 언어는 아니었다. 이것은 꽤나 불안전했고,
+  그 뻗어있는 몸은 거의 미라가 되어 있었고 컴파일할 때는 없었던, 움직이는 요상한 것들로 들끓고 있었다.
 
-This book digs into all the awful details that are necessary to understand in
-order to write correct Unsafe Rust programs. Due to the nature of this problem,
-it may lead to unleashing untold horrors that shatter your psyche into a billion
-infinitesimal fragments of despair.
+이 책은 올바른 *"불안전한"* 러스트 프로그램을 작성하기 위해 이해해야 하는 온갖 자질구레한 하나하나를 다 다룹니다.
+이러한 문제의 특성 때문에, 이는 이루 다 말할 수 없는 공포스러운 것들을 해방시켜 당신의 정신을 무수한 절망의 조각들로 박살낼 수도 있습니다.
 
-## Requirements
+## 요구사항
 
-Building the Nomicon requires [mdBook]. To get it:
+노미콘을 빌드하기 위해서는 [mdBook]이 필요합니다. 설치하려면 다음과 같이 입력하세요:
 
 [mdBook]: https://github.com/rust-lang/mdBook
 
 ```bash
 cargo install mdbook
 ```
 
-### `mdbook` usage
+### `mdbook` 사용법
 
-To build the Nomicon use the `build` sub-command:
+노미콘을 빌드하려면 `build` 서브커맨드를 사용하세요:
 
 ```bash
 mdbook build
 ```
 
-The output will be placed in the `book` subdirectory. To check it out, open the
-`index.html` file in your web browser. You can pass the `--open` flag to `mdbook
-build` and it'll open the index page in your default browser (if the process is
-successful) just like with `cargo doc --open`:
+결과물은 `book` 디렉토리에 위치할 것입니다. 이 결과물을 보려면, `index.html` 파일을 웹 브라우저에서 여세요.
+`--open` 플래그를 `mdbook build`에 사용하면 (성공한다면) 기본 브라우저에서 인덱스 페이지를 엽니다. 마치 `cargo doc --open`처럼요:
 
 ```bash
 mdbook build --open
 ```
 
-There is also a `test` sub-command to test all code samples contained in the book:
+책에 담겨있는 모든 코드 예제를 테스트하는 `test` 서브커맨드도 있습니다:
 
 ```bash
 mdbook test
 ```
 
 ### `linkcheck`
 
-We use the `linkcheck` tool to find broken links.
-To run it locally:
+`linkcheck` 툴을 사용하여 유효하지 않은 링크를 검증합니다.
+로컬에서 실행하려면 다음과 같이 입력하세요:
 
 ```sh
 curl -sSLo linkcheck.sh https://raw.githubusercontent.com/rust-lang/rust/master/src/tools/linkchecker/linkcheck.sh
 sh linkcheck.sh --all nomicon
 ```
 
-## Contributing
+## 기여
+
+노미콘은 아직 미완성 상태이기 때문에, 당신의 도움이 필요합니다!
+아무 주제라도 좋으니 자유롭게 이슈를 열어 주시고, 고치거나 바꾸고 싶은 것들이 있다면 PR도 환영합니다.
+만약 변경사항이 많다면 PR로 고생하시기 전에, 수락할 변경사항인지 확실하게 하기 위해 먼저 이슈를 열어 주세요.
 
-Given that the Nomicon is still in a draft state, we'd love your help! Please
-feel free to open issues about anything, and send in PRs for things you'd like
-to fix or change. If your change is large, please open an issue first, so we can
-make sure that it's something we'd accept before you go through the work of
-getting a PR together.

book.toml

@@ -1,11 +1,11 @@
 [book]
-author = "The Rust Project Developers"
-title = "The Rustonomicon"
-description = "The Dark Arts of Advanced and Unsafe Rust Programming"
+author = "러스트 프로젝트 개발자들"
+title = "러스토노미콘"
+description = "심오하고 불안전한 러스트 프로그래밍의 흑마법들"
 
 [output.html]
 additional-css = ["theme/nomicon.css"]
-git-repository-url = "https://github.com/rust-lang/nomicon"
+git-repository-url = "https://github.com/nomicon-kr/nomicon-kr.github.io"
 
 [output.html.redirect]
 # Vec-related chapters.

src/SUMMARY.md

@@ -1,39 +1,39 @@
 # Summary
 
-[Introduction](intro.md)
+[소개](intro.md)
 
-* [Meet Safe and Unsafe](meet-safe-and-unsafe.md)
-  * [How Safe and Unsafe Interact](safe-unsafe-meaning.md)
-  * [What Unsafe Can Do](what-unsafe-does.md)
-  * [Working with Unsafe](working-with-unsafe.md)
-* [Data Layout](data.md)
+* [안전함과 불안전함을 마주하라](meet-safe-and-unsafe.md)
+  * [안전함과 불안전함은 어떻게 상호작용하는가](safe-unsafe-meaning.md)
+  * [불안전함은 어떤 것을 할 수 있는가](what-unsafe-does.md)
+  * [불안전함과 함께 일하는 것](working-with-unsafe.md)
+* [데이터 레이아웃](data.md)
   * [repr(Rust)](repr-rust.md)
-  * [Exotically Sized Types](exotic-sizes.md)
-  * [Other reprs](other-reprs.md)
-* [Ownership](ownership.md)
-  * [References](references.md)
-  * [Aliasing](aliasing.md)
-  * [Lifetimes](lifetimes.md)
-  * [Limits of Lifetimes](lifetime-mismatch.md)
-  * [Lifetime Elision](lifetime-elision.md)
-  * [Unbounded Lifetimes](unbounded-lifetimes.md)
-  * [Higher-Rank Trait Bounds](hrtb.md)
-  * [Subtyping and Variance](subtyping.md)
-  * [Drop Check](dropck.md)
+  * [이량 타입](exotic-sizes.md)
+  * [다른 표현 방식들](other-reprs.md)
+* [소유권](ownership.md)
+  * [레퍼런스](references.md)
+  * [복제](aliasing.md)
+  * [수명](lifetimes.md)
+  * [수명의 한계](lifetime-mismatch.md)
+  * [수명 생략](lifetime-elision.md)
+  * [무제한 수명](unbounded-lifetimes.md)
+  * [상계 트레잇 제한](hrtb.md)
+  * [부분타입 다형성과 변성](subtyping.md)
+  * [해제 검사](dropck.md)
   * [PhantomData](phantom-data.md)
-  * [Splitting Borrows](borrow-splitting.md)
-* [Type Conversions](conversions.md)
-  * [Coercions](coercions.md)
-  * [The Dot Operator](dot-operator.md)
-  * [Casts](casts.md)
-  * [Transmutes](transmutes.md)
-* [Uninitialized Memory](uninitialized.md)
-  * [Checked](checked-uninit.md)
-  * [Drop Flags](drop-flags.md)
-  * [Unchecked](unchecked-uninit.md)
-* [Ownership Based Resource Management](obrm.md)
-  * [Constructors](constructors.md)
-  * [Destructors](destructors.md)
+  * [대여 쪼개기](borrow-splitting.md)
+* [타입 변환](conversions.md)
+  * [강제 변환](coercions.md)
+  * [점 연산자](dot-operator.md)
+  * [변형](casts.md)
+  * [변질](transmutes.md)
+* [초기화되지 않은 메모리](uninitialized.md)
+  * [검사받는](checked-uninit.md)
+  * [해제 표기](drop-flags.md)
+  * [검사받지 않는](unchecked-uninit.md)
+* [소유권 기반 자원 관리](obrm.md)
+  * [생성자](constructors.md)
+  * [소멸자](destructors.md)
   * [Leaking](leaking.md)
 * [Unwinding](unwinding.md)
   * [Exception Safety](exception-safety.md)