1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
# Wolfree Dockerfile: Self-Host a Mirror Site of Wolfree Instances
This repository provides a Dockerfile and instructions for self-hosting a mirror site of Wolfree instances.
Follow the instructions below to control Docker through terminal emulators. Docker will automatically execute the static site generator and run the web server.
## Prerequisites
Before getting started, make sure you have the following prerequisites installed on your computer:
1. **Terminal Emulator**: If you are unfamiliar with terminal emulators, you can learn how to use them in [Command Line Crash Course - Learn Web Development | MDN](https://developer.mozilla.org/en-US/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Command_line).
2. **Docker**: If you don't have Docker installed, download it from [docker.com](https://www.docker.com/).
## Instructions
Follow the steps below to self-host a mirror site of Wolfree instances:
1. **Build the Docker Image**:
Open your terminal emulator and execute one of the following commands to build the Docker image. Each command downloads the source code from a different web server. If one of the commands fails, try the next one in the list until the build succeeds.
```shell
docker build -t wolfree https://try.gitea.io/wolfree/wolfree-dockerfile.git
docker build -t wolfree https://codeberg.org/wolfree/wolfree-dockerfile.git
docker build -t wolfree https://git.disroot.org/wolfree/wolfree-dockerfile.git
docker build -t wolfree https://next.forgejo.org/wolfree/wolfree-dockerfile.git
docker build -t wolfree https://git.kiwifarms.net/wolfree/wolfree-dockerfile.git
docker build -t wolfree http://it7otdanqu7ktntxzm427cba6i53w6wlanlh23v5i3siqmos47pzhvyd.onion/wolfree/wolfree-dockerfile.git
```
2. **Run the Docker Container**:
Execute the following command in your terminal emulator to run the Docker container:
```shell
docker run -p 80:80 wolfree
```
3. **Wait for Success Messages**:
Wait until Docker outputs success messages similar to the following:
```shell
> docusaurus@0.0.0 serve
> docusaurus serve --port 80 --host localhost
[SUCCESS] Serving "build" directory at: http://localhost:80/
```
4. **Access Your Mirror Site**:
You can access your mirror site locally on the same computer where the Docker container runs. Open a web browser, navigate to [http://localhost/](http://localhost/) to access your mirror site, and enter math problems in the text box.
Congratulations! You have successfully self-hosted a mirror site of Wolfree instances.
## Local Development
If you wish to contribute to the development of Wolfree instances, follow these steps:
1. **Prepare the Development Environment**:
Install Git and Docker on your local machine. You can download them from the following official websites:
- [Git Official Website](https://git-scm.com/)
- [Docker Official Website](https://www.docker.com/)
2. **Clone the Repository**:
Run one of the following commands to clone the repository from one of the Gitea and Forgejo servers:
```shell
git clone https://try.gitea.io/wolfree/wolfree-dockerfile.git
git clone https://codeberg.org/wolfree/wolfree-dockerfile.git
git clone https://git.disroot.org/wolfree/wolfree-dockerfile.git
git clone https://next.forgejo.org/wolfree/wolfree-dockerfile.git
git clone https://git.kiwifarms.net/wolfree/wolfree-dockerfile.git
git clone http://it7otdanqu7ktntxzm427cba6i53w6wlanlh23v5i3siqmos47pzhvyd.onion/wolfree/wolfree-dockerfile.git
```
3. **Run the Docker Container**:
After cloning the repository, navigate to the project directory:
```shell
cd wolfree-dockerfile
```
Then, run the following commands to build the image and run the container:
```shell
docker build --tag wolfree --progress=plain .
docker run --publish 80:80 --rm wolfree
```
## Configuring Wolfree Instances for LibRedirect
To configure Wolfree instances to integrate with LibRedirect, follow these steps:
1. Clone the Git repository and open the Dockerfile in a text editor.
2. In the Dockerfile, remove the number sign (#) at the beginning of the `RUN` command. After removing the number sign, the `RUN` command should look like this:
```dockerfile
# Optionally, customize Wolfree instances to suit LibRedirect.
# https://github.com/libredirect/browser_extension/issues/425
# To integrate Wolfree with LibRedirect, please delete the number sign at the beginning of the following line.
RUN PATH="$HOME/.cargo/bin:$PATH" cargo run --manifest-path ./rust/wolfree_libredirect_patch/Cargo.toml -- ;
```
3. Build a Docker image and run a container.
## Helpful Resources for New Developers
If you're new to web development, here are some helpful websites and tools to get you started:
- [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Learn): MDN is a comprehensive resource for web developers. It offers guides, tutorials, and references for various web technologies. It's a great place to learn and explore web development concepts.
- [Web Dev](https://web.dev/learn/): Web Dev is a learning platform by Google that offers web development courses. It provides practical examples to help you improve your skills.
- [Chrome DevTools - Chrome Developers](https://developer.chrome.com/docs/devtools/): Chrome DevTools is a set of web developer tools built directly into the Google Chrome browser. It provides powerful features to inspect and debug web applications.
- [TypeScript: JavaScript With Syntax For Types.](https://www.typescriptlang.org/): TypeScript is a strongly typed programming language that builds on JavaScript, giving you better tooling at any scale.
- [Writing Markup with JSX – React](https://react.dev/learn/writing-markup-with-jsx): JSX is a syntax extension for JavaScript that allows you to write HTML-like markup inside a JavaScript file.
- [Markdown for the component era | MDX](https://mdxjs.com/docs/): MDX is a format that combines markdown, JSX, JavaScript expressions, and import/export statements in JavaScript modules.
- [Desktop/PC - Privacy Guides](https://www.privacyguides.org/en/desktop/): Most Linux distributions have a terminal available by default. You can check out this guide for recommended distributions.
These resources will help you get started and enhance your skills as a web developer. Happy learning!
## License
SPDX-License-Identifier: AGPL-3.0-or-later
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
|
