docs: add Japanese translate documents (#1812)

* docs: add Japanese documents (`ja/docs`)

* docs: add Japanese documents (`ja/codes`)

* docs: add Japanese documents

* Remove pythontutor blocks in ja/

* Add an empty at the end of each markdown file.

* Add the missing figures (use the English version temporarily).

* Add index.md for Japanese version.

* Add index.html for Japanese version.

* Add missing index.assets

* Fix backtracking_algorithm.md for Japanese version.

* Add avatar_eltociear.jpg. Fix image links on the Japanese landing page.

* Add the Japanese banner.

---------

Co-authored-by: krahets <krahets@163.com>

ja/codes/cpp/utils/common.hpp

@@ -0,0 +1,28 @@
+/**
+ * File: common.hpp
+ * Created Time: 2021-12-19
+ * Author: krahets (krahets@163.com)
+ */
+
+#pragma once
+
+#include <algorithm>
+#include <chrono>
+#include <deque>
+#include <iostream>
+#include <list>
+#include <queue>
+#include <random>
+#include <set>
+#include <stack>
+#include <string>
+#include <unordered_map>
+#include <unordered_set>
+#include <vector>
+
+#include "list_node.hpp"
+#include "print_utils.hpp"
+#include "tree_node.hpp"
+#include "vertex.hpp"
+
+using namespace std;

ja/codes/cpp/utils/list_node.hpp

@@ -0,0 +1,42 @@
+/**
+ * File: list_node.hpp
+ * Created Time: 2021-12-19
+ * Author: krahets (krahets@163.com)
+ */
+
+#pragma once
+
+#include <iostream>
+#include <vector>
+
+using namespace std;
+
+/* 連結リストノード */
+struct ListNode {
+    int val;
+    ListNode *next;
+    ListNode(int x) : val(x), next(nullptr) {
+    }
+};
+
+/* 配列を連結リストに逆シリアル化する */
+ListNode *vecToLinkedList(vector<int> list) {
+    ListNode *dum = new ListNode(0);
+    ListNode *head = dum;
+    for (int val : list) {
+        head->next = new ListNode(val);
+        head = head->next;
+    }
+    return dum->next;
+}
+
+/* 連結リストに割り当てられたメモリを解放する */
+void freeMemoryLinkedList(ListNode *cur) {
+    // メモリを解放
+    ListNode *pre;
+    while (cur != nullptr) {
+        pre = cur;
+        cur = cur->next;
+        delete pre;
+    }
+}

ja/codes/cpp/utils/print_utils.hpp

@@ -0,0 +1,228 @@
+/**
+ * File: print_utils.hpp
+ * Created Time: 2021-12-19
+ * Author: krahets (krahets@163.com), msk397 (machangxinq@gmail.com), LoneRanger(836253168@qq.com)
+ */
+
+#pragma once
+
+#include "list_node.hpp"
+#include "tree_node.hpp"
+#include <climits>
+#include <iostream>
+#include <sstream>
+#include <string>
+
+/* ベクター内の要素を検索する */
+template <typename T> int vecFind(const vector<T> &vec, T ele) {
+    int j = INT_MAX;
+    for (int i = 0; i < vec.size(); i++) {
+        if (vec[i] == ele) {
+            j = i;
+        }
+    }
+    return j;
+}
+
+/* ベクターを区切り文字で連結する */
+template <typename T> string strJoin(const string &delim, const T &vec) {
+    ostringstream s;
+    for (const auto &i : vec) {
+        if (&i != &vec[0]) {
+            s << delim;
+        }
+        s << i;
+    }
+    return s.str();
+}
+
+/* 文字列をn回繰り返す */
+string strRepeat(string str, int n) {
+    ostringstream os;
+    for (int i = 0; i < n; i++)
+        os << str;
+    return os.str();
+}
+
+/* 配列を印刷する */
+template <typename T> void printArray(T *arr, int n) {
+    cout << "[";
+    for (int i = 0; i < n - 1; i++) {
+        cout << arr[i] << ", ";
+    }
+    if (n >= 1)
+        cout << arr[n - 1] << "]" << endl;
+    else
+        cout << "]" << endl;
+}
+
+/* ベクター文字列オブジェクトを取得する */
+template <typename T> string getVectorString(vector<T> &list) {
+    return "[" + strJoin(", ", list) + "]";
+}
+
+/* リストを印刷する */
+template <typename T> void printVector(vector<T> list) {
+    cout << getVectorString(list) << '\n';
+}
+
+/* 行列を印刷する */
+template <typename T> void printVectorMatrix(vector<vector<T>> &matrix) {
+    cout << "[" << '\n';
+    for (vector<T> &list : matrix)
+        cout << "  " + getVectorString(list) + "," << '\n';
+    cout << "]" << '\n';
+}
+
+/* 連結リストを印刷する */
+void printLinkedList(ListNode *head) {
+    vector<int> list;
+    while (head != nullptr) {
+        list.push_back(head->val);
+        head = head->next;
+    }
+
+    cout << strJoin(" -> ", list) << '\n';
+}
+
+struct Trunk {
+    Trunk *prev;
+    string str;
+    Trunk(Trunk *prev, string str) {
+        this->prev = prev;
+        this->str = str;
+    }
+};
+
+void showTrunks(Trunk *p) {
+    if (p == nullptr) {
+        return;
+    }
+
+    showTrunks(p->prev);
+    cout << p->str;
+}
+
+/**
+ * 二分木を印刷する
+ * この木プリンターはTECHIE DELIGHTから借用しました
+ * https://www.techiedelight.com/c-program-print-binary-tree/
+ */
+void printTree(TreeNode *root, Trunk *prev, bool isRight) {
+    if (root == nullptr) {
+        return;
+    }
+
+    string prev_str = "    ";
+    Trunk trunk(prev, prev_str);
+
+    printTree(root->right, &trunk, true);
+
+    if (!prev) {
+        trunk.str = "———";
+    } else if (isRight) {
+        trunk.str = "/———";
+        prev_str = "   |";
+    } else {
+        trunk.str = "\\———";
+        prev->str = prev_str;
+    }
+
+    showTrunks(&trunk);
+    cout << " " << root->val << endl;
+
+    if (prev) {
+        prev->str = prev_str;
+    }
+    trunk.str = "   |";
+
+    printTree(root->left, &trunk, false);
+}
+
+/* 二分木を印刷する */
+void printTree(TreeNode *root) {
+    printTree(root, nullptr, false);
+}
+
+/* スタックを印刷する */
+template <typename T> void printStack(stack<T> stk) {
+    // 入力スタックを逆順にする
+    stack<T> tmp;
+    while (!stk.empty()) {
+        tmp.push(stk.top());
+        stk.pop();
+    }
+    // 印刷する文字列を生成
+    ostringstream s;
+    bool flag = true;
+    while (!tmp.empty()) {
+        if (flag) {
+            s << tmp.top();
+            flag = false;
+        } else
+            s << ", " << tmp.top();
+        tmp.pop();
+    }
+    cout << "[" + s.str() + "]" << '\n';
+}
+
+/* キューを印刷する */
+template <typename T> void printQueue(queue<T> queue) {
+    // 印刷する文字列を生成
+    ostringstream s;
+    bool flag = true;
+    while (!queue.empty()) {
+        if (flag) {
+            s << queue.front();
+            flag = false;
+        } else
+            s << ", " << queue.front();
+        queue.pop();
+    }
+    cout << "[" + s.str() + "]" << '\n';
+}
+
+/* デックを印刷する */
+template <typename T> void printDeque(deque<T> deque) {
+    // 印刷する文字列を生成
+    ostringstream s;
+    bool flag = true;
+    while (!deque.empty()) {
+        if (flag) {
+            s << deque.front();
+            flag = false;
+        } else
+            s << ", " << deque.front();
+        deque.pop_front();
+    }
+    cout << "[" + s.str() + "]" << '\n';
+}
+
+/* ハッシュテーブルを印刷する */
+// キー値ペアの型を指定するためにテンプレートパラメータTKeyとTValueを定義
+template <typename TKey, typename TValue> void printHashMap(unordered_map<TKey, TValue> map) {
+    for (auto kv : map) {
+        cout << kv.first << " -> " << kv.second << '\n';
+    }
+}
+
+/* priority_queueコンテナの基礎となるストレージを公開する */
+template <typename T, typename S, typename C> S &Container(priority_queue<T, S, C> &pq) {
+    struct HackedQueue : private priority_queue<T, S, C> {
+        static S &Container(priority_queue<T, S, C> &pq) {
+            return pq.*&HackedQueue::c;
+        }
+    };
+    return HackedQueue::Container(pq);
+}
+
+/* ヒープ（優先度付きキュー）を印刷する */
+template <typename T, typename S, typename C> void printHeap(priority_queue<T, S, C> &heap) {
+    vector<T> vec = Container(heap);
+    cout << "ヒープの配列表現:";
+    printVector(vec);
+    cout << "ヒープの木表現:" << endl;
+    TreeNode *root = vectorToTree(vec);
+    printTree(root);
+    freeMemoryTree(root);
+}

ja/codes/cpp/utils/tree_node.hpp

@@ -0,0 +1,84 @@
+/**
+ * File: tree_node.hpp
+ * Created Time: 2021-12-19
+ * Author: krahets (krahets@163.com)
+ */
+
+#pragma once
+
+#include <limits.h>
+#include <vector>
+
+using namespace std;
+
+/* 二分木ノード構造 */
+struct TreeNode {
+    int val{};
+    int height = 0;
+    TreeNode *parent{};
+    TreeNode *left{};
+    TreeNode *right{};
+    TreeNode() = default;
+    explicit TreeNode(int x, TreeNode *parent = nullptr) : val(x), parent(parent) {
+    }
+};
+
+// シリアル化エンコーディング規則については以下を参照：
+// https://www.hello-algo.com/chapter_tree/array_representation_of_tree/
+// 二分木の配列表現：
+// [1, 2, 3, 4, None, 6, 7, 8, 9, None, None, 12, None, None, 15]
+// 二分木の連結リスト表現：
+//             /——— 15
+//         /——— 7
+//     /——— 3
+//    |    \——— 6
+//    |        \——— 12
+// ——— 1
+//     \——— 2
+//        |    /——— 9
+//         \——— 4
+//             \——— 8
+
+/* 配列を二分木に逆シリアル化する：再帰的 */
+TreeNode *vectorToTreeDFS(vector<int> &arr, int i) {
+    if (i < 0 || i >= arr.size() || arr[i] == INT_MAX) {
+        return nullptr;
+    }
+    TreeNode *root = new TreeNode(arr[i]);
+    root->left = vectorToTreeDFS(arr, 2 * i + 1);
+    root->right = vectorToTreeDFS(arr, 2 * i + 2);
+    return root;
+}
+
+/* 配列を二分木に逆シリアル化する */
+TreeNode *vectorToTree(vector<int> arr) {
+    return vectorToTreeDFS(arr, 0);
+}
+
+/* 二分木を配列にシリアル化する：再帰的 */
+void treeToVecorDFS(TreeNode *root, int i, vector<int> &res) {
+    if (root == nullptr)
+        return;
+    while (i >= res.size()) {
+        res.push_back(INT_MAX);
+    }
+    res[i] = root->val;
+    treeToVecorDFS(root->left, 2 * i + 1, res);
+    treeToVecorDFS(root->right, 2 * i + 2, res);
+}
+
+/* 二分木を配列にシリアル化する */
+vector<int> treeToVecor(TreeNode *root) {
+    vector<int> res;
+    treeToVecorDFS(root, 0, res);
+    return res;
+}
+
+/* 二分木に割り当てられたメモリを解放する */
+void freeMemoryTree(TreeNode *root) {
+    if (root == nullptr)
+        return;
+    freeMemoryTree(root->left);
+    freeMemoryTree(root->right);
+    delete root;
+}

ja/codes/cpp/utils/vertex.hpp

@@ -0,0 +1,36 @@
+/**
+ * File: vertex.hpp
+ * Created Time: 2023-03-02
+ * Author: krahets (krahets@163.com)
+ */
+
+#pragma once
+
+#include <vector>
+
+using namespace std;
+
+/* 頂点クラス */
+struct Vertex {
+    int val;
+    Vertex(int x) : val(x) {
+    }
+};
+
+/* 値のリストvals を入力し、頂点のリストvets を返す */
+vector<Vertex *> valsToVets(vector<int> vals) {
+    vector<Vertex *> vets;
+    for (int val : vals) {
+        vets.push_back(new Vertex(val));
+    }
+    return vets;
+}
+
+/* 頂点のリストvets を入力し、値のリストvals を返す */
+vector<int> vetsToVals(vector<Vertex *> vets) {
+    vector<int> vals;
+    for (Vertex *vet : vets) {
+        vals.push_back(vet->val);
+    }
+    return vals;
+}