Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add translated blog #139

Merged
merged 3 commits into from
Jan 15, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 43 additions & 0 deletions i18n/en/docusaurus-plugin-content-blog/2024/02-08-mirrorz.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
title: Integration of MirrorZ Documentation
authors: chengzi
---

Currently, our mirror site is lacking some documentation. In addition, as we synchronize more mirror sources in the future and these mirror sources are constantly updated, we will have to spend a great deal of time maintaining the documentation.
We hope to integrate the documentation of some less popular mirror sources on our site with that of MirrorZ, so as to provide better services for our users.
After the integration, we expect to utilize the more frequently updated and newer documentation of MirrorZ to help users make better use of our mirror site.

<!-- truncate -->

## Integration Methods

According to the Readme of MirrorZ, we can integrate MirrorZ's documentation in the following ways:

- link in the mirror frontend e.g., ISCAS, SJTUG and SDU
- link in the mirror help e.g., NWAFU
- Fork/Rebase and Transpile mdx to local markdown e.g., TUNA/BFSU
- Self-host e.g., xtom.help
- Reverse proxy e.g., NJU

We have taken the following points into consideration:
1. We hope that when users browse our mirror site, they can directly access the documentation of MirrorZ without having to jump to other sites.
2. We hope that when users read the documentation of MirrorZ, they can have an experience similar to that of the documentation we maintain.
3. We hope to make some customized modifications to the documentation of MirrorZ, such as modifying the addresses of hyperlinks to adapt to our site.
Based on the above requirements, we have decided to integrate the documentation of MirrorZ using the third method

jingfelix marked this conversation as resolved.
Show resolved Hide resolved
## Scheme

The script we write will follow these steps to integrate the documentation of MirrorZ:

1. Download the documentation of MirrorZ.
2. Convert the documentation of MirrorZ to the format of our site.
3. Replace the addresses of hyperlinks.
4. Replace the metadata in the front matter part of markdown.
5. Add a source tip and the original link.

In addition, we also need to write an update script to assist in the synchronization with the upstream documentation later.

## Implementation

We have implemented two scripts, one for downloading and generating the documentation of MirrorZ, and the other for updating the documentation of MirrorZ. The specific implementation can be referred to the scripts directory in the site directory. The usage can be referred to the Readme.
In the future, we will consider using tools similar to Github Actions to automate the update process, so that the documentation can be updated regularly and kept in sync with the upstream.
14 changes: 14 additions & 0 deletions i18n/en/docusaurus-plugin-content-blog/2024/02-22-change.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
title: Mirror change notice
authors: chengzi
---

In order to make better use of the limited storage space, we have made the following adjustments to the mirror station.

The following mirrors have been added:

- termux

The following mirrors have been removed:

- loongson
12 changes: 12 additions & 0 deletions i18n/en/docusaurus-plugin-content-blog/2024/03-12-change.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
title: Mirror change notice
authors: chengzi
---

In order to make better use of the limited storage space, we have made the following adjustments to the mirror site.

The following mirrors will be removed:

- AOSP
- git-repo
- gcc.git
27 changes: 27 additions & 0 deletions i18n/en/docusaurus-plugin-content-blog/2024/03-14-update-cli.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
title: hustmirror-cli v1.1 release
authors: chengzi
---

hustmirror-cli v1.1 has been released.

The new version adds support for some distributions and software sources.
The latest version of hustmirror-cli has been updated to the mirror site. For users who have already installed it, please use the hustmirror-cli update command to update to the latest version.

<!-- truncate -->

## Distributions and software sources supported by this version

- anolis
- archlinux
- blackarch
- crates
- debian
- deepin
- kali
- ohmyzsh
- openeuler
- openkylin
- pypi
- rustup
- ubuntu
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
title: Migrate the Source Code of the Mirror Site to GitHub
authors: chengzi
---

We have already migrated the mirror site to GitHub to better support the open-source community.

- Front-end code:[https://github.com/hust-open-atom-club/hust-mirrors](https://github.com/hust-open-atom-club/hust-mirrors)
- Synchronization manager (tunasync) (tunasync):[https://github.com/hust-open-atom-club/tunasync](https://github.com/hust-open-atom-club/tunasync)
- CLI tool:[https://github.com/hust-open-atom-club/hustmirror-cli](https://github.com/hust-open-atom-club/hustmirror-cli)
16 changes: 16 additions & 0 deletions i18n/en/docusaurus-plugin-content-blog/2024/03-28-change.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
title: Mirror change notice
authors: chengzi
---

In order to make better use of limited storage space, we make the following adjustments to the mirror site.

Since the new version of Raspberry Pi Debian completely uses the Debian software source, we delete the following mirrors.

- raspbian
- raspberrypi
- raspbian-addons

At the same time, the official Debian repository already contains non-free software. We delete the following mirrors.

- debian-nonfree
11 changes: 11 additions & 0 deletions i18n/en/docusaurus-plugin-content-blog/2024/05-07-public-open.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
title: Hello, friends on the Internet!
authors: chengzi
---

From the initial nginx autoindex to the full-fledged web service we have today; from being used only by a dozen people internally at the very beginning to now being a public service; from synchronizing only four or five mirrors initially to dozens of them currently; from having a storage capacity of just a few hundred gigabytes to tens of terabytes today.
After a whole year of testing and improvement, our mirror site has finally been officially opened to the public! :joy:
Now, our mirror site has truly become a "mirror site" in the real sense, providing more convenient services for a vast number of Internet users. You can access our mirror site from anywhere in the world to download the software packages, mirrors, source code repositories, and so on that you need.

**Meanwhile, we have discontinued the use of the old domain name mirrors.hust.college and only retained the service of mirrors.hust.edu.cn. Please note to update accordingly.**

31 changes: 31 additions & 0 deletions i18n/en/docusaurus-plugin-content-blog/2024/06-26-maintain.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
title: Service Maintenance Notice
authors: chengzi
---

Starting from June 26th and lasting until July 10th, we will carry out a large-scale adjustment to the storage space of the mirror site. This mainly involves the expansion of the disk array and data migration.

During this period, the service may become unstable, and some mirror sources may not be updated in a timely manner. There may even be cases where they are inaccessible. Please, all users, make preparations in advance and switch to other alternative sources.

We will complete the maintenance work as soon as possible. We apologize for any inconvenience caused.

<!-- truncate -->

The mirror sources that may be affected during this period are:

- pypi
- deepin
- deppin-cd
- openkylin-cdimage
- anolis
- ubuntukylin
- ubuntukylin-cdimage
- virtualbox
- buildroot
- gnu
- CPAN
- alpine
- crates.io-index
- crates
- Rustup