@@ -32,7 +32,7 @@ View More Screenshots
Xplorer is a file explorer built from ground-up to be fully customizable. And even without any customization, it already looks modern!
-Xplorer is a cross-platform application built using [Electron](https://www.electronjs.org/), and you can run it on Windows, MacOS, or Linux without having much trouble. One of the key feature is Xplorer allows you to preview the files you have directly inside Xplorer. And it's not only limited to picture or document preview, but also video preview.
+Xplorer is a cross-platform application built using [Tauri](https://tauri.studio), and you can run it on Windows, MacOS, or Linux without having much trouble. One of the key feature is Xplorer allows you to preview the files you have directly inside Xplorer. And it's not only limited to picture or document preview, but also video preview.
To summarize, Xplorer's features contain:
@@ -40,9 +40,11 @@ To summarize, Xplorer's features contain:
- Easy to use
- Cross-platform
- [File Preview](https://xplorer.vercel.app/docs/guides/operation/#preview-file), even for videos!
+- Customizable
+- Supports multiple tab
- Most importantly, Free and Open Source Software(FOSS), which means you can change components inside if you see fit
-Xplorer is currently under heavy development. You can give your suggestions and feedbacks in our [Discussions](https://github.com/kimlimjustin/xplorer/discussions/) page. If you feel comfortable in writing code using Typescript, we highly encourage you to [contribute to this project](https://xplorer.vercel.app/community/Contributing/).
+Xplorer is currently under heavy development. You can give your suggestions and feedbacks in our [Discussions](https://github.com/kimlimjustin/xplorer/discussions/) page. If you feel comfortable in writing code using Typescript and Rust, we highly encourage you to [contribute to this project](https://xplorer.vercel.app/community/Contributing/).
---
@@ -56,6 +58,10 @@ If you want to install Xplorer in your system, you can download the installer fo
If you find any bug, please report it by submitting an issue in our [issue page](https://github.com/kimlimjustin/xplorer/issues) with detailed explanation. Giving some screenshots would also be very helpful.
+## Feature Request
+
+You can also submit a feature request in our [issue page](https://github.com/kimlimjustin/xplorer) or [discussions](https://github.com/kimlimjustin/xplorer/discussions) and we will try to implement it as soon as possible. If you want to contribute to this project, please [contribute to this project](https://xplorer.vercel.app/community/Contributing/).
+
---
## Common Problems
@@ -64,37 +70,29 @@ If you find any bug, please report it by submitting an issue in our [issue page]
-Xplorer keep loading and crashes.
+Opening folder like Documents, Desktop, Downloads makes Xplorer crash
-Try open cmd by typing Win + R and type cmd.
-Enter following command:
-```
-wmic
-```
-
-If the output says the `wmic` is not recognized as internal or internal command, please follow the steps given on [this article](https://superuser.com/questions/1178674/wmic-is-not-recognized-as-an-internal-or-external-command-operable-program-or) or [this article](https://knowledge.informatica.com/s/article/156865?language=en_US).
+Try disabling the [`Extract exe file icon and make it as preview`](https://xplorer.vercel.app/docs/guides/setting/#extract-exe-file-icon-and-make-it-a-preview) option on `Preference` page on Settings.
Also, please make sure that windows defender isn't blocking Xplorer from accessing your documents.
-Opening folder like Documents, Desktop, Downloads makes Xplorer crash
+Xplorer crashes when opening a folder.
+Simply close and reopen Xplorer, Xplorer will fix itself, if it doesn't, please address an issue over here
-Disable the [`Extract exe file icon and make it as preview`](https://xplorer.vercel.app/docs/guides/setting/#extract-exe-file-icon-and-make-it-a-preview) setting.
+
-Also, please make sure that windows defender isn't blocking Xplorer from accessing your documents.
+---
-
-
-
-Xplorer is unstable after installing it.
-
-Simply restart, Xplorer will fix itself, if it doesn't, please address an issue over here
+## Architecture
-
+Xplorer is a cross-platform application built using the [Tauri](https://tauri.studio) framework. Tauri is based on Microsoft Edge-similar webview and Rust to work. Read about tauri [here](https://tauri.studio/en/docs/about/intro)
+
+Xplorer is a polygot application. Xplorer relies on Rust api for file operations and TS, SCSS for the webview. Rust code are under `src-tauri` directory whereas the webview code are under `src` directory. The API that connects webview with the Rust code is under `src/Api` directory.
---
@@ -106,23 +104,25 @@ If you want to run this project in your local system, please follow this guide:
2. Clone the project to your local system using this command
+3. Follow [this guide](https://tauri.studio/en/docs/getting-started/intro/#setting-up-your-environment) to set up Tauri environment
+
```sh
$ git clone https://github.com//xplorer.git
```
-3. Change directory to the root directory of this project
+4. Change directory to the root directory of this project
```sh
$ cd xplorer
```
-4. Install all dependencies using [`yarn`](https://yarnpkg.com/)
+5. Install all dependencies using [`yarn`](https://yarnpkg.com/)
```sh
$ yarn install
```
-5. Run the project in development mode
+6. Run the project in development mode. Please note that it might takes some times for Cargo to install dependencies for the first run.
```sh
$ yarn dev
diff --git a/binding.gyp b/binding.gyp
deleted file mode 100644
index 80183836..00000000
--- a/binding.gyp
+++ /dev/null
@@ -1,19 +0,0 @@
-{
- "targets": [
- {
- "target_name": "module",
- "product_extension": "node",
- "include_dirs" : [ "src/Lib/extracticon" ],
- "conditions": [
- ['OS=="win"', {
- 'cflags': [
- '/EHa',
- ],
- },],
- ],
- "sources": [
- "src/Lib/extracticon/module.cc"
- ]
- }
- ]
-}
\ No newline at end of file
diff --git a/crowdin.yml b/crowdin.yml
index d44c7ce7..6e936357 100644
--- a/crowdin.yml
+++ b/crowdin.yml
@@ -3,28 +3,14 @@ api_token_env: 'CROWDIN_PERSONAL_TOKEN'
preserve_hierarchy: true
files:
[
+ { source: '/docs/i18n/en/**/*', translation: '/docs/i18n/%locale%/**/%original_file_name%' },
+ { source: '/docs/docs/*', translation: '/docs/i18n/%locale%/docusaurus-plugin-content-docs/current/%original_file_name%' },
+ { source: '/docs/docs/guides/*', translation: '/docs/i18n/%locale%/docusaurus-plugin-content-docs/current/guides/%original_file_name%' },
{
- source: '/docs/community/**/*',
- translation: '/docs/i18n/%locale%/docusaurus-plugin-content-docs-community/current/**/%original_file_name%',
- },
- {
- source: '/docs/i18n/en/**/*',
- translation: '/docs/i18n/%locale%/**/%original_file_name%',
- },
- {
- source: '/docs/docs/**/*',
- translation: '/docs/i18n/%locale%/docusaurus-plugin-content-docs/current/**/%original_file_name%',
- },
- {
- source: '/docs/blog/**/*',
- translation: '/docs/i18n/%locale%/docusaurus-plugin-content-blog/**/%original_file_name%',
- },
- {
- source: '/src/Locales/base.json',
- translation: '/src/Locales/%locale%.json',
- },
- {
- source: '/docs/src/pages/**/*',
- translation: '/docs/i18n/%locale%/docusaurus-plugin-content-pages/**/%original_file_name%',
+ source: '/docs/docs/Community/Contributing.md',
+ translation: '/docs/i18n/%locale%/docusaurus-plugin-content-docs/current/Community/Contributing.md',
},
+ { source: '/docs/docs/Community/support.md', translation: '/docs/i18n/%locale%/docusaurus-plugin-content-docs/current/Community/support.md' },
+ { source: '/src/Locales/base.json', translation: '/src/Locales/%locale%.json' },
+ { source: '/docs/src/pages/**/*', translation: '/docs/i18n/%locale%/docusaurus-plugin-content-pages/**/%original_file_name%' },
]
diff --git a/docs/blog/2021-08-09-introduction.md b/docs/blog/2021-08-09-introduction.md
deleted file mode 100644
index 642bb006..00000000
--- a/docs/blog/2021-08-09-introduction.md
+++ /dev/null
@@ -1,45 +0,0 @@
----
-slug: welcome
-title: Welcome
-author: Justin Maximillian Kimlim
-author_title: A High School Student Who Loves Programming
-author_url: https://github.com/kimlimjustin
-author_image_url: https://avatars.githubusercontent.com/u/61906684?v=4
-tags: [xplorer, introduction, hello, blog]
----
-
-
-I am very happy to introduce [Xplorer](https://xplorer.vercel.app) to help you organize your files/folders.
-
-I created Xplorer for the following reasons:
-* Supports Multiple Tabs
-* Easy to use
-* Highly customizable (just like VSCode)
-* Cross-platform
-* Supports previewing apps directly inside Xplorer
-* Looks modern
-* Most importantly, FOSS, Free and Open Source, which means you can change components inside if you see it fit
-
-Xplorer is an app designed to let users manage files/folders easily by supporting multiple tabs, previewing files and so on. Also, it looks modern! You can customize the application by changing the theme, icon and also plugin a custom function into Xplorer (though by the time I write this documentation, it's not done yet, but it will be soon)!
-
-## Why did I build this?
-
-Back then, I was taught Python at my school and I found it interesting when I created the “Hello World” program and I posted some tutorials on making things like Calculator and showoff to my friends XD. Soon after, Covid 19 came and I was bored and got a lot of time, I went to YouTube and learned how to program using PHP, then I switched to JavaScript and found its better.
-
-One day, I found out the [Files](https://files-community.github.io/) and it’s awesome, I use it as my default file explorer. However, I found it quite laggy and at a certain version, it just doesn’t work on my laptop. I opened an issue but they asked me to reinstall windows 10 and they just closed [that Issue](https://github.com/files-community/Files/issues/4287) Meanwhile, I also tried dual-booting with Linux and found out the file manager of Linux is boring and I was unable to use any available file manager out there.
-
-So, I asked myself, why don’t I build one that is a cross-platform, customizable and modern file manager. Besides, I would add some awesome features that other file explorers doesn’t support. Aha, Xplorer was born!
-
-### Why was it built using JavaScript?
-- JavaScript has become the most used language.
-- JavaScript has a very strong community.
-- You can easily write plugin using JavaScript
-- JavaScript can be run in various OSes.
-- Modern layouts can be built using the HTML and CSS from Electron.
-- I'm bad at C/C++
-
-## Community
-We welcome your [contributions](https://xplorer.vercel.app/community/Contributing/) to Xplorer, whether you want to use it as your file manager, you want to contribute to the Xplorer core or just have questions. Follow me on [GitHub](https://github.com/kimlimjustin).
-
-## See ya'll soon!
-Xplorer is currently on development progress (you can try it by manually [setup however](https://xplorer.vercel.app/community/Contributing/#working-on-xplorer-code)), stay tuned till the beta version released!
diff --git a/docs/community/CODE_OF_CONDUCT.md b/docs/docs/Community/CODE_OF_CONDUCT.md
similarity index 100%
rename from docs/community/CODE_OF_CONDUCT.md
rename to docs/docs/Community/CODE_OF_CONDUCT.md
diff --git a/docs/community/Contributing.md b/docs/docs/Community/Contributing.md
similarity index 86%
rename from docs/community/Contributing.md
rename to docs/docs/Community/Contributing.md
index 9cccb267..acc612d2 100644
--- a/docs/community/Contributing.md
+++ b/docs/docs/Community/Contributing.md
@@ -6,7 +6,7 @@ sidebar_position: 2
👍🎉 First off, thanks for taking the time to contribute! 🎉👍
-Xplorer is currently under development. We are welcoming contributors to collaborate on Xplorer.
+Xplorer is currently under heavy development. We are welcoming contributors to collaborate on Xplorer.
## Get involved
@@ -32,7 +32,7 @@ When [opening a new issue](https://github.com/kimlimjustin/xplorer/issues), alwa
### Feature Request {#feat}
-We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)!
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) and [GitHub Issues](https://github.com/kimlimjustin/xplorer) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)!
Great Feature Requests tend to have:
- A quick idea summary.
@@ -43,19 +43,16 @@ Great Feature Requests tend to have:
### Prerequisite
+- [Tauri environment](https://tauri.studio/en/docs/getting-started/intro#setting-up-your-environment)
- [Node JS](https://nodejs.org/en/)
- [Git](https://git-scm.com/)
- [yarn](https://yarnpkg.com/)
-- [GCC Compiler](https://gcc.gnu.org/)
- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
### Installation
1. After cloning the repository, run `yarn` in the root of the repository and run `yarn` in the `docs` folder (if you want to working on Xplorer Docs).
-2. To start Xplorer locally:
-
- - run `yarn start` in the root of the repository if you **don't want** the hot reload feature.
- - run `yarn dev` in the root of the repository if you **want** the hot reload feature.
+2. To start Xplorer locally, run `yarn dev`.
To start a local development server serving the Docusaurus docs, go into the `docs` directory and run `yarn start`
@@ -166,9 +163,7 @@ We host our locales on the [crowdin](https://crwd.in/xplorer). To translate it,
#### Priority Files to translate on Crowdin
1. `src/Locales` files
-2. `docs/docs` files
-3. `docs/i18n/en` files
-4. `docs/community` files
+2. `docs/` files
#### Production
@@ -176,16 +171,6 @@ Once the files on `src/Locales` have been translated for more than 80%, we will
Please comment [here](https://github.com/kimlimjustin/xplorer/discussions/30) if you have any questions!
-### Files Icon
-
-Files icons are available on [`src/Icon`](https://github.com/kimlimjustin/xplorer/tree/master/src/Icon).
-You can add an icon by doing these steps:
-
-- Paste the new icon in `src/icon`
-- Edit the value of [`src/Components/Files/File Icon/icon.json`](https://github.com/kimlimjustin/xplorer/tree/master/src/Components/Files/File%20Icon/icon.json)
-
-### File Type library
-
-The files type library is available on [`src/Components/Files/File Type/type.json`](https://github.com/kimlimjustin/xplorer/tree/master/src/Components/Files/File%20Type/type.json).
+### File Library
-You can add the type of file extension by adding value to the file.
+The json library of file types and thumbnail are found under `lib` folder and the icons are found under `src/Icons` folder. You may add file types and icons for file extensions you want to use and submit a PR.
diff --git a/docs/community/license.md b/docs/docs/Community/license.md
similarity index 99%
rename from docs/community/license.md
rename to docs/docs/Community/license.md
index 117fd120..e1441735 100644
--- a/docs/community/license.md
+++ b/docs/docs/Community/license.md
@@ -1,10 +1,12 @@
---
sidebar_position: 2
---
+
# License
+```
-``` Apache License
+ Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
@@ -205,4 +207,4 @@ sidebar_position: 2
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-```
\ No newline at end of file
+```
diff --git a/docs/community/support.md b/docs/docs/Community/support.md
similarity index 54%
rename from docs/community/support.md
rename to docs/docs/Community/support.md
index 7ff97faf..417b3959 100644
--- a/docs/community/support.md
+++ b/docs/docs/Community/support.md
@@ -1,37 +1,45 @@
---
sidebar_position: 1
---
+
# Support
+
Xplorer is an open-source project which you can freely join and seek support 😊.
On this page, we've listed some communities/forums you can participate in to seek support or help others.
-Before participating in Xplorer's communities, please read our [Code Of Conduct](/community/CODE_OF_CONDUCT/).
+Before participating in Xplorer's communities, please read our [Code Of Conduct](/docs/community/CODE_OF_CONDUCT/).
## Issues
-We use GitHub Issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue. Report a bug by opening a new issue [here](https://github.com/kimlimjustin/xplorer/issues/new). Please use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) instead to suggest a new feature.
+
+We use GitHub Issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue. Report a bug by opening a new issue [here](https://github.com/kimlimjustin/xplorer/issues/new).
## GitHub Discussions
+
GitHub Discussions is used for multiple purposes, such as:
+
1. Asking questions
2. Making feature requests and sharing ideas
-3. Xplorer Announcements
-4. Chat on Xplorer
-5. Show and tell: Making custom themes/plug-ins for Xplorer and showing them there!
-
+3. Chat on Xplorer
+4. Show and tell: Making custom themes/plug-ins for Xplorer and showing them there!
### Feature Request
-We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussion) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)!
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussion) and [GitHub Issues](https://github.com/kimlimjustin/xplorer/issues) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)!
Great Feature Requests tend to have:
-- A quick idea summary.
-- What & why you wanted to add the specific feature.
-- Additional context like images, links to resources to implement the feature, etc.
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional context like images, links to resources to implement the feature, etc.
+
### Help
-You can ask for help using [GitHub Discussion](https://github.com/kimlimjustin/xplorer/discussions) and others will answer you, just like Stack Overflow!
+
+You can ask for help using [GitHub Discussion](https://github.com/kimlimjustin/xplorer/discussions) or [Discord Channel](https://discord.gg/kK7rwxPt).
:::note
Remember to choose the discussion category as Q&A so that your question will be published with answers enabled.
:::
## News
-For the latest news about Xplorer, you can see it through the [official Xplorer blog](/blog) on this website.
+
+For the latest news about Xplorer, you can see it through posts on [Forem](https://dev.to/t/xplorer).
diff --git a/docs/docs/common_problems.md b/docs/docs/common_problems.md
index 0329306c..d6a89938 100644
--- a/docs/docs/common_problems.md
+++ b/docs/docs/common_problems.md
@@ -1,3 +1,7 @@
+---
+sidebar_position: 3
+---
+
# Common Problems
**NB: For common problems during installation, please open [here](/docs/install/#common-problems)**
@@ -5,25 +9,6 @@
-### Xplorer keep loading and crashes.
-
-
-
-Try opening `cmd` by opening Win + R(Run) and type `cmd`.
-
-Enter following command:
-
-```
-wmic
-```
-
-If the output says the `wmic` is not recognized as internal or internal command, please follow the following steps given on [this](https://superuser.com/questions/1178674/wmic-is-not-recognized-as-an-internal-or-external-command-operable-program-or) or [this](https://knowledge.informatica.com/s/article/156865?language=en_US). Also, please make sure that Windows Defender isn't blocking Xplorer from accessing your documents.
-
-
-
-
-
-
### Opening folder like `Documents`, `Desktop`, `Downloads` make Xplorer crashes
diff --git a/docs/docs/customization/_category_.json b/docs/docs/customization/_category_.json
deleted file mode 100644
index 2e564234..00000000
--- a/docs/docs/customization/_category_.json
+++ /dev/null
@@ -1,4 +0,0 @@
-{
- "label": "Customization",
- "position": 3
-}
diff --git a/docs/docs/customization/theme.md b/docs/docs/customization/theme.md
deleted file mode 100644
index 3f7223b6..00000000
--- a/docs/docs/customization/theme.md
+++ /dev/null
@@ -1,84 +0,0 @@
-# Color Theme
-
-## Prerequiste
-
-For both developing and using a theme on Xplorer, you should have Xplorer's CLI Installed.
-
-
-
-Install Xplorer CLI on Windows
-
-
-Firstly, you have to register the command into the system path.
-
-1. Open the `System Properties` on Windows.
-2. Click the `Environment Variables` button, it will pop up a window.
-3. On the table, search for `Path` variable and click on it.
-4. Click the `Edit` button, it will pop up a window.
-5. Click the `New` button
-6. Add `%USERPROFILE%\AppData\Local\Programs\xplorer`
-
-
-
-## Writing Theme
-
-Xplorer use [`yeoman`](https://yeoman.io/) as a generator to generate a color theme template, the generator should generates a `package.json` and a JavaScript file containing a color scheme template (It's `light` theme's color scheme as default).
-
-### Get Started
-
-To get started, you have to install yeoman globally, you can do this by running the following command:
-
-```bash
-npm i -g yo
-```
-
-After installing yeoman, you can start generating Xplorer theme by running the following command:
-
-```bash
-yo xplorer-theme
-```
-
-:::info
-`generator-xplorer-theme` is under development, to use it now, you have to clone the Xplorer repository and run `yarn link` inside the `packages/generator-xplorer-theme` directory.
-:::
-
-The command will create `package.json` and a JavaScript file containing your color scheme.
-
-### File Structure
-
-The JavaScript file should export a function as `exports.default`, the function should return the object of your theme's color scheme.
-
-:::tip
-Within the function, you can add `document.querySelector` to change something you wish to that cannot be edited via the color scheme.
-:::
-
-### Development
-
-You can start developing Xplorer theme by running `yarn start` command. Before starting the development process, please change your `App Theme` to the system default (for some reasons it's buggy if you don't set it into system default)
-
-### Production
-
-To flash your color theme into Xplorer, you can simply run `yarn build` command.
-
-## Using Theme
-
-To use a color scheme developed by others, you have to get the code locally, this can be done by cloning their repository, etc.
-
-### Flashing color theme into Xplorer
-
-To flash a color theme into Xplorer, you can simply run `yarn build` in the project root.
-
-## Examples
-
-Examples of custom color theme are available [here](https://github.com/kimlimjustin/xplorer/tree/master/packages/generator-xplorer-theme/example).
-
-## Common Question
-
-
-
-Why don't you just develop a marketplace so user can easily share their theme with others?
-
-
-I can't afford to buy a server for developing marketplace xD, but will consider it in the future, if you want to sponsor/offer it, feel free to contact [me](mailto:kimlimjustin@gmail.com)
-
-
diff --git a/docs/docs/guides/_category_.json b/docs/docs/guides/_category_.json
index a79246b5..b1419d2f 100644
--- a/docs/docs/guides/_category_.json
+++ b/docs/docs/guides/_category_.json
@@ -1,5 +1,4 @@
{
- "label": "Guides",
- "position": 3
+ "label": "Guides",
+ "position": 4
}
-
\ No newline at end of file
diff --git a/docs/docs/guides/cli.md b/docs/docs/guides/cli.md
index 0db45d8a..e125b4f0 100644
--- a/docs/docs/guides/cli.md
+++ b/docs/docs/guides/cli.md
@@ -1,9 +1,5 @@
# Launch Xplorer from Terminal
-:::info
-This feature hasn't been optimized yet. It works but it might be laggy. This will be optimized in the feature release.
-:::
-
## Commands
Xplorer CLI:
@@ -16,24 +12,6 @@ Xplorer will open `dir`, `dir2`, `dir3` as tabs on Xplorer. If there's no direct
Options:
-| Command | Alias | Description |
-| ----------- | ----- | ---------------------------------------------- |
-| `--help` | `-h` | Show help |
-| `--version` | `-v` | Show version number |
-| `--reveal` | `-r` | Open the containing folder and select the file |
-
-
-
-xplorer: command not found error on Windows
-
-
-Firstly, you have to register the command into the system path.
-
-1. Open the `System Properties` on Windows.
-2. Click the `Environment Variables` button, it will pop up a window.
-3. On the table, search for the `Path` variable and click on it.
-4. Click the `Edit` button, it will pop up a window.
-5. Click the `New` button.
-6. Add `%USERPROFILE%\AppData\Local\Programs\xplorer`.
-
-
+| Command | Alias | Description |
+| ---------- | ----- | ---------------------------------------------- |
+| `--reveal` | `-r` | Open the containing folder and select the file |
diff --git a/docs/docs/guides/operation.md b/docs/docs/guides/operation.md
index 33d28118..3deaaeb4 100644
--- a/docs/docs/guides/operation.md
+++ b/docs/docs/guides/operation.md
@@ -6,13 +6,9 @@ You can copy files by right-clicking it and click the `Copy` option or select th
:::info
-On Windows and macOS, Xplorer will copy the file paths into the local clipboard, because of this, you can copy a file from Xplorer and paste it into any folder in another system. However, on Linux, we create a string of Xplorer commands and copy it into the user clipboard, Xplorer will read the user's clipboard when pasting the file (because we haven't found any idea to implement it, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us). The string of the Xplorer command looks like this:
+For current implementation, Xplorer write down what to copy locally (not copying to clipboard).
-```
-Xplorer command - COPY
-~/xplorer
-~/test
-```
+TODO: implement copy to clipboard
:::
@@ -25,30 +21,29 @@ You can copy a file/folder location path into your clipboard by right-clicking i
You can cut files by right-clicking it and click the `Cut` option or select the file then press `Ctrl + X` as a shortcut and paste it by clicking the `Paste` option or press `Ctrl + V` on the destination folder.
:::info
-This is done by creating a string of Xplorer command and copies it into the user clipboard to be used when pasting file (this is not integrated with the platform because we haven't found any idea, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.). The string of Xplorer command looks like this:
-```
-Xplorer command - CUT
-E://xplorer
-E://test
-```
+For current implementation, Xplorer write down what to cut locally (not copying to clipboard).
:::
## Delete files
-You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut. The trashed file can be accessed at `xplorer://Trash`.
+You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut.
-:::info
+### Trashed files
-- On Windows, this is done by creating a `Trash` folder on the `C:` drive and moving the file into it.
-- On Linux, this feature is fully integrated with the system.
-- On macOS, this is done by creating a `.local/Trash` folder on `homedir` and moving the file into it.
+The trashed file can be accessed at `xplorer://Trash` or your system trash folder.
+:::danger Open Issue
-We are still working on Windows on macOS to integrate the `Trash` folder, which will be released before the stable version came out. Feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.
+Please note that Trash folder cannot be accessed on macos via Xplorer since the [trash crate](https://github.com/Byron/trash-rs) Xplorer relies to does not support it (see [this issue](https://github.com/Byron/trash-rs/issues/8) for more details).
+Any contributions to either the trash crate or Xplorer itself for this topic are welcome.
:::
+### Restore files
+
+You can restore files by opening the `xplorer://Trash` and right-clicking it and click the `Restore` option
+
### Permanently delete
:::danger
@@ -103,72 +98,12 @@ You can preview a file directly from Xplorer by right-clicking it and click the
Files available to preview for now:
-
-```json
-[
- ".pdf",
- ".html",
- ".docx",
- ".htm",
- ".xlsx",
- ".xls",
- ".xlsb",
- "xls",
- ".ods",
- ".fods",
- ".csv",
- ".txt",
- ".py",
- ".js",
- ".bat",
- ".css",
- ".c++",
- ".cpp",
- ".cc",
- ".c",
- ".diff",
- ".patch",
- ".go",
- ".java",
- ".json",
- ".php",
- ".ts",
- ".tsx",
- ".jsx",
- ".jpg",
- ".png",
- ".gif",
- ".bmp",
- ".jpeg",
- ".jpe",
- ".jif",
- ".jfif",
- ".jfi",
- ".webp",
- ".tiff",
- ".tif",
- ".ico",
- ".svg",
- ".webp",
- ".mp4",
- ".webm",
- ".mpg",
- ".mp2",
- ".mpeg",
- ".mpe",
- ".mpv",
- ".ocg",
- ".m4p",
- ".m4v",
- ".avi",
- ".wmv",
- ".mov",
- ".qt",
- ".flv",
- ".swf",
- ".md"
-]
-```
+* Markdown files
+* Image files
+* Text files
+* Video files
+* Pdfs
+* Almost all programming language with syntax highlighting
diff --git a/docs/docs/guides/setting.md b/docs/docs/guides/setting.md
index 48b26ec0..54a4fa99 100644
--- a/docs/docs/guides/setting.md
+++ b/docs/docs/guides/setting.md
@@ -13,28 +13,57 @@ You can open settings on Xplorer by clicking the `Settings` button on the left d
How to exit from Settings?
-You can exit from Settings on Xplorer by clicking the Arrow Up button on the upside left of Xplorer.
+You can exit from Settings on Xplorer by clicking on the upside left of Xplorer.
-## App Theme
+## Appearance
+
+### App Theme
You can change Xplorer's app theme on the `Appearance` tab of the Settings. Available default themes are `light`, `light+`, `dark`, and `dark+`. Besides, there is a `System Default` theme that will automatically read your system preference.
:::info
Xplorer will support a custom app theme soon, stay tuned!
:::
-### Acrylic Effect
+### Font Family
+
+You can change Xplorer's font family on the `Appearance` tab of the Settings to one of installed font families installed on your system.
+
+### Font Size
+
+You can change Xplorer's font size on the `Appearance` tab of the Settings. Please note that an ideal font size is between 10px to 30px.
+
+### Window Transparency
+
+Make Xplorer window transparent on the `Appearance` tab of the Settings by combining following options. Please note that an ideal transparency is between 70% to 100%. You can disable transparency by disable all of the transparency options.
+
+#### Transparent Sidebar
-The Acrylic Effect is the effect that gives the transparency effect on the sidebar. Only works on Windows 10 and higher.
+Make the sidebar transparent
+
-## File Preview
+#### Transparent Topbar
-The file preview here means the preview that replaces the default icon of a file.
+Make the topbar transparent
+
-### Play video file as a preview
+#### Transparent Workspace
+
+make the workspace transparent
+
+
+### Frame Style
+
+You can choose the frame style on the `Appearance` tab of the Settings. The available options are `Default` and `System Default`. `Default` will use Xplorer's default style which is the same across platforms. `System Default` will use the system default frame style which is difference according to your platform.
+
+### File Preview
+
+File Preview here might means the file thumbnail.
+
+#### Automatically play video file as thumbnail
This will automatically play the video file as a preview.
:::caution THIS MIGHT CONSUME HIGH AMOUNT OF RAM
@@ -42,7 +71,15 @@ This might consume a high amount of RAM because it's built on the HTML video pla
You can just enable this setting and ignore this caution if you got a good-spec computer.
:::
-### Extract `EXE` file icon and make it a preview
+#### Preview image on hover
+
+This fill automatically show the image when you hovering it for 500ms.
+
+
+
+Some people might found it annoying and you can disable it by disabling this setting.
+
+#### Extract exe file icon and make it as the thumbnail
This will parse and cache the icon from a `exe` file and make it a preview. Only on Windows.
@@ -56,25 +93,48 @@ The way to fix it is to disable the setting.
:::
-## Default file layout
+:::info Open issue
+The current approach is by calling the powershell program which might pops up cmd windows.
+
+Any contribution to call it directly from Xplorer is welcome.
+:::
+
+#### Show Image as Thumbnail
+
+This will show the image as a thumbnail of a file. Please note that this is not recommended for large directory as it reads the image to memory.
+
+#### Default file layout
Default file layout of a directory. Just give it a try :)
-## App Language
+## Preference
+
+### App Language
Localize Xplorer. Help us translate Xplorer [here](https://github.com/kimlimjustin/xplorer/discussions/30).
-## Hide Hidden Files
+### Hide Hidden Files
Hide hidden files on Xplorer, you can find this setting on the `Preference` tab on Xplorer or by its shortcut, `Ctrl + H`.
-## Hide System Files
+### Hide System Files
Hide Windows' system files on Xplorer.
:::tip
Learn what is system file [here](https://en.wikipedia.org/wiki/System_file). Just turn it off if you don't understand what it is.
:::
-## List and sort directories alongside files
+### List and sort directories alongside files
If disabled, Xplorer will prioritize directories above files.
+
+### Detect Drive Change
+
+Turning this on will detect drive change and update the sidebar and drives section. Please note that this will take high ammount of RAM as this is not stabilized yet.
+
+### On startup
+
+Option to do on starting Xplorer. Available options are:
+
+- New Tab
+- Continue previous session
diff --git a/docs/docs/guides/shortcut.md b/docs/docs/guides/shortcut.md
index 5b2a2254..c6e53684 100644
--- a/docs/docs/guides/shortcut.md
+++ b/docs/docs/guides/shortcut.md
@@ -4,19 +4,22 @@
| ------------------- | ------------------------ |
| `Ctrl + A` | Select All |
| `Ctrl + C` | Copy |
-| `Ctrl + E` | Close Tab |
| `Ctrl + H` | Toggle Hidden Files |
-| `Ctrl + O` | Preview file |
+| `Ctrl + N` | New window shortcut |
+| `Ctrl + O` | Open file in preview |
| `Ctrl + P` | Files/Folders Properties |
| `Ctrl + R` | Reload |
| `Ctrl + T` | New Tab |
| `Ctrl + V` | Paste |
| `Ctrl + X` | Cut |
-| `Ctrl + W` | Exit Xplorer |
+| `Ctrl + W` | Exit Tab |
+| `Ctrl + Y` | Redo |
+| `Ctrl + Z` | Undo |
+| `Ctrl + Shift + Z` | Redo |
| `Alt + Left Arrow` | Go Back |
| `Alt + Right Arrow` | Go Forward |
-| `Alt + Up Arrow` | maximize |
-| `Alt + Down Arrow` | minimize |
+| `Alt + Up Arrow` | Go to parent directory |
+| `Alt + N` | New File |
| `Alt + T` | Open in terminal |
| `Alt + P` | Pin to sidebar |
| `Alt + Shift + C` | Copy location path |
@@ -31,6 +34,6 @@
| `Del` | Delete file |
:::note Difference between `reload` and `refresh`
-`Reload` refreshes the internal HTML while `Refresh` refreshes the whole Electron process.
+`Reload` refreshes the internal process while `Refresh` refreshes the whole process.
:::
diff --git a/docs/docs/guides/xplorer as default.md b/docs/docs/guides/xplorer as default.md
index d080be07..0602fd10 100644
--- a/docs/docs/guides/xplorer as default.md
+++ b/docs/docs/guides/xplorer as default.md
@@ -13,7 +13,7 @@ This guide involves modifying the Windows registry, make sure to create a backup
4. Navigate to `Computer\HKEY_CURRENT_USER\Software\Classes\Directory`
5. Create a key named `shell` if not existed by right and set the default key-value to `openinxplorer`
6. Create a key named `openinxplorer` under `shell`
-7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Users\User\AppData\Local\Programs\Microsoft VS Code\Code.exe" "%V"`
+7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Program Files\Xplorer\Xplorer.exe" "%V"`. (You may have to change `C:\Program Files\Xplorer\` to the location you installed Xplorer)
diff --git a/docs/docs/intro.md b/docs/docs/intro.md
index 82a1ac0d..b96b9e52 100644
--- a/docs/docs/intro.md
+++ b/docs/docs/intro.md
@@ -8,16 +8,18 @@ sidebar_position: 1
Welcome to Xplorer, A Free and Open Source (FOSS) File Explorer.
-Xplorer is a file explorer built from the ground up to be fully customizable and without customization, it also looks modern!
-It is cross-platform, built using Electron Technology that allowed our File Explorer to be run not only in Windows but also Linux and MacOS alike.
-It also allowed file preview directly inside it, not only pictures or documents but also videos!
+Xplorer is a file explorer built from ground-up to be fully customizable. And even without any customization, it already looks modern!
-## Features
+Xplorer is a cross-platform application built using [Tauri](https://tauri.studio), and you can run it on Windows, MacOS, or Linux without having much trouble. One of the key feature is Xplorer allows you to preview the files you have directly inside Xplorer. And it's not only limited to picture or document preview, but also video preview.
-So to summarize, Xplorer's features contain:
+To summarize, Xplorer's features contain:
-- Looks modern
+- It looks modern
- Easy to use
- Cross-platform
-- File Preview, even videos!
-- Most importantly, it's Free and Open Source! Which mean you can change components inside if you see fit and you also don't need to make your wallet go dry or break the bank.
+- [File Preview](https://xplorer.vercel.app/docs/guides/operation/#preview-file), even for videos!
+- Customizable
+- Supports multiple tab
+- Most importantly, Free and Open Source Software(FOSS), which means you can change components inside if you see fit
+
+Xplorer is currently under heavy development. You can give your suggestions and feedbacks in our [Discussions](https://github.com/kimlimjustin/xplorer/discussions/) page. If you feel comfortable in writing code using Typescript and Rust, we highly encourage you to [contribute to this project](https://xplorer.vercel.app/community/Contributing/).
diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js
index aa92a943..32c3c789 100644
--- a/docs/docusaurus.config.js
+++ b/docs/docusaurus.config.js
@@ -15,24 +15,13 @@ module.exports = {
trailingSlash: true,
i18n: {
defaultLocale: 'en',
- locales: [
- 'en',
- 'id-ID',
- 'zh-CN',
- 'zh-TW',
- 'ru-RU',
- 'pt-BR',
- 'de-DE',
- 'es-ES',
- 'uk-UA',
- ],
+ locales: ['en', 'id-ID', 'zh-CN', 'zh-TW', 'ru-RU', 'pt-BR', 'de-DE', 'es-ES', 'uk-UA'],
},
themeConfig: {
hideableSidebar: true,
announcementBar: {
id: 'support_us',
- content:
- 'Xplorer is still under heavy development, any features might change anytime.',
+ content: 'Xplorer is still under heavy development, any features might change anytime.',
backgroundColor: '#fafbfc',
textColor: '#091E42',
},
@@ -45,7 +34,7 @@ module.exports = {
title: 'Xplorer',
logo: {
alt: 'Xplorer Logo',
- src: 'img/icon.svg',
+ src: 'img/icon.png',
},
items: [
{
@@ -54,12 +43,8 @@ module.exports = {
position: 'left',
label: 'Tutorial',
},
- { to: '/blog', label: 'Blog', position: 'left' },
- {
- to: '/community/support',
- label: 'Community',
- position: 'left',
- },
+ { to: 'https://dev.to/t/xplorer', label: 'Blog', position: 'left' },
+ { to: 'https://discord.gg/kK7rwxPt', label: 'Discord', position: 'left' },
{
type: 'localeDropdown',
position: 'right',
@@ -95,6 +80,10 @@ module.exports = {
label: 'GitHub Discussions',
href: 'https://github.com/kimlimjustin/xplorer/discussions',
},
+ {
+ label: 'Discord',
+ href: 'https://discord.gg/kK7rwxPt',
+ },
],
},
],
@@ -144,32 +133,11 @@ module.exports = {
],
plugins: [
'plugin-image-zoom',
- [
- '@docusaurus/plugin-content-docs',
- {
- path: 'community',
- id: 'community',
- routeBasePath: 'community',
- editUrl: ({ locale, docPath }) => {
- if (locale === 'en') {
- return `https://github.com/kimlimjustin/xplorer/edit/master/docs/community/${docPath}`;
- } else {
- return `https://crowdin.com/project/xplorer`;
- }
- },
- showLastUpdateAuthor: true,
- showLastUpdateTime: true,
- },
- ],
[
'@docusaurus/plugin-pwa',
{
debug: true,
- offlineModeActivationStrategies: [
- 'appInstalled',
- 'standalone',
- 'queryString',
- ],
+ offlineModeActivationStrategies: ['appInstalled', 'standalone', 'queryString'],
pwaHead: [
{
tagName: 'link',
diff --git a/docs/i18n/de-DE/docusaurus-plugin-content-docs-community/current/support.md b/docs/i18n/de-DE/docusaurus-plugin-content-docs-community/current/support.md
index ecdd4114..afddd22c 100644
--- a/docs/i18n/de-DE/docusaurus-plugin-content-docs-community/current/support.md
+++ b/docs/i18n/de-DE/docusaurus-plugin-content-docs-community/current/support.md
@@ -1,34 +1,43 @@
---
sidebar_position: 1
---
+
# Unterstützung
+
Xplorer is an open-source project which you can freely join and seek support 😊.
On this page, we've listed some communities/forums you can participate in to seek support or help others.
-Before participating in Xplorer's communities, please read our [Code Of Conduct](/community/CODE_OF_CONDUCT/).
+Before participating in Xplorer's communities, please read our [Code Of Conduct](/docs/community/CODE_OF_CONDUCT/).
## Issues
+
We use GitHub Issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue. Report a bug by opening a new issue [here](https://github.com/kimlimjustin/xplorer/issues/new). Please use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) instead to suggest a new feature.
## GitHub Discussions
+
GitHub Discussions is used for multiple purposes, such as:
+
1. Asking questions
2. Making feature requests and sharing ideas
3. Xplorer Announcements
4. Chat on Xplorer
5. Show and tell: Making custom themes/plug-ins for Xplorer and showing them there!
-
### Feature Request
+
We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussion) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
-- A quick idea summary.
-- What & why you wanted to add the specific feature.
-- Additional context like images, links to resources to implement the feature, etc.
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional context like images, links to resources to implement the feature, etc.
+
### Help
+
You can ask for help using [GitHub Discussion](https://github.com/kimlimjustin/xplorer/discussions) and others will answer you, just like Stack Overflow!
:::note Remember to choose the discussion category as Q&A so that your question will be published with answers enabled. :::
## News
+
For the latest news about Xplorer, you can see it through the [official Xplorer blog](/blog) on this website.
diff --git a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/Community/Contributing.md b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/Community/Contributing.md
new file mode 100644
index 00000000..be326698
--- /dev/null
+++ b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/Community/Contributing.md
@@ -0,0 +1,173 @@
+---
+sidebar_position: 2
+---
+
+# Contribute
+
+👍🎉 First off, thanks for taking the time to contribute! 🎉👍
+
+Xplorer is currently under heavy development. We are welcoming contributors to collaborate on Xplorer.
+
+## Get involved
+
+There are many ways to contribute to Xplorer, and many of them do not involve writing any code. Here are few ideas to get started:
+
+- Start using Xplorer! Go through the Tutorial guides. Does anything work as expected? If not, we're always looking for improvements. Let us know by opening an issue.
+- Look through the [Xplorer issues](https://github.com/kimlimjustin/xplorer/issues). If you find an issue you would like to fix, [open a pull request](#first-pull-request). Issues tagged as [good first issue](https://github.com/kimlimjustin/xplorer/labels/good%20first%20issue) are a good place to get started.
+- Help us make the docs better. File an issue if you find anything that is confusing, any grammatical error, or can be improved.
+- Take a look at [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) and give your opinion into a discussion or consider opening a pull request if you see something you want to work on.
+
+Contributions are very welcome!
+
+## Our development process
+
+Xplorer uses [GitHub](https://github.com/kimlimjustin/xplorer) as its source of truth. The core team will work directly there. All changes will be public from the beginning.
+
+### Reporting new issues/bugs. {#issues}
+
+When [opening a new issue](https://github.com/kimlimjustin/xplorer/issues), always make sure to fill out the issue template. We use GitHub issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue.
+
+- _One issue, one bug_: Please report a single bug per issue.
+- _Provide reproduction steps_: List all the steps necessary to reproduce the issue. The person reading your bug report should be able to follow these steps to reproduce your issue with minimal effort.
+
+### Feature Request {#feat}
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) and [GitHub Issues](https://github.com/kimlimjustin/xplorer) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional references like images, links of resources about the feature, etc.
+
+## Working on Xplorer code
+
+### Prerequisite
+
+- [Tauri environment](https://tauri.studio/en/docs/getting-started/intro#setting-up-your-environment)
+- [Node JS](https://nodejs.org/en/)
+- [Git](https://git-scm.com/)
+- [yarn](https://yarnpkg.com/)
+- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
+
+### Installation
+
+1. After cloning the repository, run `yarn` in the root of the repository and run `yarn` in the `docs` folder (if you want to working on Xplorer Docs).
+2. To start Xplorer locally, run `yarn dev`.
+
+ To start a local development server serving the Docusaurus docs, go into the `docs` directory and run `yarn start`
+
+### Gitpod {#gitpod-env}
+
+Gitpod is a Ready-to-Code environment in which you can get started immediately. Gitpod offers all dependencies pre-installed so you can just click and get started.
+
+To get started with Gitpod, click the button below and log in with your GitHub account.
+
+[](https://gitpod.io/#https://github.com/kimlimjustin/xplorer)
+
+:::note Remember to reload the Gitpod website after it loads up since it won't start the servers immediately, but by reloading, you can get it started. If you are developing the app, go to the Remote Explorer on the sidebar and visit port _6080_ which opens the noVNC app server. If you are developing the docs, go to the Remote explorer but instead of port 6080, visit port _3000_. You can edit normally as you do in VS Code, but if you want to use it locally, clik the hamburger menu button and click _Open in VS Code_. :::
+
+### Semantic commit messages {#commit-msg}
+
+See how a minor change to your commit message style can make you a better programmer.
+
+Format: `(): `
+
+`` is optional
+
+#### Example
+
+```
+feat: allow overriding of webpack config
+^--^ ^------------^
+| |
+| +-> Summary in present tense.
+|
++-------> Type: chore, docs, feat, fix, refactor, style, or test.
+```
+
+the various types of commits:
+
+- `feat`: new feature for the user
+- `fix`: bug fix for the user
+- `docs`: changes to the documentation
+- `style`: formatting, missing semi-colons, etc.
+- `refactor`: refactoring production code, eg. renaming a variable
+- `test`: adding missing tests, refactoring tests.
+- `chore`: updating grunt tasks etc
+
+Use lower case not the upper case!
+
+## Working on Xplorer docs
+
+Xplorer documentation website is built using [Docusaurus 2](https://docusaurus.io/), and its code is located at [`docs`](https://github.com/kimlimjustin/xplorer/tree/master/docs) folder.
+
+### Prerequisite
+
+- [node js](https://nodejs.org/en/)
+- [git](https://git-scm.com/downloads)
+- [yarn](https://yarnpkg.com/getting-started/install#about-global-installs)
+- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
+
+### Installation
+
+After cloning the repository, run `yarn` in the `docs` folder (you can go into the `docs` folder by running the `cd docs` command).
+
+If you want to use Gitpod, click [here](#gitpod-env) for the guide on how to use Gitpod.
+
+### Local development
+
+1. Run the `yarn start` command in the `docs` folder.
+2. Edit some markdown texts in the `docs` folder and the website will be hot reloaded.
+
+## Pull requests
+
+### Your first pull request. {#first-pull-request}
+
+So you have decided to contribute code back to upstream by opening a pull request. You've invested a good chunk of time, and we appreciate it. We will do our best to work with you and get the PR looked at.
+
+Working on your first Pull Request? You can learn how from this free video series:
+
+How to Contribute to an Open Source Project on GitHub
+
+We have a list of [beginner-friendly issues](https://github.com/kimlimjustin/xplorer/labels/good%20first%20issue) to help you get your feet wet in the Xplorer codebase and familiar with our contribution process. This is a great place to get started.
+
+### Proposing a change
+
+If you would like to request a new feature or enhancement but are not yet thinking about opening a pull request, you can also [open a discussion](#feat) and others will code it!
+
+If you intend to fix a bug, please discuss it through [Issues](#issues) before submitting a pull request.
+
+If you intend to add a new feature, please discuss it through [GitHub Discussions](#feat) to avoid multiple people working on the same feature request.
+
+### Sending a Pull Request
+
+make sure the PR does only one thing, otherwise please split it. It is recommended to follow this [commit message style](#commit-msg).
+
+1. Fork [the repository](https://github.com/kimlimjustin/xplorer) and create your branch from `master`.
+2. Make changes and ensure your commit message is understandable.
+3. Open a [PR](https://github.com/kimlimjustin/xplorer/pulls) and ensure to describe your pull request clearly.
+
+## Working on Xplorer resources
+
+### Locales
+
+We host our locales on the [crowdin](https://crwd.in/xplorer). To translate it, please follow these steps:
+
+- Sign up on [Crowdin](https://crowdin.com) and Join our project [here](https://crwd.in/xplorer).
+- Make sure your locale exists there, if it does not exist, leave a comment in [this discussion](https://github.com/kimlimjustin/xplorer/discussions/30) and I'll add the language option :)
+- Get familiar with the Crowdin translation UI, as you will need to use it to translate JSON and Markdown files
+- Translate the content!
+
+#### Priority Files to translate on Crowdin
+
+1. `src/Locales` files
+2. `docs/` files
+
+#### Production
+
+Once the files on `src/Locales` have been translated for more than 80%, we will add it into the Xplorer app, and for the docs, we will add it into production once the translation looks good!
+
+Please comment [here](https://github.com/kimlimjustin/xplorer/discussions/30) if you have any questions!
+
+### File Library
+
+The json library of file types and thumbnail are found under `lib` folder and the icons are found under `src/Icons` folder. You may add file types and icons for file extensions you want to use and submit a PR.
diff --git a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/Community/support.md b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/Community/support.md
new file mode 100644
index 00000000..8ea01be3
--- /dev/null
+++ b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/Community/support.md
@@ -0,0 +1,42 @@
+---
+sidebar_position: 1
+---
+
+# Support
+
+Xplorer is an open-source project which you can freely join and seek support 😊.
+
+On this page, we've listed some communities/forums you can participate in to seek support or help others.
+
+Before participating in Xplorer's communities, please read our [Code Of Conduct](/docs/community/CODE_OF_CONDUCT/).
+
+## Issues
+
+We use GitHub Issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue. Report a bug by opening a new issue [here](https://github.com/kimlimjustin/xplorer/issues/new).
+
+## GitHub Discussions
+
+GitHub Discussions is used for multiple purposes, such as:
+
+1. Asking questions
+2. Making feature requests and sharing ideas
+3. Chat on Xplorer
+4. Show and tell: Making custom themes/plug-ins for Xplorer and showing them there!
+
+### Feature Request
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussion) and [GitHub Issues](https://github.com/kimlimjustin/xplorer/issues) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional context like images, links to resources to implement the feature, etc.
+
+### Help
+
+You can ask for help using [GitHub Discussion](https://github.com/kimlimjustin/xplorer/discussions) or [Discord Channel](https://discord.gg/kK7rwxPt).
+
+:::note Remember to choose the discussion category as Q&A so that your question will be published with answers enabled. :::
+
+## News
+
+For the latest news about Xplorer, you can see it through posts on [Forem](https://dev.to/t/xplorer).
diff --git a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/common_problems.md b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/common_problems.md
index 0329306c..ebdcac5f 100644
--- a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/common_problems.md
+++ b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/common_problems.md
@@ -1,3 +1,7 @@
+- - -
+sidebar_position: 3
+- - -
+
# Common Problems
**NB: For common problems during installation, please open [here](/docs/install/#common-problems)**
@@ -5,25 +9,6 @@
-### Xplorer keep loading and crashes.
-
-
-
-Try opening `cmd` by opening Win + R(Run) and type `cmd`.
-
-Enter following command:
-
-```
-wmic
-```
-
-If the output says the `wmic` is not recognized as internal or internal command, please follow the following steps given on [this](https://superuser.com/questions/1178674/wmic-is-not-recognized-as-an-internal-or-external-command-operable-program-or) or [this](https://knowledge.informatica.com/s/article/156865?language=en_US). Also, please make sure that Windows Defender isn't blocking Xplorer from accessing your documents.
-
-
-
-
-
-
### Opening folder like `Documents`, `Desktop`, `Downloads` make Xplorer crashes
diff --git a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/_category_.json b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/_category_.json
index 2a648072..b1419d2f 100644
--- a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/_category_.json
+++ b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/_category_.json
@@ -1,4 +1,4 @@
{
- "label": "Guides",
- "position": 3
-}
\ No newline at end of file
+ "label": "Guides",
+ "position": 4
+}
diff --git a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/cli.md b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/cli.md
index b1ea164c..e125b4f0 100644
--- a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/cli.md
+++ b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/cli.md
@@ -1,7 +1,5 @@
# Launch Xplorer from Terminal
-:::info This feature hasn't been optimized yet. It works but it might be laggy. This will be optimized in the feature release. :::
-
## Commands
Xplorer CLI:
@@ -14,24 +12,6 @@ Xplorer will open `dir`, `dir2`, `dir3` as tabs on Xplorer. If there's no direct
Options:
-| Command | Alias | Description |
-| ----------- | ----- | ---------------------------------------------- |
-| `--help` | `-h` | Show help |
-| `--version` | `-v` | Show version number |
-| `--reveal` | `-r` | Open the containing folder and select the file |
-
-
-
-xplorer: command not found error on Windows
-
-
-Firstly, you have to register the command into the system path.
-
-1. Open the `System Properties` on Windows.
-2. Click the `Environment Variables` button, it will pop up a window.
-3. On the table, search for the `Path` variable and click on it.
-4. Click the `Edit` button, it will pop up a window.
-5. Click the `New` button.
-6. Add `%USERPROFILE%\AppData\Local\Programs\xplorer`.
-
-
+| Command | Alias | Description |
+| ---------- | ----- | ---------------------------------------------- |
+| `--reveal` | `-r` | Open the containing folder and select the file |
diff --git a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/operation.md b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/operation.md
index 4804e090..75cdea48 100644
--- a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/operation.md
+++ b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/operation.md
@@ -6,13 +6,9 @@ You can copy files by right-clicking it and click the `Copy` option or select th
:::info
-On Windows and macOS, Xplorer will copy the file paths into the local clipboard, because of this, you can copy a file from Xplorer and paste it into any folder in another system. However, on Linux, we create a string of Xplorer commands and copy it into the user clipboard, Xplorer will read the user's clipboard when pasting the file (because we haven't found any idea to implement it, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us). The string of the Xplorer command looks like this:
+For current implementation, Xplorer write down what to copy locally (not copying to clipboard).
-```
-Xplorer command - COPY
-~/xplorer
-~/test
-```
+TODO: implement copy to clipboard
:::
@@ -24,29 +20,27 @@ You can copy a file/folder location path into your clipboard by right-clicking i
You can cut files by right-clicking it and click the `Cut` option or select the file then press `Ctrl + X` as a shortcut and paste it by clicking the `Paste` option or press `Ctrl + V` on the destination folder.
-:::info This is done by creating a string of Xplorer command and copies it into the user clipboard to be used when pasting file (this is not integrated with the platform because we haven't found any idea, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.). The string of Xplorer command looks like this:
+:::info
-```
-Xplorer command - CUT
-E://xplorer
-E://test
-```
+For current implementation, Xplorer write down what to cut locally (not copying to clipboard).
:::
## Delete files
-You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut. The trashed file can be accessed at `xplorer://Trash`.
+You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut.
-:::info
+### Trashed files
-- On Windows, this is done by creating a `Trash` folder on the `C:` drive and moving the file into it.
-- On Linux, this feature is fully integrated with the system.
-- On macOS, this is done by creating a `.local/Trash` folder on `homedir` and moving the file into it.
+The trashed file can be accessed at `xplorer://Trash` or your system trash folder. :::danger Open Issue
-We are still working on Windows on macOS to integrate the `Trash` folder, which will be released before the stable version came out. Feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.
+Please note that Trash folder cannot be accessed on macos via Xplorer since the [trash crate](https://github.com/Byron/trash-rs) Xplorer relies to does not support it (see [this issue](https://github.com/Byron/trash-rs/issues/8) for more details).
-:::
+Any contributions to either the trash crate or Xplorer itself for this topic are welcome. :::
+
+### Restore files
+
+You can restore files by opening the `xplorer://Trash` and right-clicking it and click the `Restore` option
### Permanently delete
@@ -100,71 +94,12 @@ You can preview a file directly from Xplorer by right-clicking it and click the
Files available to preview for now:
-```json
-[
- ".pdf",
- ".html",
- ".docx",
- ".htm",
- ".xlsx",
- ".xls",
- ".xlsb",
- "xls",
- ".ods",
- ".fods",
- ".csv",
- ".txt",
- ".py",
- ".js",
- ".bat",
- ".css",
- ".c++",
- ".cpp",
- ".cc",
- ".c",
- ".diff",
- ".patch",
- ".go",
- ".java",
- ".json",
- ".php",
- ".ts",
- ".tsx",
- ".jsx",
- ".jpg",
- ".png",
- ".gif",
- ".bmp",
- ".jpeg",
- ".jpe",
- ".jif",
- ".jfif",
- ".jfi",
- ".webp",
- ".tiff",
- ".tif",
- ".ico",
- ".svg",
- ".webp",
- ".mp4",
- ".webm",
- ".mpg",
- ".mp2",
- ".mpeg",
- ".mpe",
- ".mpv",
- ".ocg",
- ".m4p",
- ".m4v",
- ".avi",
- ".wmv",
- ".mov",
- ".qt",
- ".flv",
- ".swf",
- ".md"
-]
-```
+* Markdown files
+* Image files
+* Text files
+* Video files
+* Pdfs
+* Almost all programming language with syntax highlighting
diff --git a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/setting.md b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/setting.md
index 8219e5f5..e48188a6 100644
--- a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/setting.md
+++ b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/setting.md
@@ -12,29 +12,63 @@ You can open settings on Xplorer by clicking the `Settings` button on the left d
How to exit from Settings?
-You can exit from Settings on Xplorer by clicking the Arrow Up button on the upside left of Xplorer.
+You can exit from Settings on Xplorer by clicking on the upside left of Xplorer.
-## App Theme
+## Appearance
+
+### App Theme
You can change Xplorer's app theme on the `Appearance` tab of the Settings. Available default themes are `light`, `light+`, `dark`, and `dark+`. Besides, there is a `System Default` theme that will automatically read your system preference. :::info Xplorer will support a custom app theme soon, stay tuned! :::
-### Acrylic Effect
+### Font Family
+
+You can change Xplorer's font family on the `Appearance` tab of the Settings to one of installed font families installed on your system.
+
+### Font Size
+
+You can change Xplorer's font size on the `Appearance` tab of the Settings. Please note that an ideal font size is between 10px to 30px.
+
+### Window Transparency
+
+Make Xplorer window transparent on the `Appearance` tab of the Settings by combining following options. Please note that an ideal transparency is between 70% to 100%. You can disable transparency by disable all of the transparency options.
+
+#### Transparent Sidebar
-The Acrylic Effect is the effect that gives the transparency effect on the sidebar. Only works on Windows 10 and higher.
+Make the sidebar transparent 
-## File Preview
+#### Transparent Topbar
-The file preview here means the preview that replaces the default icon of a file.
+Make the topbar transparent 
-### Play video file as a preview
+#### Transparent Workspace
+
+make the workspace transparent 
+
+### Frame Style
+
+You can choose the frame style on the `Appearance` tab of the Settings. The available options are `Default` and `System Default`. `Default` will use Xplorer's default style which is the same across platforms. `System Default` will use the system default frame style which is difference according to your platform.
+
+### File Preview
+
+File Preview here might means the file thumbnail.
+
+#### Automatically play video file as thumbnail
This will automatically play the video file as a preview. :::caution THIS MIGHT CONSUME HIGH AMOUNT OF RAM This might consume a high amount of RAM because it's built on the HTML video player. You can just enable this setting and ignore this caution if you got a good-spec computer. :::
-### Extract `EXE` file icon and make it a preview
+#### Preview image on hover
+
+This fill automatically show the image when you hovering it for 500ms.
+
+
+
+Some people might found it annoying and you can disable it by disabling this setting.
+
+#### Extract exe file icon and make it as the thumbnail
This will parse and cache the icon from a `exe` file and make it a preview. Only on Windows.
@@ -48,22 +82,43 @@ The way to fix it is to disable the setting.
:::
-## Default file layout
+:::info Open issue The current approach is by calling the powershell program which might pops up cmd windows.
+
+Any contribution to call it directly from Xplorer is welcome. :::
+
+#### Show Image as Thumbnail
+
+This will show the image as a thumbnail of a file. Please note that this is not recommended for large directory as it reads the image to memory.
+
+#### Default file layout
Default file layout of a directory. Just give it a try :)
-## App Language
+## Preference
+
+### App Language
Localize Xplorer. Help us translate Xplorer [here](https://github.com/kimlimjustin/xplorer/discussions/30).
-## Hide Hidden Files
+### Hide Hidden Files
Hide hidden files on Xplorer, you can find this setting on the `Preference` tab on Xplorer or by its shortcut, `Ctrl + H`.
-## Hide System Files
+### Hide System Files
Hide Windows' system files on Xplorer. :::tip Learn what is system file [here](https://en.wikipedia.org/wiki/System_file). Just turn it off if you don't understand what it is. :::
-## List and sort directories alongside files
+### List and sort directories alongside files
If disabled, Xplorer will prioritize directories above files.
+
+### Detect Drive Change
+
+Turning this on will detect drive change and update the sidebar and drives section. Please note that this will take high ammount of RAM as this is not stabilized yet.
+
+### On startup
+
+Option to do on starting Xplorer. Available options are:
+
+- New Tab
+- Continue previous session
diff --git a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/shortcut.md b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/shortcut.md
index 5a2ac3cb..1dcb2c04 100644
--- a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/shortcut.md
+++ b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/shortcut.md
@@ -4,19 +4,22 @@
| ------------------- | ------------------------ |
| `Ctrl + A` | Select All |
| `Ctrl + C` | Copy |
-| `Ctrl + E` | Close Tab |
| `Ctrl + H` | Toggle Hidden Files |
-| `Ctrl + O` | Preview file |
+| `Ctrl + N` | New window shortcut |
+| `Ctrl + O` | Open file in preview |
| `Ctrl + P` | Files/Folders Properties |
| `Ctrl + R` | Reload |
| `Ctrl + T` | New Tab |
| `Ctrl + V` | Paste |
| `Ctrl + X` | Cut |
-| `Ctrl + W` | Exit Xplorer |
+| `Ctrl + W` | Exit Tab |
+| `Ctrl + Y` | Redo |
+| `Ctrl + Z` | Undo |
+| `Ctrl + Shift + Z` | Redo |
| `Alt + Left Arrow` | Go Back |
| `Alt + Right Arrow` | Go Forward |
-| `Alt + Up Arrow` | maximize |
-| `Alt + Down Arrow` | minimize |
+| `Alt + Up Arrow` | Go to parent directory |
+| `Alt + N` | New File |
| `Alt + T` | Open in terminal |
| `Alt + P` | Pin to sidebar |
| `Alt + Shift + C` | Copy location path |
@@ -30,6 +33,6 @@
| `Enter` | Open |
| `Del` | Delete file |
-:::note Difference between `reload` and `refresh` `Reload` refreshes the internal HTML while `Refresh` refreshes the whole Electron process.
+:::note Difference between `reload` and `refresh` `Reload` refreshes the internal process while `Refresh` refreshes the whole process.
:::
diff --git a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/xplorer as default.md b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
index f575bfa4..e69d60f6 100644
--- a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
+++ b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
@@ -12,7 +12,7 @@
4. Navigate to `Computer\HKEY_CURRENT_USER\Software\Classes\Directory`
5. Create a key named `shell` if not existed by right and set the default key-value to `openinxplorer`
6. Create a key named `openinxplorer` under `shell`
-7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Users\User\AppData\Local\Programs\Microsoft VS Code\Code.exe" "%V"`
+7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Program Files\Xplorer\Xplorer.exe" "%V"`. (You may have to change `C:\Program Files\Xplorer\` to the location you installed Xplorer)
diff --git a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/intro.md b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/intro.md
index 53a02dbb..b6b5b5b8 100644
--- a/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/intro.md
+++ b/docs/i18n/de-DE/docusaurus-plugin-content-docs/current/intro.md
@@ -8,14 +8,18 @@ sidebar_position: 1
Welcome to Xplorer, A Free and Open Source (FOSS) File Explorer.
-Xplorer is a file explorer built from the ground up to be fully customizable and without customization, it also looks modern! It is cross-platform, built using Electron Technology that allowed our File Explorer to be run not only in Windows but also Linux and MacOS alike. It also allowed file preview directly inside it, not only pictures or documents but also videos!
+Xplorer is a file explorer built from ground-up to be fully customizable. And even without any customization, it already looks modern!
-## Funktionen
+Xplorer is a cross-platform application built using [Tauri](https://tauri.studio), and you can run it on Windows, MacOS, or Linux without having much trouble. One of the key feature is Xplorer allows you to preview the files you have directly inside Xplorer. And it's not only limited to picture or document preview, but also video preview.
-So to summarize, Xplorer's features contain:
+To summarize, Xplorer's features contain:
-- Moderne Oberfläche
+- It looks modern
- Benutzerfreundlich
- Plattformübergreifend
-- Dateivorschau, sogar Videos!
-- Am Wichtigsten: Er ist kostenlos und Open Source! Which mean you can change components inside if you see fit and you also don't need to make your wallet go dry or break the bank.
+- [File Preview](https://xplorer.vercel.app/docs/guides/operation/#preview-file), even for videos!
+- Customizable
+- Supports multiple tab
+- Most importantly, Free and Open Source Software(FOSS), which means you can change components inside if you see fit
+
+Xplorer is currently under heavy development. You can give your suggestions and feedbacks in our [Discussions](https://github.com/kimlimjustin/xplorer/discussions/) page. If you feel comfortable in writing code using Typescript and Rust, we highly encourage you to [contribute to this project](https://xplorer.vercel.app/community/Contributing/).
diff --git a/docs/i18n/de-DE/docusaurus-plugin-content-pages/index.jsx b/docs/i18n/de-DE/docusaurus-plugin-content-pages/index.jsx
index 53c4c814..5ac18305 100644
--- a/docs/i18n/de-DE/docusaurus-plugin-content-pages/index.jsx
+++ b/docs/i18n/de-DE/docusaurus-plugin-content-pages/index.jsx
@@ -5,102 +5,69 @@ import Slideshow from './slideshow';
import Link from '@docusaurus/Link';
export default function Home() {
- const { siteConfig } = useDocusaurusContext();
- return (
-
-
-
-
-
Datei-Explorer.
-
Neudefiniert.
-
- Kostenfreie und open-source Software. Läuft überall.
-
+
+ );
}
diff --git a/docs/i18n/es-ES/docusaurus-plugin-content-docs-community/current/support.md b/docs/i18n/es-ES/docusaurus-plugin-content-docs-community/current/support.md
index c9716f04..f1ce249f 100644
--- a/docs/i18n/es-ES/docusaurus-plugin-content-docs-community/current/support.md
+++ b/docs/i18n/es-ES/docusaurus-plugin-content-docs-community/current/support.md
@@ -1,34 +1,43 @@
---
sidebar_position: 1
---
+
# Soporte
+
Xplorer is an open-source project which you can freely join and seek support 😊.
On this page, we've listed some communities/forums you can participate in to seek support or help others.
-Before participating in Xplorer's communities, please read our [Code Of Conduct](/community/CODE_OF_CONDUCT/).
+Before participating in Xplorer's communities, please read our [Code Of Conduct](/docs/community/CODE_OF_CONDUCT/).
## Problemas
+
We use GitHub Issues to track public bugs. Por favor, asegúrese de que su descripción sea clara y tiene suficientes instrucciones para poder reproducir el problema. Report a bug by opening a new issue [here](https://github.com/kimlimjustin/xplorer/issues/new). Please use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) instead to suggest a new feature.
## GitHub Discussions
+
GitHub Discussions is used for multiple purposes, such as:
+
1. Asking questions
2. Making feature requests and sharing ideas
3. Xplorer Announcements
4. Chat on Xplorer
5. Show and tell: Making custom themes/plug-ins for Xplorer and showing them there!
-
### Solicitar una característica
+
We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussion) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Las buenas solicitudes de características tienden a tener:
-- Resumen rápido de la idea.
-- Qué & por qué quiere añadir la característica específicada.
-- Contexto adicional como imágenes, enlaces a recursos para implementar la función, etc.
+
+- Resumen rápido de la idea.
+- Qué & por qué quiere añadir la característica específicada.
+- Contexto adicional como imágenes, enlaces a recursos para implementar la función, etc.
+
### Ayuda
+
You can ask for help using [GitHub Discussion](https://github.com/kimlimjustin/xplorer/discussions) and others will answer you, just like Stack Overflow!
:::note Remember to choose the discussion category as Q&A so that your question will be published with answers enabled. :::
## Noticias
+
For the latest news about Xplorer, you can see it through the [official Xplorer blog](/blog) on this website.
diff --git a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/Community/Contributing.md b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/Community/Contributing.md
new file mode 100644
index 00000000..be326698
--- /dev/null
+++ b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/Community/Contributing.md
@@ -0,0 +1,173 @@
+---
+sidebar_position: 2
+---
+
+# Contribute
+
+👍🎉 First off, thanks for taking the time to contribute! 🎉👍
+
+Xplorer is currently under heavy development. We are welcoming contributors to collaborate on Xplorer.
+
+## Get involved
+
+There are many ways to contribute to Xplorer, and many of them do not involve writing any code. Here are few ideas to get started:
+
+- Start using Xplorer! Go through the Tutorial guides. Does anything work as expected? If not, we're always looking for improvements. Let us know by opening an issue.
+- Look through the [Xplorer issues](https://github.com/kimlimjustin/xplorer/issues). If you find an issue you would like to fix, [open a pull request](#first-pull-request). Issues tagged as [good first issue](https://github.com/kimlimjustin/xplorer/labels/good%20first%20issue) are a good place to get started.
+- Help us make the docs better. File an issue if you find anything that is confusing, any grammatical error, or can be improved.
+- Take a look at [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) and give your opinion into a discussion or consider opening a pull request if you see something you want to work on.
+
+Contributions are very welcome!
+
+## Our development process
+
+Xplorer uses [GitHub](https://github.com/kimlimjustin/xplorer) as its source of truth. The core team will work directly there. All changes will be public from the beginning.
+
+### Reporting new issues/bugs. {#issues}
+
+When [opening a new issue](https://github.com/kimlimjustin/xplorer/issues), always make sure to fill out the issue template. We use GitHub issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue.
+
+- _One issue, one bug_: Please report a single bug per issue.
+- _Provide reproduction steps_: List all the steps necessary to reproduce the issue. The person reading your bug report should be able to follow these steps to reproduce your issue with minimal effort.
+
+### Feature Request {#feat}
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) and [GitHub Issues](https://github.com/kimlimjustin/xplorer) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional references like images, links of resources about the feature, etc.
+
+## Working on Xplorer code
+
+### Prerequisite
+
+- [Tauri environment](https://tauri.studio/en/docs/getting-started/intro#setting-up-your-environment)
+- [Node JS](https://nodejs.org/en/)
+- [Git](https://git-scm.com/)
+- [yarn](https://yarnpkg.com/)
+- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
+
+### Installation
+
+1. After cloning the repository, run `yarn` in the root of the repository and run `yarn` in the `docs` folder (if you want to working on Xplorer Docs).
+2. To start Xplorer locally, run `yarn dev`.
+
+ To start a local development server serving the Docusaurus docs, go into the `docs` directory and run `yarn start`
+
+### Gitpod {#gitpod-env}
+
+Gitpod is a Ready-to-Code environment in which you can get started immediately. Gitpod offers all dependencies pre-installed so you can just click and get started.
+
+To get started with Gitpod, click the button below and log in with your GitHub account.
+
+[](https://gitpod.io/#https://github.com/kimlimjustin/xplorer)
+
+:::note Remember to reload the Gitpod website after it loads up since it won't start the servers immediately, but by reloading, you can get it started. If you are developing the app, go to the Remote Explorer on the sidebar and visit port _6080_ which opens the noVNC app server. If you are developing the docs, go to the Remote explorer but instead of port 6080, visit port _3000_. You can edit normally as you do in VS Code, but if you want to use it locally, clik the hamburger menu button and click _Open in VS Code_. :::
+
+### Semantic commit messages {#commit-msg}
+
+See how a minor change to your commit message style can make you a better programmer.
+
+Format: `(): `
+
+`` is optional
+
+#### Example
+
+```
+feat: allow overriding of webpack config
+^--^ ^------------^
+| |
+| +-> Summary in present tense.
+|
++-------> Type: chore, docs, feat, fix, refactor, style, or test.
+```
+
+the various types of commits:
+
+- `feat`: new feature for the user
+- `fix`: bug fix for the user
+- `docs`: changes to the documentation
+- `style`: formatting, missing semi-colons, etc.
+- `refactor`: refactoring production code, eg. renaming a variable
+- `test`: adding missing tests, refactoring tests.
+- `chore`: updating grunt tasks etc
+
+Use lower case not the upper case!
+
+## Working on Xplorer docs
+
+Xplorer documentation website is built using [Docusaurus 2](https://docusaurus.io/), and its code is located at [`docs`](https://github.com/kimlimjustin/xplorer/tree/master/docs) folder.
+
+### Prerequisite
+
+- [node js](https://nodejs.org/en/)
+- [git](https://git-scm.com/downloads)
+- [yarn](https://yarnpkg.com/getting-started/install#about-global-installs)
+- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
+
+### Installation
+
+After cloning the repository, run `yarn` in the `docs` folder (you can go into the `docs` folder by running the `cd docs` command).
+
+If you want to use Gitpod, click [here](#gitpod-env) for the guide on how to use Gitpod.
+
+### Local development
+
+1. Run the `yarn start` command in the `docs` folder.
+2. Edit some markdown texts in the `docs` folder and the website will be hot reloaded.
+
+## Pull requests
+
+### Your first pull request. {#first-pull-request}
+
+So you have decided to contribute code back to upstream by opening a pull request. You've invested a good chunk of time, and we appreciate it. We will do our best to work with you and get the PR looked at.
+
+Working on your first Pull Request? You can learn how from this free video series:
+
+How to Contribute to an Open Source Project on GitHub
+
+We have a list of [beginner-friendly issues](https://github.com/kimlimjustin/xplorer/labels/good%20first%20issue) to help you get your feet wet in the Xplorer codebase and familiar with our contribution process. This is a great place to get started.
+
+### Proposing a change
+
+If you would like to request a new feature or enhancement but are not yet thinking about opening a pull request, you can also [open a discussion](#feat) and others will code it!
+
+If you intend to fix a bug, please discuss it through [Issues](#issues) before submitting a pull request.
+
+If you intend to add a new feature, please discuss it through [GitHub Discussions](#feat) to avoid multiple people working on the same feature request.
+
+### Sending a Pull Request
+
+make sure the PR does only one thing, otherwise please split it. It is recommended to follow this [commit message style](#commit-msg).
+
+1. Fork [the repository](https://github.com/kimlimjustin/xplorer) and create your branch from `master`.
+2. Make changes and ensure your commit message is understandable.
+3. Open a [PR](https://github.com/kimlimjustin/xplorer/pulls) and ensure to describe your pull request clearly.
+
+## Working on Xplorer resources
+
+### Locales
+
+We host our locales on the [crowdin](https://crwd.in/xplorer). To translate it, please follow these steps:
+
+- Sign up on [Crowdin](https://crowdin.com) and Join our project [here](https://crwd.in/xplorer).
+- Make sure your locale exists there, if it does not exist, leave a comment in [this discussion](https://github.com/kimlimjustin/xplorer/discussions/30) and I'll add the language option :)
+- Get familiar with the Crowdin translation UI, as you will need to use it to translate JSON and Markdown files
+- Translate the content!
+
+#### Priority Files to translate on Crowdin
+
+1. `src/Locales` files
+2. `docs/` files
+
+#### Production
+
+Once the files on `src/Locales` have been translated for more than 80%, we will add it into the Xplorer app, and for the docs, we will add it into production once the translation looks good!
+
+Please comment [here](https://github.com/kimlimjustin/xplorer/discussions/30) if you have any questions!
+
+### File Library
+
+The json library of file types and thumbnail are found under `lib` folder and the icons are found under `src/Icons` folder. You may add file types and icons for file extensions you want to use and submit a PR.
diff --git a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/Community/support.md b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/Community/support.md
new file mode 100644
index 00000000..8ea01be3
--- /dev/null
+++ b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/Community/support.md
@@ -0,0 +1,42 @@
+---
+sidebar_position: 1
+---
+
+# Support
+
+Xplorer is an open-source project which you can freely join and seek support 😊.
+
+On this page, we've listed some communities/forums you can participate in to seek support or help others.
+
+Before participating in Xplorer's communities, please read our [Code Of Conduct](/docs/community/CODE_OF_CONDUCT/).
+
+## Issues
+
+We use GitHub Issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue. Report a bug by opening a new issue [here](https://github.com/kimlimjustin/xplorer/issues/new).
+
+## GitHub Discussions
+
+GitHub Discussions is used for multiple purposes, such as:
+
+1. Asking questions
+2. Making feature requests and sharing ideas
+3. Chat on Xplorer
+4. Show and tell: Making custom themes/plug-ins for Xplorer and showing them there!
+
+### Feature Request
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussion) and [GitHub Issues](https://github.com/kimlimjustin/xplorer/issues) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional context like images, links to resources to implement the feature, etc.
+
+### Help
+
+You can ask for help using [GitHub Discussion](https://github.com/kimlimjustin/xplorer/discussions) or [Discord Channel](https://discord.gg/kK7rwxPt).
+
+:::note Remember to choose the discussion category as Q&A so that your question will be published with answers enabled. :::
+
+## News
+
+For the latest news about Xplorer, you can see it through posts on [Forem](https://dev.to/t/xplorer).
diff --git a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/common_problems.md b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/common_problems.md
index 0329306c..ebdcac5f 100644
--- a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/common_problems.md
+++ b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/common_problems.md
@@ -1,3 +1,7 @@
+- - -
+sidebar_position: 3
+- - -
+
# Common Problems
**NB: For common problems during installation, please open [here](/docs/install/#common-problems)**
@@ -5,25 +9,6 @@
-### Xplorer keep loading and crashes.
-
-
-
-Try opening `cmd` by opening Win + R(Run) and type `cmd`.
-
-Enter following command:
-
-```
-wmic
-```
-
-If the output says the `wmic` is not recognized as internal or internal command, please follow the following steps given on [this](https://superuser.com/questions/1178674/wmic-is-not-recognized-as-an-internal-or-external-command-operable-program-or) or [this](https://knowledge.informatica.com/s/article/156865?language=en_US). Also, please make sure that Windows Defender isn't blocking Xplorer from accessing your documents.
-
-
-
-
-
-
### Opening folder like `Documents`, `Desktop`, `Downloads` make Xplorer crashes
diff --git a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/_category_.json b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/_category_.json
index f298072b..4e508230 100644
--- a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/_category_.json
+++ b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/_category_.json
@@ -1,4 +1,4 @@
{
- "label": "Guías",
- "position": 3
-}
\ No newline at end of file
+ "label": "Guías",
+ "position": 4
+}
diff --git a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/cli.md b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/cli.md
index b1e4244c..0effce0e 100644
--- a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/cli.md
+++ b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/cli.md
@@ -1,7 +1,5 @@
# Ejecutar Xplorer desde la terminal
-:::info This feature hasn't been optimized yet. Funciona, pero podría ser un poco bugueado. This will be optimized in the feature release. :::
-
## Comandos
Xplorer CLI:
@@ -10,28 +8,10 @@ Xplorer CLI:
xplorer [dir1] [dir2] [dir3]
```
-Xplorer abrirá `dir`, `dir2`, `dir3` como pestañas. If there's no directory(dir) passed into the command, Xplorer will start at the Home page.
-
-Opciones:
-
-| Comando | Alias | Descripción |
-| ----------- | ----- | ----------------------------------------------------- |
-| `--help` | `-h` | Mostrar ayuda |
-| `--version` | `-v` | Mostrar el número de versión |
-| `--revelar` | `-r` | Abrir la carpeta contenedora y seleccionar el archivo |
-
-
-
-xplorer: comando no encontrado error en Windows
-
-
-En primer lugar, debe registrar el comando en la ruta del sistema.
+Xplorer will open `dir`, `dir2`, `dir3` as tabs on Xplorer. If there's no directory(dir) passed into the command, Xplorer will start at the Home page.
-1. Abrir `Propiedades del sistema` en Windows.
-2. Click the `Environment Variables` button, it will pop up a window.
-3. On the table, search for the `Path` variable and click on it.
-4. Click the `Edit` button, it will pop up a window.
-5. Click the `New` button.
-6. Add `%USERPROFILE%\AppData\Local\Programs\xplorer`.
+Options:
-
+| Comando | Alias | Descripción |
+| ---------- | ----- | ---------------------------------------------- |
+| `--reveal` | `-r` | Open the containing folder and select the file |
diff --git a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/operation.md b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/operation.md
index 4804e090..75cdea48 100644
--- a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/operation.md
+++ b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/operation.md
@@ -6,13 +6,9 @@ You can copy files by right-clicking it and click the `Copy` option or select th
:::info
-On Windows and macOS, Xplorer will copy the file paths into the local clipboard, because of this, you can copy a file from Xplorer and paste it into any folder in another system. However, on Linux, we create a string of Xplorer commands and copy it into the user clipboard, Xplorer will read the user's clipboard when pasting the file (because we haven't found any idea to implement it, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us). The string of the Xplorer command looks like this:
+For current implementation, Xplorer write down what to copy locally (not copying to clipboard).
-```
-Xplorer command - COPY
-~/xplorer
-~/test
-```
+TODO: implement copy to clipboard
:::
@@ -24,29 +20,27 @@ You can copy a file/folder location path into your clipboard by right-clicking i
You can cut files by right-clicking it and click the `Cut` option or select the file then press `Ctrl + X` as a shortcut and paste it by clicking the `Paste` option or press `Ctrl + V` on the destination folder.
-:::info This is done by creating a string of Xplorer command and copies it into the user clipboard to be used when pasting file (this is not integrated with the platform because we haven't found any idea, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.). The string of Xplorer command looks like this:
+:::info
-```
-Xplorer command - CUT
-E://xplorer
-E://test
-```
+For current implementation, Xplorer write down what to cut locally (not copying to clipboard).
:::
## Delete files
-You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut. The trashed file can be accessed at `xplorer://Trash`.
+You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut.
-:::info
+### Trashed files
-- On Windows, this is done by creating a `Trash` folder on the `C:` drive and moving the file into it.
-- On Linux, this feature is fully integrated with the system.
-- On macOS, this is done by creating a `.local/Trash` folder on `homedir` and moving the file into it.
+The trashed file can be accessed at `xplorer://Trash` or your system trash folder. :::danger Open Issue
-We are still working on Windows on macOS to integrate the `Trash` folder, which will be released before the stable version came out. Feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.
+Please note that Trash folder cannot be accessed on macos via Xplorer since the [trash crate](https://github.com/Byron/trash-rs) Xplorer relies to does not support it (see [this issue](https://github.com/Byron/trash-rs/issues/8) for more details).
-:::
+Any contributions to either the trash crate or Xplorer itself for this topic are welcome. :::
+
+### Restore files
+
+You can restore files by opening the `xplorer://Trash` and right-clicking it and click the `Restore` option
### Permanently delete
@@ -100,71 +94,12 @@ You can preview a file directly from Xplorer by right-clicking it and click the
Files available to preview for now:
-```json
-[
- ".pdf",
- ".html",
- ".docx",
- ".htm",
- ".xlsx",
- ".xls",
- ".xlsb",
- "xls",
- ".ods",
- ".fods",
- ".csv",
- ".txt",
- ".py",
- ".js",
- ".bat",
- ".css",
- ".c++",
- ".cpp",
- ".cc",
- ".c",
- ".diff",
- ".patch",
- ".go",
- ".java",
- ".json",
- ".php",
- ".ts",
- ".tsx",
- ".jsx",
- ".jpg",
- ".png",
- ".gif",
- ".bmp",
- ".jpeg",
- ".jpe",
- ".jif",
- ".jfif",
- ".jfi",
- ".webp",
- ".tiff",
- ".tif",
- ".ico",
- ".svg",
- ".webp",
- ".mp4",
- ".webm",
- ".mpg",
- ".mp2",
- ".mpeg",
- ".mpe",
- ".mpv",
- ".ocg",
- ".m4p",
- ".m4v",
- ".avi",
- ".wmv",
- ".mov",
- ".qt",
- ".flv",
- ".swf",
- ".md"
-]
-```
+* Markdown files
+* Image files
+* Text files
+* Video files
+* Pdfs
+* Almost all programming language with syntax highlighting
diff --git a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/setting.md b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/setting.md
index 8219e5f5..e48188a6 100644
--- a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/setting.md
+++ b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/setting.md
@@ -12,29 +12,63 @@ You can open settings on Xplorer by clicking the `Settings` button on the left d
How to exit from Settings?
-You can exit from Settings on Xplorer by clicking the Arrow Up button on the upside left of Xplorer.
+You can exit from Settings on Xplorer by clicking on the upside left of Xplorer.
-## App Theme
+## Appearance
+
+### App Theme
You can change Xplorer's app theme on the `Appearance` tab of the Settings. Available default themes are `light`, `light+`, `dark`, and `dark+`. Besides, there is a `System Default` theme that will automatically read your system preference. :::info Xplorer will support a custom app theme soon, stay tuned! :::
-### Acrylic Effect
+### Font Family
+
+You can change Xplorer's font family on the `Appearance` tab of the Settings to one of installed font families installed on your system.
+
+### Font Size
+
+You can change Xplorer's font size on the `Appearance` tab of the Settings. Please note that an ideal font size is between 10px to 30px.
+
+### Window Transparency
+
+Make Xplorer window transparent on the `Appearance` tab of the Settings by combining following options. Please note that an ideal transparency is between 70% to 100%. You can disable transparency by disable all of the transparency options.
+
+#### Transparent Sidebar
-The Acrylic Effect is the effect that gives the transparency effect on the sidebar. Only works on Windows 10 and higher.
+Make the sidebar transparent 
-## File Preview
+#### Transparent Topbar
-The file preview here means the preview that replaces the default icon of a file.
+Make the topbar transparent 
-### Play video file as a preview
+#### Transparent Workspace
+
+make the workspace transparent 
+
+### Frame Style
+
+You can choose the frame style on the `Appearance` tab of the Settings. The available options are `Default` and `System Default`. `Default` will use Xplorer's default style which is the same across platforms. `System Default` will use the system default frame style which is difference according to your platform.
+
+### File Preview
+
+File Preview here might means the file thumbnail.
+
+#### Automatically play video file as thumbnail
This will automatically play the video file as a preview. :::caution THIS MIGHT CONSUME HIGH AMOUNT OF RAM This might consume a high amount of RAM because it's built on the HTML video player. You can just enable this setting and ignore this caution if you got a good-spec computer. :::
-### Extract `EXE` file icon and make it a preview
+#### Preview image on hover
+
+This fill automatically show the image when you hovering it for 500ms.
+
+
+
+Some people might found it annoying and you can disable it by disabling this setting.
+
+#### Extract exe file icon and make it as the thumbnail
This will parse and cache the icon from a `exe` file and make it a preview. Only on Windows.
@@ -48,22 +82,43 @@ The way to fix it is to disable the setting.
:::
-## Default file layout
+:::info Open issue The current approach is by calling the powershell program which might pops up cmd windows.
+
+Any contribution to call it directly from Xplorer is welcome. :::
+
+#### Show Image as Thumbnail
+
+This will show the image as a thumbnail of a file. Please note that this is not recommended for large directory as it reads the image to memory.
+
+#### Default file layout
Default file layout of a directory. Just give it a try :)
-## App Language
+## Preference
+
+### App Language
Localize Xplorer. Help us translate Xplorer [here](https://github.com/kimlimjustin/xplorer/discussions/30).
-## Hide Hidden Files
+### Hide Hidden Files
Hide hidden files on Xplorer, you can find this setting on the `Preference` tab on Xplorer or by its shortcut, `Ctrl + H`.
-## Hide System Files
+### Hide System Files
Hide Windows' system files on Xplorer. :::tip Learn what is system file [here](https://en.wikipedia.org/wiki/System_file). Just turn it off if you don't understand what it is. :::
-## List and sort directories alongside files
+### List and sort directories alongside files
If disabled, Xplorer will prioritize directories above files.
+
+### Detect Drive Change
+
+Turning this on will detect drive change and update the sidebar and drives section. Please note that this will take high ammount of RAM as this is not stabilized yet.
+
+### On startup
+
+Option to do on starting Xplorer. Available options are:
+
+- New Tab
+- Continue previous session
diff --git a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/shortcut.md b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/shortcut.md
index 5a2ac3cb..1dcb2c04 100644
--- a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/shortcut.md
+++ b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/shortcut.md
@@ -4,19 +4,22 @@
| ------------------- | ------------------------ |
| `Ctrl + A` | Select All |
| `Ctrl + C` | Copy |
-| `Ctrl + E` | Close Tab |
| `Ctrl + H` | Toggle Hidden Files |
-| `Ctrl + O` | Preview file |
+| `Ctrl + N` | New window shortcut |
+| `Ctrl + O` | Open file in preview |
| `Ctrl + P` | Files/Folders Properties |
| `Ctrl + R` | Reload |
| `Ctrl + T` | New Tab |
| `Ctrl + V` | Paste |
| `Ctrl + X` | Cut |
-| `Ctrl + W` | Exit Xplorer |
+| `Ctrl + W` | Exit Tab |
+| `Ctrl + Y` | Redo |
+| `Ctrl + Z` | Undo |
+| `Ctrl + Shift + Z` | Redo |
| `Alt + Left Arrow` | Go Back |
| `Alt + Right Arrow` | Go Forward |
-| `Alt + Up Arrow` | maximize |
-| `Alt + Down Arrow` | minimize |
+| `Alt + Up Arrow` | Go to parent directory |
+| `Alt + N` | New File |
| `Alt + T` | Open in terminal |
| `Alt + P` | Pin to sidebar |
| `Alt + Shift + C` | Copy location path |
@@ -30,6 +33,6 @@
| `Enter` | Open |
| `Del` | Delete file |
-:::note Difference between `reload` and `refresh` `Reload` refreshes the internal HTML while `Refresh` refreshes the whole Electron process.
+:::note Difference between `reload` and `refresh` `Reload` refreshes the internal process while `Refresh` refreshes the whole process.
:::
diff --git a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/xplorer as default.md b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
index f575bfa4..e69d60f6 100644
--- a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
+++ b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
@@ -12,7 +12,7 @@
4. Navigate to `Computer\HKEY_CURRENT_USER\Software\Classes\Directory`
5. Create a key named `shell` if not existed by right and set the default key-value to `openinxplorer`
6. Create a key named `openinxplorer` under `shell`
-7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Users\User\AppData\Local\Programs\Microsoft VS Code\Code.exe" "%V"`
+7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Program Files\Xplorer\Xplorer.exe" "%V"`. (You may have to change `C:\Program Files\Xplorer\` to the location you installed Xplorer)
diff --git a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/intro.md b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/intro.md
index e93250eb..fd908730 100644
--- a/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/intro.md
+++ b/docs/i18n/es-ES/docusaurus-plugin-content-docs/current/intro.md
@@ -8,14 +8,18 @@ sidebar_position: 1
Welcome to Xplorer, A Free and Open Source (FOSS) File Explorer.
-Xplorer is a file explorer built from the ground up to be fully customizable and without customization, it also looks modern! It is cross-platform, built using Electron Technology that allowed our File Explorer to be run not only in Windows but also Linux and MacOS alike. It also allowed file preview directly inside it, not only pictures or documents but also videos!
+Xplorer is a file explorer built from ground-up to be fully customizable. And even without any customization, it already looks modern!
-## Características
+Xplorer is a cross-platform application built using [Tauri](https://tauri.studio), and you can run it on Windows, MacOS, or Linux without having much trouble. One of the key feature is Xplorer allows you to preview the files you have directly inside Xplorer. And it's not only limited to picture or document preview, but also video preview.
-So to summarize, Xplorer's features contain:
+To summarize, Xplorer's features contain:
-- Interfaz moderna.
+- It looks modern
- Fácil de usar.
- Multiplataforma.
-- Previsualización de documentos y vídeos.
-- Y sobre todo es gratis y de código abierto. Which mean you can change components inside if you see fit and you also don't need to make your wallet go dry or break the bank.
+- [File Preview](https://xplorer.vercel.app/docs/guides/operation/#preview-file), even for videos!
+- Customizable
+- Supports multiple tab
+- Most importantly, Free and Open Source Software(FOSS), which means you can change components inside if you see fit
+
+Xplorer is currently under heavy development. You can give your suggestions and feedbacks in our [Discussions](https://github.com/kimlimjustin/xplorer/discussions/) page. If you feel comfortable in writing code using Typescript and Rust, we highly encourage you to [contribute to this project](https://xplorer.vercel.app/community/Contributing/).
diff --git a/docs/i18n/es-ES/docusaurus-plugin-content-pages/index.jsx b/docs/i18n/es-ES/docusaurus-plugin-content-pages/index.jsx
index a3df6202..38990cae 100644
--- a/docs/i18n/es-ES/docusaurus-plugin-content-pages/index.jsx
+++ b/docs/i18n/es-ES/docusaurus-plugin-content-pages/index.jsx
@@ -5,102 +5,69 @@ import Slideshow from './slideshow';
import Link from '@docusaurus/Link';
export default function Home() {
- const { siteConfig } = useDocusaurusContext();
- return (
-
-
-
-
-
File Explorer.
-
Redefined.
-
- Free and Open Source Software. Runs everywhere.
-
+ Cross-platform File Explorer. Powered by the web.
+
+
+ Built using the{' '}
+
+ Tauri Framework
+ {' '}
+ , and written using{' '}
+
+ TypeScript
+ {' '}
+ for the frontend and{' '}
+
+ Rust
+ {' '}
+ for the backend, Xplorer promises you an unprecedented experience.
+
+
+
+
+
Designed out of the box
+
Say goodbye to the old design by traditional app and say hello to this simple yet powerful design.
+
+
+
+
Supports Multiple Tabs
+
Xplorer helps you organize you files easier by supporting multiple tabs .
+
+
+
+
File Preview
+
+ Xplorer supports files preview, from images, code preview, pdfs, to videos. Learn more{' '}
+ here.
+
+
+ );
}
diff --git a/docs/i18n/id-ID/docusaurus-plugin-content-docs-community/current/support.md b/docs/i18n/id-ID/docusaurus-plugin-content-docs-community/current/support.md
index 4b7abaf4..1cc993b6 100644
--- a/docs/i18n/id-ID/docusaurus-plugin-content-docs-community/current/support.md
+++ b/docs/i18n/id-ID/docusaurus-plugin-content-docs-community/current/support.md
@@ -1,34 +1,43 @@
---
sidebar_position: 1
---
+
# Support
+
Xplorer is an open-source project which you can freely join and seek support 😊.
On this page, we've listed some communities/forums you can participate in to seek support or help others.
-Before participating in Xplorer's communities, please read our [Code Of Conduct](/community/CODE_OF_CONDUCT/).
+Before participating in Xplorer's communities, please read our [Code Of Conduct](/docs/community/CODE_OF_CONDUCT/).
## Issues
+
We use GitHub Issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue. Report a bug by opening a new issue [here](https://github.com/kimlimjustin/xplorer/issues/new). Please use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) instead to suggest a new feature.
## GitHub Discussions
+
GitHub Discussions is used for multiple purposes, such as:
+
1. Asking questions
2. Making feature requests and sharing ideas
3. Xplorer Announcements
4. Chat on Xplorer
5. Show and tell: Making custom themes/plug-ins for Xplorer and showing them there!
-
### Feature Request
+
We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussion) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
-- A quick idea summary.
-- What & why you wanted to add the specific feature.
-- Additional context like images, links to resources to implement the feature, etc.
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional context like images, links to resources to implement the feature, etc.
+
### Help
+
You can ask for help using [GitHub Discussion](https://github.com/kimlimjustin/xplorer/discussions) and others will answer you, just like Stack Overflow!
:::note Remember to choose the discussion category as Q&A so that your question will be published with answers enabled. :::
## News
+
For the latest news about Xplorer, you can see it through the [official Xplorer blog](/blog) on this website.
diff --git a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/Community/Contributing.md b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/Community/Contributing.md
new file mode 100644
index 00000000..be326698
--- /dev/null
+++ b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/Community/Contributing.md
@@ -0,0 +1,173 @@
+---
+sidebar_position: 2
+---
+
+# Contribute
+
+👍🎉 First off, thanks for taking the time to contribute! 🎉👍
+
+Xplorer is currently under heavy development. We are welcoming contributors to collaborate on Xplorer.
+
+## Get involved
+
+There are many ways to contribute to Xplorer, and many of them do not involve writing any code. Here are few ideas to get started:
+
+- Start using Xplorer! Go through the Tutorial guides. Does anything work as expected? If not, we're always looking for improvements. Let us know by opening an issue.
+- Look through the [Xplorer issues](https://github.com/kimlimjustin/xplorer/issues). If you find an issue you would like to fix, [open a pull request](#first-pull-request). Issues tagged as [good first issue](https://github.com/kimlimjustin/xplorer/labels/good%20first%20issue) are a good place to get started.
+- Help us make the docs better. File an issue if you find anything that is confusing, any grammatical error, or can be improved.
+- Take a look at [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) and give your opinion into a discussion or consider opening a pull request if you see something you want to work on.
+
+Contributions are very welcome!
+
+## Our development process
+
+Xplorer uses [GitHub](https://github.com/kimlimjustin/xplorer) as its source of truth. The core team will work directly there. All changes will be public from the beginning.
+
+### Reporting new issues/bugs. {#issues}
+
+When [opening a new issue](https://github.com/kimlimjustin/xplorer/issues), always make sure to fill out the issue template. We use GitHub issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue.
+
+- _One issue, one bug_: Please report a single bug per issue.
+- _Provide reproduction steps_: List all the steps necessary to reproduce the issue. The person reading your bug report should be able to follow these steps to reproduce your issue with minimal effort.
+
+### Feature Request {#feat}
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) and [GitHub Issues](https://github.com/kimlimjustin/xplorer) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional references like images, links of resources about the feature, etc.
+
+## Working on Xplorer code
+
+### Prerequisite
+
+- [Tauri environment](https://tauri.studio/en/docs/getting-started/intro#setting-up-your-environment)
+- [Node JS](https://nodejs.org/en/)
+- [Git](https://git-scm.com/)
+- [yarn](https://yarnpkg.com/)
+- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
+
+### Installation
+
+1. After cloning the repository, run `yarn` in the root of the repository and run `yarn` in the `docs` folder (if you want to working on Xplorer Docs).
+2. To start Xplorer locally, run `yarn dev`.
+
+ To start a local development server serving the Docusaurus docs, go into the `docs` directory and run `yarn start`
+
+### Gitpod {#gitpod-env}
+
+Gitpod is a Ready-to-Code environment in which you can get started immediately. Gitpod offers all dependencies pre-installed so you can just click and get started.
+
+To get started with Gitpod, click the button below and log in with your GitHub account.
+
+[](https://gitpod.io/#https://github.com/kimlimjustin/xplorer)
+
+:::note Remember to reload the Gitpod website after it loads up since it won't start the servers immediately, but by reloading, you can get it started. If you are developing the app, go to the Remote Explorer on the sidebar and visit port _6080_ which opens the noVNC app server. If you are developing the docs, go to the Remote explorer but instead of port 6080, visit port _3000_. You can edit normally as you do in VS Code, but if you want to use it locally, clik the hamburger menu button and click _Open in VS Code_. :::
+
+### Semantic commit messages {#commit-msg}
+
+See how a minor change to your commit message style can make you a better programmer.
+
+Format: `(): `
+
+`` is optional
+
+#### Example
+
+```
+feat: allow overriding of webpack config
+^--^ ^------------^
+| |
+| +-> Summary in present tense.
+|
++-------> Type: chore, docs, feat, fix, refactor, style, or test.
+```
+
+the various types of commits:
+
+- `feat`: new feature for the user
+- `fix`: bug fix for the user
+- `docs`: changes to the documentation
+- `style`: formatting, missing semi-colons, etc.
+- `refactor`: refactoring production code, eg. renaming a variable
+- `test`: adding missing tests, refactoring tests.
+- `chore`: updating grunt tasks etc
+
+Use lower case not the upper case!
+
+## Working on Xplorer docs
+
+Xplorer documentation website is built using [Docusaurus 2](https://docusaurus.io/), and its code is located at [`docs`](https://github.com/kimlimjustin/xplorer/tree/master/docs) folder.
+
+### Prerequisite
+
+- [node js](https://nodejs.org/en/)
+- [git](https://git-scm.com/downloads)
+- [yarn](https://yarnpkg.com/getting-started/install#about-global-installs)
+- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
+
+### Installation
+
+After cloning the repository, run `yarn` in the `docs` folder (you can go into the `docs` folder by running the `cd docs` command).
+
+If you want to use Gitpod, click [here](#gitpod-env) for the guide on how to use Gitpod.
+
+### Local development
+
+1. Run the `yarn start` command in the `docs` folder.
+2. Edit some markdown texts in the `docs` folder and the website will be hot reloaded.
+
+## Pull requests
+
+### Your first pull request. {#first-pull-request}
+
+So you have decided to contribute code back to upstream by opening a pull request. You've invested a good chunk of time, and we appreciate it. We will do our best to work with you and get the PR looked at.
+
+Working on your first Pull Request? You can learn how from this free video series:
+
+How to Contribute to an Open Source Project on GitHub
+
+We have a list of [beginner-friendly issues](https://github.com/kimlimjustin/xplorer/labels/good%20first%20issue) to help you get your feet wet in the Xplorer codebase and familiar with our contribution process. This is a great place to get started.
+
+### Proposing a change
+
+If you would like to request a new feature or enhancement but are not yet thinking about opening a pull request, you can also [open a discussion](#feat) and others will code it!
+
+If you intend to fix a bug, please discuss it through [Issues](#issues) before submitting a pull request.
+
+If you intend to add a new feature, please discuss it through [GitHub Discussions](#feat) to avoid multiple people working on the same feature request.
+
+### Sending a Pull Request
+
+make sure the PR does only one thing, otherwise please split it. It is recommended to follow this [commit message style](#commit-msg).
+
+1. Fork [the repository](https://github.com/kimlimjustin/xplorer) and create your branch from `master`.
+2. Make changes and ensure your commit message is understandable.
+3. Open a [PR](https://github.com/kimlimjustin/xplorer/pulls) and ensure to describe your pull request clearly.
+
+## Working on Xplorer resources
+
+### Locales
+
+We host our locales on the [crowdin](https://crwd.in/xplorer). To translate it, please follow these steps:
+
+- Sign up on [Crowdin](https://crowdin.com) and Join our project [here](https://crwd.in/xplorer).
+- Make sure your locale exists there, if it does not exist, leave a comment in [this discussion](https://github.com/kimlimjustin/xplorer/discussions/30) and I'll add the language option :)
+- Get familiar with the Crowdin translation UI, as you will need to use it to translate JSON and Markdown files
+- Translate the content!
+
+#### Priority Files to translate on Crowdin
+
+1. `src/Locales` files
+2. `docs/` files
+
+#### Production
+
+Once the files on `src/Locales` have been translated for more than 80%, we will add it into the Xplorer app, and for the docs, we will add it into production once the translation looks good!
+
+Please comment [here](https://github.com/kimlimjustin/xplorer/discussions/30) if you have any questions!
+
+### File Library
+
+The json library of file types and thumbnail are found under `lib` folder and the icons are found under `src/Icons` folder. You may add file types and icons for file extensions you want to use and submit a PR.
diff --git a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/Community/support.md b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/Community/support.md
new file mode 100644
index 00000000..8ea01be3
--- /dev/null
+++ b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/Community/support.md
@@ -0,0 +1,42 @@
+---
+sidebar_position: 1
+---
+
+# Support
+
+Xplorer is an open-source project which you can freely join and seek support 😊.
+
+On this page, we've listed some communities/forums you can participate in to seek support or help others.
+
+Before participating in Xplorer's communities, please read our [Code Of Conduct](/docs/community/CODE_OF_CONDUCT/).
+
+## Issues
+
+We use GitHub Issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue. Report a bug by opening a new issue [here](https://github.com/kimlimjustin/xplorer/issues/new).
+
+## GitHub Discussions
+
+GitHub Discussions is used for multiple purposes, such as:
+
+1. Asking questions
+2. Making feature requests and sharing ideas
+3. Chat on Xplorer
+4. Show and tell: Making custom themes/plug-ins for Xplorer and showing them there!
+
+### Feature Request
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussion) and [GitHub Issues](https://github.com/kimlimjustin/xplorer/issues) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional context like images, links to resources to implement the feature, etc.
+
+### Help
+
+You can ask for help using [GitHub Discussion](https://github.com/kimlimjustin/xplorer/discussions) or [Discord Channel](https://discord.gg/kK7rwxPt).
+
+:::note Remember to choose the discussion category as Q&A so that your question will be published with answers enabled. :::
+
+## News
+
+For the latest news about Xplorer, you can see it through posts on [Forem](https://dev.to/t/xplorer).
diff --git a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/common_problems.md b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/common_problems.md
index 0329306c..ebdcac5f 100644
--- a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/common_problems.md
+++ b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/common_problems.md
@@ -1,3 +1,7 @@
+- - -
+sidebar_position: 3
+- - -
+
# Common Problems
**NB: For common problems during installation, please open [here](/docs/install/#common-problems)**
@@ -5,25 +9,6 @@
-### Xplorer keep loading and crashes.
-
-
-
-Try opening `cmd` by opening Win + R(Run) and type `cmd`.
-
-Enter following command:
-
-```
-wmic
-```
-
-If the output says the `wmic` is not recognized as internal or internal command, please follow the following steps given on [this](https://superuser.com/questions/1178674/wmic-is-not-recognized-as-an-internal-or-external-command-operable-program-or) or [this](https://knowledge.informatica.com/s/article/156865?language=en_US). Also, please make sure that Windows Defender isn't blocking Xplorer from accessing your documents.
-
-
-
-
-
-
### Opening folder like `Documents`, `Desktop`, `Downloads` make Xplorer crashes
diff --git a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/_category_.json b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/_category_.json
index 2a648072..b1419d2f 100644
--- a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/_category_.json
+++ b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/_category_.json
@@ -1,4 +1,4 @@
{
- "label": "Guides",
- "position": 3
-}
\ No newline at end of file
+ "label": "Guides",
+ "position": 4
+}
diff --git a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/cli.md b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/cli.md
index b1ea164c..e125b4f0 100644
--- a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/cli.md
+++ b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/cli.md
@@ -1,7 +1,5 @@
# Launch Xplorer from Terminal
-:::info This feature hasn't been optimized yet. It works but it might be laggy. This will be optimized in the feature release. :::
-
## Commands
Xplorer CLI:
@@ -14,24 +12,6 @@ Xplorer will open `dir`, `dir2`, `dir3` as tabs on Xplorer. If there's no direct
Options:
-| Command | Alias | Description |
-| ----------- | ----- | ---------------------------------------------- |
-| `--help` | `-h` | Show help |
-| `--version` | `-v` | Show version number |
-| `--reveal` | `-r` | Open the containing folder and select the file |
-
-
-
-xplorer: command not found error on Windows
-
-
-Firstly, you have to register the command into the system path.
-
-1. Open the `System Properties` on Windows.
-2. Click the `Environment Variables` button, it will pop up a window.
-3. On the table, search for the `Path` variable and click on it.
-4. Click the `Edit` button, it will pop up a window.
-5. Click the `New` button.
-6. Add `%USERPROFILE%\AppData\Local\Programs\xplorer`.
-
-
+| Command | Alias | Description |
+| ---------- | ----- | ---------------------------------------------- |
+| `--reveal` | `-r` | Open the containing folder and select the file |
diff --git a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/operation.md b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/operation.md
index 4804e090..75cdea48 100644
--- a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/operation.md
+++ b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/operation.md
@@ -6,13 +6,9 @@ You can copy files by right-clicking it and click the `Copy` option or select th
:::info
-On Windows and macOS, Xplorer will copy the file paths into the local clipboard, because of this, you can copy a file from Xplorer and paste it into any folder in another system. However, on Linux, we create a string of Xplorer commands and copy it into the user clipboard, Xplorer will read the user's clipboard when pasting the file (because we haven't found any idea to implement it, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us). The string of the Xplorer command looks like this:
+For current implementation, Xplorer write down what to copy locally (not copying to clipboard).
-```
-Xplorer command - COPY
-~/xplorer
-~/test
-```
+TODO: implement copy to clipboard
:::
@@ -24,29 +20,27 @@ You can copy a file/folder location path into your clipboard by right-clicking i
You can cut files by right-clicking it and click the `Cut` option or select the file then press `Ctrl + X` as a shortcut and paste it by clicking the `Paste` option or press `Ctrl + V` on the destination folder.
-:::info This is done by creating a string of Xplorer command and copies it into the user clipboard to be used when pasting file (this is not integrated with the platform because we haven't found any idea, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.). The string of Xplorer command looks like this:
+:::info
-```
-Xplorer command - CUT
-E://xplorer
-E://test
-```
+For current implementation, Xplorer write down what to cut locally (not copying to clipboard).
:::
## Delete files
-You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut. The trashed file can be accessed at `xplorer://Trash`.
+You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut.
-:::info
+### Trashed files
-- On Windows, this is done by creating a `Trash` folder on the `C:` drive and moving the file into it.
-- On Linux, this feature is fully integrated with the system.
-- On macOS, this is done by creating a `.local/Trash` folder on `homedir` and moving the file into it.
+The trashed file can be accessed at `xplorer://Trash` or your system trash folder. :::danger Open Issue
-We are still working on Windows on macOS to integrate the `Trash` folder, which will be released before the stable version came out. Feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.
+Please note that Trash folder cannot be accessed on macos via Xplorer since the [trash crate](https://github.com/Byron/trash-rs) Xplorer relies to does not support it (see [this issue](https://github.com/Byron/trash-rs/issues/8) for more details).
-:::
+Any contributions to either the trash crate or Xplorer itself for this topic are welcome. :::
+
+### Restore files
+
+You can restore files by opening the `xplorer://Trash` and right-clicking it and click the `Restore` option
### Permanently delete
@@ -100,71 +94,12 @@ You can preview a file directly from Xplorer by right-clicking it and click the
Files available to preview for now:
-```json
-[
- ".pdf",
- ".html",
- ".docx",
- ".htm",
- ".xlsx",
- ".xls",
- ".xlsb",
- "xls",
- ".ods",
- ".fods",
- ".csv",
- ".txt",
- ".py",
- ".js",
- ".bat",
- ".css",
- ".c++",
- ".cpp",
- ".cc",
- ".c",
- ".diff",
- ".patch",
- ".go",
- ".java",
- ".json",
- ".php",
- ".ts",
- ".tsx",
- ".jsx",
- ".jpg",
- ".png",
- ".gif",
- ".bmp",
- ".jpeg",
- ".jpe",
- ".jif",
- ".jfif",
- ".jfi",
- ".webp",
- ".tiff",
- ".tif",
- ".ico",
- ".svg",
- ".webp",
- ".mp4",
- ".webm",
- ".mpg",
- ".mp2",
- ".mpeg",
- ".mpe",
- ".mpv",
- ".ocg",
- ".m4p",
- ".m4v",
- ".avi",
- ".wmv",
- ".mov",
- ".qt",
- ".flv",
- ".swf",
- ".md"
-]
-```
+* Markdown files
+* Image files
+* Text files
+* Video files
+* Pdfs
+* Almost all programming language with syntax highlighting
diff --git a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/setting.md b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/setting.md
index 8219e5f5..e48188a6 100644
--- a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/setting.md
+++ b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/setting.md
@@ -12,29 +12,63 @@ You can open settings on Xplorer by clicking the `Settings` button on the left d
How to exit from Settings?
-You can exit from Settings on Xplorer by clicking the Arrow Up button on the upside left of Xplorer.
+You can exit from Settings on Xplorer by clicking on the upside left of Xplorer.
-## App Theme
+## Appearance
+
+### App Theme
You can change Xplorer's app theme on the `Appearance` tab of the Settings. Available default themes are `light`, `light+`, `dark`, and `dark+`. Besides, there is a `System Default` theme that will automatically read your system preference. :::info Xplorer will support a custom app theme soon, stay tuned! :::
-### Acrylic Effect
+### Font Family
+
+You can change Xplorer's font family on the `Appearance` tab of the Settings to one of installed font families installed on your system.
+
+### Font Size
+
+You can change Xplorer's font size on the `Appearance` tab of the Settings. Please note that an ideal font size is between 10px to 30px.
+
+### Window Transparency
+
+Make Xplorer window transparent on the `Appearance` tab of the Settings by combining following options. Please note that an ideal transparency is between 70% to 100%. You can disable transparency by disable all of the transparency options.
+
+#### Transparent Sidebar
-The Acrylic Effect is the effect that gives the transparency effect on the sidebar. Only works on Windows 10 and higher.
+Make the sidebar transparent 
-## File Preview
+#### Transparent Topbar
-The file preview here means the preview that replaces the default icon of a file.
+Make the topbar transparent 
-### Play video file as a preview
+#### Transparent Workspace
+
+make the workspace transparent 
+
+### Frame Style
+
+You can choose the frame style on the `Appearance` tab of the Settings. The available options are `Default` and `System Default`. `Default` will use Xplorer's default style which is the same across platforms. `System Default` will use the system default frame style which is difference according to your platform.
+
+### File Preview
+
+File Preview here might means the file thumbnail.
+
+#### Automatically play video file as thumbnail
This will automatically play the video file as a preview. :::caution THIS MIGHT CONSUME HIGH AMOUNT OF RAM This might consume a high amount of RAM because it's built on the HTML video player. You can just enable this setting and ignore this caution if you got a good-spec computer. :::
-### Extract `EXE` file icon and make it a preview
+#### Preview image on hover
+
+This fill automatically show the image when you hovering it for 500ms.
+
+
+
+Some people might found it annoying and you can disable it by disabling this setting.
+
+#### Extract exe file icon and make it as the thumbnail
This will parse and cache the icon from a `exe` file and make it a preview. Only on Windows.
@@ -48,22 +82,43 @@ The way to fix it is to disable the setting.
:::
-## Default file layout
+:::info Open issue The current approach is by calling the powershell program which might pops up cmd windows.
+
+Any contribution to call it directly from Xplorer is welcome. :::
+
+#### Show Image as Thumbnail
+
+This will show the image as a thumbnail of a file. Please note that this is not recommended for large directory as it reads the image to memory.
+
+#### Default file layout
Default file layout of a directory. Just give it a try :)
-## App Language
+## Preference
+
+### App Language
Localize Xplorer. Help us translate Xplorer [here](https://github.com/kimlimjustin/xplorer/discussions/30).
-## Hide Hidden Files
+### Hide Hidden Files
Hide hidden files on Xplorer, you can find this setting on the `Preference` tab on Xplorer or by its shortcut, `Ctrl + H`.
-## Hide System Files
+### Hide System Files
Hide Windows' system files on Xplorer. :::tip Learn what is system file [here](https://en.wikipedia.org/wiki/System_file). Just turn it off if you don't understand what it is. :::
-## List and sort directories alongside files
+### List and sort directories alongside files
If disabled, Xplorer will prioritize directories above files.
+
+### Detect Drive Change
+
+Turning this on will detect drive change and update the sidebar and drives section. Please note that this will take high ammount of RAM as this is not stabilized yet.
+
+### On startup
+
+Option to do on starting Xplorer. Available options are:
+
+- New Tab
+- Continue previous session
diff --git a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/shortcut.md b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/shortcut.md
index 5a2ac3cb..1dcb2c04 100644
--- a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/shortcut.md
+++ b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/shortcut.md
@@ -4,19 +4,22 @@
| ------------------- | ------------------------ |
| `Ctrl + A` | Select All |
| `Ctrl + C` | Copy |
-| `Ctrl + E` | Close Tab |
| `Ctrl + H` | Toggle Hidden Files |
-| `Ctrl + O` | Preview file |
+| `Ctrl + N` | New window shortcut |
+| `Ctrl + O` | Open file in preview |
| `Ctrl + P` | Files/Folders Properties |
| `Ctrl + R` | Reload |
| `Ctrl + T` | New Tab |
| `Ctrl + V` | Paste |
| `Ctrl + X` | Cut |
-| `Ctrl + W` | Exit Xplorer |
+| `Ctrl + W` | Exit Tab |
+| `Ctrl + Y` | Redo |
+| `Ctrl + Z` | Undo |
+| `Ctrl + Shift + Z` | Redo |
| `Alt + Left Arrow` | Go Back |
| `Alt + Right Arrow` | Go Forward |
-| `Alt + Up Arrow` | maximize |
-| `Alt + Down Arrow` | minimize |
+| `Alt + Up Arrow` | Go to parent directory |
+| `Alt + N` | New File |
| `Alt + T` | Open in terminal |
| `Alt + P` | Pin to sidebar |
| `Alt + Shift + C` | Copy location path |
@@ -30,6 +33,6 @@
| `Enter` | Open |
| `Del` | Delete file |
-:::note Difference between `reload` and `refresh` `Reload` refreshes the internal HTML while `Refresh` refreshes the whole Electron process.
+:::note Difference between `reload` and `refresh` `Reload` refreshes the internal process while `Refresh` refreshes the whole process.
:::
diff --git a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/xplorer as default.md b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
index f575bfa4..e69d60f6 100644
--- a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
+++ b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
@@ -12,7 +12,7 @@
4. Navigate to `Computer\HKEY_CURRENT_USER\Software\Classes\Directory`
5. Create a key named `shell` if not existed by right and set the default key-value to `openinxplorer`
6. Create a key named `openinxplorer` under `shell`
-7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Users\User\AppData\Local\Programs\Microsoft VS Code\Code.exe" "%V"`
+7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Program Files\Xplorer\Xplorer.exe" "%V"`. (You may have to change `C:\Program Files\Xplorer\` to the location you installed Xplorer)
diff --git a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/intro.md b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/intro.md
index 50635c41..f126703b 100644
--- a/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/intro.md
+++ b/docs/i18n/id-ID/docusaurus-plugin-content-docs/current/intro.md
@@ -8,14 +8,18 @@ sidebar_position: 1
Welcome to Xplorer, A Free and Open Source (FOSS) File Explorer.
-Xplorer is a file explorer built from the ground up to be fully customizable and without customization, it also looks modern! It is cross-platform, built using Electron Technology that allowed our File Explorer to be run not only in Windows but also Linux and MacOS alike. It also allowed file preview directly inside it, not only pictures or documents but also videos!
+Xplorer is a file explorer built from ground-up to be fully customizable. And even without any customization, it already looks modern!
-## Fitur
+Xplorer is a cross-platform application built using [Tauri](https://tauri.studio), and you can run it on Windows, MacOS, or Linux without having much trouble. One of the key feature is Xplorer allows you to preview the files you have directly inside Xplorer. And it's not only limited to picture or document preview, but also video preview.
-So to summarize, Xplorer's features contain:
+To summarize, Xplorer's features contain:
-- Terlihat modern
+- It looks modern
- Mudah digunakan
- Lintas-perangkat
-- Melihat (_preview_) file secara _native_ langsung didalam aplikasi!
-- Yang terpenting, Gratis dan Open Source! Which mean you can change components inside if you see fit and you also don't need to make your wallet go dry or break the bank.
+- [File Preview](https://xplorer.vercel.app/docs/guides/operation/#preview-file), even for videos!
+- Customizable
+- Supports multiple tab
+- Most importantly, Free and Open Source Software(FOSS), which means you can change components inside if you see fit
+
+Xplorer is currently under heavy development. You can give your suggestions and feedbacks in our [Discussions](https://github.com/kimlimjustin/xplorer/discussions/) page. If you feel comfortable in writing code using Typescript and Rust, we highly encourage you to [contribute to this project](https://xplorer.vercel.app/community/Contributing/).
diff --git a/docs/i18n/id-ID/docusaurus-plugin-content-pages/index.jsx b/docs/i18n/id-ID/docusaurus-plugin-content-pages/index.jsx
index a1234bae..6a2f799a 100644
--- a/docs/i18n/id-ID/docusaurus-plugin-content-pages/index.jsx
+++ b/docs/i18n/id-ID/docusaurus-plugin-content-pages/index.jsx
@@ -5,102 +5,69 @@ import Slideshow from './slideshow';
import Link from '@docusaurus/Link';
export default function Home() {
- const { siteConfig } = useDocusaurusContext();
- return (
-
-
-
-
-
Penjelajah File
-
Redefinisi.
-
- Aplikasi Bebas dan Bersumber Terbuka (Foss). Dapat dijalankan dimana saja.
-
+
+ );
}
diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs-community/current/support.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs-community/current/support.md
index 2660e694..940df022 100644
--- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs-community/current/support.md
+++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs-community/current/support.md
@@ -1,34 +1,43 @@
---
sidebar_position: 1
---
+
# Suporte
+
Xplorer é um projeto de código aberto no qual você pode entrar livremente e buscar suporte 😊.
Nesta página nós listamos algumas comunidades/fóruns em que você pode participar para procurar apoio ou ajudar outros.
-Antes de participar das comunidades do Xplorer, leia nosso [Código de Conduta](/community/CODE_OF_CONDUCT/).
+Antes de participar das comunidades do Xplorer, leia nosso [Código de Conduta](/docs/community/CODE_OF_CONDUCT/).
## Issues
+
Usamos issues no GitHub para rastrear bugs públicos. Por favor, certifique-se de que sua descrição seja clara e tenha instruções suficientes para reproduzir o problema. Report a bug by opening a new issue [here](https://github.com/kimlimjustin/xplorer/issues/new). Por favor, use [Discussão GitHub](https://github.com/kimlimjustin/xplorer/discussions) para sugerir um novo recurso.
## Discussões no GitHub
+
Discussão do GitHub é usada para múltiplos fins, tais como:
+
1. Fazer Perguntas
2. Fazendo solicitações de recursos e compartilhando ideias
3. Anúncios do Xplorer
4. Chat do Xplorer
5. Mostrar e dizer: Fazendo temas/plug-ins personalizados para Xplorer e mostrando-os lá!
-
### Solicitar Recurso
+
Usamos a [Discussão do GitHub](https://github.com/kimlimjustin/xplorer/discussion) para avaliar ideias dos usuários. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! As ótimas solicitações de recursos tendem a ter:
-- Um resumo rápido da ideia.
-- O que & por que você queria adicionar o recurso específico.
-- Contexto adicional, como imagens, links para os recursos para implementar o recurso, etc.
+
+- Um resumo rápido da ideia.
+- O que & por que você queria adicionar o recurso específico.
+- Contexto adicional, como imagens, links para os recursos para implementar o recurso, etc.
+
### Ajuda
+
You can ask for help using [GitHub Discussion](https://github.com/kimlimjustin/xplorer/discussions) and others will answer you, just like Stack Overflow!
:::note Remember to choose the discussion category as Q&A so that your question will be published with answers enabled. :::
## Novidades
+
For the latest news about Xplorer, you can see it through the [official Xplorer blog](/blog) on this website.
diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/Community/Contributing.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/Community/Contributing.md
new file mode 100644
index 00000000..be326698
--- /dev/null
+++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/Community/Contributing.md
@@ -0,0 +1,173 @@
+---
+sidebar_position: 2
+---
+
+# Contribute
+
+👍🎉 First off, thanks for taking the time to contribute! 🎉👍
+
+Xplorer is currently under heavy development. We are welcoming contributors to collaborate on Xplorer.
+
+## Get involved
+
+There are many ways to contribute to Xplorer, and many of them do not involve writing any code. Here are few ideas to get started:
+
+- Start using Xplorer! Go through the Tutorial guides. Does anything work as expected? If not, we're always looking for improvements. Let us know by opening an issue.
+- Look through the [Xplorer issues](https://github.com/kimlimjustin/xplorer/issues). If you find an issue you would like to fix, [open a pull request](#first-pull-request). Issues tagged as [good first issue](https://github.com/kimlimjustin/xplorer/labels/good%20first%20issue) are a good place to get started.
+- Help us make the docs better. File an issue if you find anything that is confusing, any grammatical error, or can be improved.
+- Take a look at [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) and give your opinion into a discussion or consider opening a pull request if you see something you want to work on.
+
+Contributions are very welcome!
+
+## Our development process
+
+Xplorer uses [GitHub](https://github.com/kimlimjustin/xplorer) as its source of truth. The core team will work directly there. All changes will be public from the beginning.
+
+### Reporting new issues/bugs. {#issues}
+
+When [opening a new issue](https://github.com/kimlimjustin/xplorer/issues), always make sure to fill out the issue template. We use GitHub issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue.
+
+- _One issue, one bug_: Please report a single bug per issue.
+- _Provide reproduction steps_: List all the steps necessary to reproduce the issue. The person reading your bug report should be able to follow these steps to reproduce your issue with minimal effort.
+
+### Feature Request {#feat}
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) and [GitHub Issues](https://github.com/kimlimjustin/xplorer) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional references like images, links of resources about the feature, etc.
+
+## Working on Xplorer code
+
+### Prerequisite
+
+- [Tauri environment](https://tauri.studio/en/docs/getting-started/intro#setting-up-your-environment)
+- [Node JS](https://nodejs.org/en/)
+- [Git](https://git-scm.com/)
+- [yarn](https://yarnpkg.com/)
+- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
+
+### Installation
+
+1. After cloning the repository, run `yarn` in the root of the repository and run `yarn` in the `docs` folder (if you want to working on Xplorer Docs).
+2. To start Xplorer locally, run `yarn dev`.
+
+ To start a local development server serving the Docusaurus docs, go into the `docs` directory and run `yarn start`
+
+### Gitpod {#gitpod-env}
+
+Gitpod is a Ready-to-Code environment in which you can get started immediately. Gitpod offers all dependencies pre-installed so you can just click and get started.
+
+To get started with Gitpod, click the button below and log in with your GitHub account.
+
+[](https://gitpod.io/#https://github.com/kimlimjustin/xplorer)
+
+:::note Remember to reload the Gitpod website after it loads up since it won't start the servers immediately, but by reloading, you can get it started. If you are developing the app, go to the Remote Explorer on the sidebar and visit port _6080_ which opens the noVNC app server. If you are developing the docs, go to the Remote explorer but instead of port 6080, visit port _3000_. You can edit normally as you do in VS Code, but if you want to use it locally, clik the hamburger menu button and click _Open in VS Code_. :::
+
+### Semantic commit messages {#commit-msg}
+
+See how a minor change to your commit message style can make you a better programmer.
+
+Format: `(): `
+
+`` is optional
+
+#### Example
+
+```
+feat: allow overriding of webpack config
+^--^ ^------------^
+| |
+| +-> Summary in present tense.
+|
++-------> Type: chore, docs, feat, fix, refactor, style, or test.
+```
+
+the various types of commits:
+
+- `feat`: new feature for the user
+- `fix`: bug fix for the user
+- `docs`: changes to the documentation
+- `style`: formatting, missing semi-colons, etc.
+- `refactor`: refactoring production code, eg. renaming a variable
+- `test`: adding missing tests, refactoring tests.
+- `chore`: updating grunt tasks etc
+
+Use lower case not the upper case!
+
+## Working on Xplorer docs
+
+Xplorer documentation website is built using [Docusaurus 2](https://docusaurus.io/), and its code is located at [`docs`](https://github.com/kimlimjustin/xplorer/tree/master/docs) folder.
+
+### Prerequisite
+
+- [node js](https://nodejs.org/en/)
+- [git](https://git-scm.com/downloads)
+- [yarn](https://yarnpkg.com/getting-started/install#about-global-installs)
+- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
+
+### Installation
+
+After cloning the repository, run `yarn` in the `docs` folder (you can go into the `docs` folder by running the `cd docs` command).
+
+If you want to use Gitpod, click [here](#gitpod-env) for the guide on how to use Gitpod.
+
+### Local development
+
+1. Run the `yarn start` command in the `docs` folder.
+2. Edit some markdown texts in the `docs` folder and the website will be hot reloaded.
+
+## Pull requests
+
+### Your first pull request. {#first-pull-request}
+
+So you have decided to contribute code back to upstream by opening a pull request. You've invested a good chunk of time, and we appreciate it. We will do our best to work with you and get the PR looked at.
+
+Working on your first Pull Request? You can learn how from this free video series:
+
+How to Contribute to an Open Source Project on GitHub
+
+We have a list of [beginner-friendly issues](https://github.com/kimlimjustin/xplorer/labels/good%20first%20issue) to help you get your feet wet in the Xplorer codebase and familiar with our contribution process. This is a great place to get started.
+
+### Proposing a change
+
+If you would like to request a new feature or enhancement but are not yet thinking about opening a pull request, you can also [open a discussion](#feat) and others will code it!
+
+If you intend to fix a bug, please discuss it through [Issues](#issues) before submitting a pull request.
+
+If you intend to add a new feature, please discuss it through [GitHub Discussions](#feat) to avoid multiple people working on the same feature request.
+
+### Sending a Pull Request
+
+make sure the PR does only one thing, otherwise please split it. It is recommended to follow this [commit message style](#commit-msg).
+
+1. Fork [the repository](https://github.com/kimlimjustin/xplorer) and create your branch from `master`.
+2. Make changes and ensure your commit message is understandable.
+3. Open a [PR](https://github.com/kimlimjustin/xplorer/pulls) and ensure to describe your pull request clearly.
+
+## Working on Xplorer resources
+
+### Locales
+
+We host our locales on the [crowdin](https://crwd.in/xplorer). To translate it, please follow these steps:
+
+- Sign up on [Crowdin](https://crowdin.com) and Join our project [here](https://crwd.in/xplorer).
+- Make sure your locale exists there, if it does not exist, leave a comment in [this discussion](https://github.com/kimlimjustin/xplorer/discussions/30) and I'll add the language option :)
+- Get familiar with the Crowdin translation UI, as you will need to use it to translate JSON and Markdown files
+- Translate the content!
+
+#### Priority Files to translate on Crowdin
+
+1. `src/Locales` files
+2. `docs/` files
+
+#### Production
+
+Once the files on `src/Locales` have been translated for more than 80%, we will add it into the Xplorer app, and for the docs, we will add it into production once the translation looks good!
+
+Please comment [here](https://github.com/kimlimjustin/xplorer/discussions/30) if you have any questions!
+
+### File Library
+
+The json library of file types and thumbnail are found under `lib` folder and the icons are found under `src/Icons` folder. You may add file types and icons for file extensions you want to use and submit a PR.
diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/Community/support.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/Community/support.md
new file mode 100644
index 00000000..8ea01be3
--- /dev/null
+++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/Community/support.md
@@ -0,0 +1,42 @@
+---
+sidebar_position: 1
+---
+
+# Support
+
+Xplorer is an open-source project which you can freely join and seek support 😊.
+
+On this page, we've listed some communities/forums you can participate in to seek support or help others.
+
+Before participating in Xplorer's communities, please read our [Code Of Conduct](/docs/community/CODE_OF_CONDUCT/).
+
+## Issues
+
+We use GitHub Issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue. Report a bug by opening a new issue [here](https://github.com/kimlimjustin/xplorer/issues/new).
+
+## GitHub Discussions
+
+GitHub Discussions is used for multiple purposes, such as:
+
+1. Asking questions
+2. Making feature requests and sharing ideas
+3. Chat on Xplorer
+4. Show and tell: Making custom themes/plug-ins for Xplorer and showing them there!
+
+### Feature Request
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussion) and [GitHub Issues](https://github.com/kimlimjustin/xplorer/issues) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional context like images, links to resources to implement the feature, etc.
+
+### Help
+
+You can ask for help using [GitHub Discussion](https://github.com/kimlimjustin/xplorer/discussions) or [Discord Channel](https://discord.gg/kK7rwxPt).
+
+:::note Remember to choose the discussion category as Q&A so that your question will be published with answers enabled. :::
+
+## News
+
+For the latest news about Xplorer, you can see it through posts on [Forem](https://dev.to/t/xplorer).
diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/common_problems.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/common_problems.md
index 4bbb4c6f..3356dc6e 100644
--- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/common_problems.md
+++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/common_problems.md
@@ -1,3 +1,7 @@
+- - -
+sidebar_position: 3
+- - -
+
# Problemas comuns
**NB: For common problems during installation, please open [here](/docs/install/#common-problems)**
@@ -5,32 +9,13 @@
-### Xplorer continua carregando e travando.
-
-
-
-Try opening `cmd` by opening Win + R(Run) and type `cmd`.
-
-Insira o seguinte comando:
-
-```
-wmic
-```
-
-If the output says the `wmic` is not recognized as internal or internal command, please follow the following steps given on [this](https://superuser.com/questions/1178674/wmic-is-not-recognized-as-an-internal-or-external-command-operable-program-or) or [this](https://knowledge.informatica.com/s/article/156865?language=en_US). Also, please make sure that Windows Defender isn't blocking Xplorer from accessing your documents.
-
-
-
-
-
-
-### Abrir pastas como `Documentos`,` Desktop`, `Downloads` faz o Xplorer travar
+### Opening folder like `Documents`, `Desktop`, `Downloads` make Xplorer crashes
-Desabilite a opção [`Extrair o ícone do arquivo exe e deixe-o como configuração de pré-visualização`](/docs/guides/setting/#extract-exe-file-icon-and-make-it-a-preview).
+Disable the [`Extract exe file icon and make it as preview`](/docs/guides/setting/#extract-exe-file-icon-and-make-it-a-preview) setting.
-Além disso, certifique-se de que o Windows Defender não esteja bloqueando o acesso do Xplorer aos seus documentos.
+Also, please make sure that windows defender isn't blocking Xplorer from accessing your documents.
diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/_category_.json b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/_category_.json
index 4fcbfec1..edf0a6dc 100644
--- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/_category_.json
+++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/_category_.json
@@ -1,4 +1,4 @@
{
- "label": "Guias",
- "position": 3
-}
\ No newline at end of file
+ "label": "Guias",
+ "position": 4
+}
diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/cli.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/cli.md
index ac043cee..35e9347a 100644
--- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/cli.md
+++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/cli.md
@@ -1,7 +1,5 @@
# Inicie o Xplorer no Terminal
-:::info Esta funcionalidade não foi otimizada ainda. Funciona mas pode estar lagando. Será otimizado na versão de lançamento. :::
-
## Comandos
Xplorer CLI:
@@ -10,28 +8,10 @@ Xplorer CLI:
xplorer [dir1] [dir2] [dir3]
```
-O Xplorer abrirá o `dir`, `dir2`, `dir3` como guias no Xplorer. If there's no directory(dir) passed into the command, Xplorer will start at the Home page.
-
-Opções:
-
-| Comando | Alias | Descrição |
-| ----------- | ----- | ---------------------------------- |
-| `--help` | `-h` | Mostrar ajuda |
-| `--version` | `-v` | Mostrar número da versão |
-| `--reveal` | `-r` | Abra a pasta e selecione o arquivo |
-
-
-
-xplorer: comando não encontrado erro no Windows
-
-
-Em primeiro lugar, você tem que registrar o comando no caminho do sistema.
+Xplorer will open `dir`, `dir2`, `dir3` as tabs on Xplorer. If there's no directory(dir) passed into the command, Xplorer will start at the Home page.
-1. Abra as `Propriedades do Sistema` no Windows.
-2. Clique no botão `Variáveis de ambiente`, ele irá exibir uma janela.
-3. Na tabela, pesquise pela variável `Path` e clique nela.
-4. Clique no botão `Editar`, irá exibir uma janela.
-5. Clique no botão `Novo`.
-6. Adicione `%USERPROFILE%\AppData\Local\Programs\xplorer`.
+Options:
-
+| Comando | Alias | Descrição |
+| ---------- | ----- | ---------------------------------------------- |
+| `--reveal` | `-r` | Open the containing folder and select the file |
diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/operation.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/operation.md
index 619b72b4..d3f6af30 100644
--- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/operation.md
+++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/operation.md
@@ -6,165 +6,100 @@ Você pode copiar arquivos clicando com o botão direito e clicar na opção `Co
:::info
-No Windows e no macOS, o Xplorer irá copiar o caminho dos arquivos para a área de transferência local, por isso, você pode copiar um arquivo do Xplorer e colá-lo em qualquer pasta em outro sistema. No entanto, no Linux, nós criamos uma string nos comandos do Xplorer e a copiamos para a área de transferência do usuário, o Xplorer irá ler a área de transferência do usuário ao colar o arquivo (porque não encontramos nenhuma ideia para implementá-lo, sinta-se à vontade para [abrir um PR](/community/Contributing/#pull-requests) se você puder nos ajudar). A string nos comandos do Xplorer se parece dessa forma:
+For current implementation, Xplorer write down what to copy locally (not copying to clipboard).
-```
-Xplorer command - COPY
-~/xplorer
-~/test
-```
+TODO: implement copy to clipboard
:::
## Copiar caminho de localização
-Você pode copiar um caminho de localização de arquivo/pasta para a área de transferência clicando com o botão direito do mouse e clicando em `Copiar caminho de localização` ou selecione o arquivo e pressione `Alt + Shift + C` no teclado.
+You can copy a file/folder location path into your clipboard by right-clicking it and click `Copy Location Path` or select the file then press `Alt + Shift + C` as a shortcut.
## Recortar arquivo
-Você pode recortar arquivos clicando com o botão direito e clicando na opção `Recortar` ou selecione o arquivo e pressione `Ctrl + X` no teclado, e para colá-lo clicando no botão `Colar` ou pressione ` Ctrl + V ` na pasta de destino.
+You can cut files by right-clicking it and click the `Cut` option or select the file then press `Ctrl + X` as a shortcut and paste it by clicking the `Paste` option or press `Ctrl + V` on the destination folder.
-:::info Isso é feito criando uma string nos comandos do Xplorer e a copia para a área de transferência do usuário para ser usada ao colar o arquivo (não está integrado com a plataforma porque não encontramos nenhuma ideia, sinta-se à vontade para [abrir um PR](/community/Contributing/#pull-requests) se você puder nos ajudar.). A string nos comandos do Xplorer se parece dessa forma:
+:::info
-```
-Xplorer command - CUT
-E://xplorer
-E://test
-```
+For current implementation, Xplorer write down what to cut locally (not copying to clipboard).
:::
## Apagar arquivos
-Você pode apagar arquivos clicando com o botão direito e selecionando a opção `Delete` ou selecionando o arquivo e pressionando `Del` no teclado. O arquivo na lixeira pode ser acessado em `xplorer://Trash`.
+You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut.
-:::info
+### Trashed files
-- No Windows, isto é feito criando uma pasta `Lixeira` em `Disco Local C:` e movendo o arquivo até ela.
-- No Linux, esta função está totalmente integrada com o sistema.
-- No macOS, isso é feito criando uma pasta `.local/Lixeira` no diretório `homedir` e movendo o arquivo para ele.
+The trashed file can be accessed at `xplorer://Trash` or your system trash folder. :::danger Open Issue
-Nós estamos trabalhando para integrar a `Lixeira` no Windows e macOS, será lançado antes do lançamento da versão estável. Sinta-se livre para [abrir um PR](/community/Contributing/#pull-requests) se você puder nos ajudar.
+Please note that Trash folder cannot be accessed on macos via Xplorer since the [trash crate](https://github.com/Byron/trash-rs) Xplorer relies to does not support it (see [this issue](https://github.com/Byron/trash-rs/issues/8) for more details).
-:::
+Any contributions to either the trash crate or Xplorer itself for this topic are welcome. :::
+
+### Restore files
+
+You can restore files by opening the `xplorer://Trash` and right-clicking it and click the `Restore` option
-### Excluir permanentemente
+### Permanently delete
-:::danger Um arquivo excluído permanentemente não pode ser restaurado. Por favor, verifique novamente antes de excluir permanentemente os arquivos.
+:::danger A permanently deleted file cannot be restored. Please check again before permanently delete any files.
:::
-Você pode excluir um arquivo permanentemente das seguintes formas:
+You can permanently delete a file by:
1. Exclua-o na `Lixeira`, clique com o botão direito e clique na opção `Excluir Permanentemente`
2. Selecione o arquivo e pressione `Shift + Del` no teclado
## Novo
-:::caution Tenha cuidado com o novo nome de arquivo/pasta Tratamentos do Xplorer `/` no nome/pasta do arquivo como subdir/subarquivo :::
+:::caution Be careful with new file/folder name Xplorer treats `/` on file name/folder as subdir/subfile :::
-### Novo arquivo
+### New file
-Você pode criar um novo arquivo clicando com o botão direito do mouse na área de trabalho, selecione a opção `Novo` e selecione a opção `Arquivo` ou pressione `Alt + N` no teclado.
+You can create a new file by right-clicking the workspace, expand the `New` option and select the `file` option, or press `Alt + N` as a shortcut.
-### Nova Pasta
+### New folder
-Você pode criar uma nova pasta clicando com o botão direito do mouse na área de trabalho, selecione a opção `Novo` e selecione a opção `Pasta` ou pressione `Shift + N` no teclado.
+You can create a new folder by right-clicking the workspace, expand the `New` option and select the `folder` option, or press `Shift + N` as a shortcut.
## Abrir arquivo
-Você pode abrir um arquivo com o aplicativo padrão clicando duas vezes com o mouse ou selecionando o arquivo e pressionando `Enter` no teclado.
+You can open a file on the default application by double-clicking it or select the file then press `Enter` as a shortcut.
-### Abrir no terminal
+### Open in Terminal
-Esta é uma função integrada do Xplorer. Você pode abrir uma pasta no Terminal clicando com o botão direito e clique na opção `Abrir no terminal` ou selecionando a pasta e pressione `Alt + T` no teclado.
+This is a built-in function by Xplorer. You can open a folder on Terminal by right-clicking it and click the `Open in terminal` option or select the folder then press `Alt + T` as a shortcut.
-### Abrir no VSCode
+### Open in VSCode
-Esta é uma função integrada do Xplorer. Você pode abrir um arquivo/pasta no VSCode clicando com o botão direito e clicando na opção `Abrir no VSCode` ou selecionando o arquivo e pressione `Ctrl + Enter` no teclado. Você não será capaz de fazer isso se não tiver o VSCode instalado.
+This is a built-in function by Xplorer. You can open a file/folder on VSCode by right-clicking it and click the `Open in vscode` option or select the file then press `Ctrl + Enter` as a shortcut. You won't able to do this if you don't have VSCode installed.
## Fixar na Barra Lateral
-Você pode fixar um arquivo/pasta na barra lateral clicando com o botão direito e clicando em `Fixar na barra lateral` ou selecionando o arquivo e pressionando `Alt + P` no teclado.
+You can pin a file/folder into the sidebar by right-clicking it and click `Pin to Sidebar` or select the file then press `Alt + P` as a shortcut.
## Pré-visualizar arquivo
-Você pode pré-visualizar um arquivo diretamente do Xplorer clicando com o botão direito do mouse sobre ele e clique em `Pré-visualizar` ou selecione o arquivo, em seguida, pressione `Ctrl + O` no teclado.
+You can preview a file directly from Xplorer by right-clicking it and click the `Preview` option or select the file then press `Ctrl+O`.
-
+
:::info
-Arquivos disponíveis para pré-visualização agora:
+Files available to preview for now:
-```json
-[
- ".pdf",
- ".html",
- ".docx",
- ".htm",
- ".xlsx",
- ".xls",
- ".xlsb",
- "xls",
- ".ods",
- ".fods",
- ".csv",
- ".txt",
- ".py",
- ".js",
- ".bat",
- ".css",
- ".c++",
- ".cpp",
- ".cc",
- ".c",
- ".diff",
- ".patch",
- ".go",
- ".java",
- ".json",
- ".php",
- ".ts",
- ".tsx",
- ".jsx",
- ".jpg",
- ".png",
- ".gif",
- ".bmp",
- ".jpeg",
- ".jpe",
- ".jif",
- ".jfif",
- ".jfi",
- ".webp",
- ".tiff",
- ".tif",
- ".ico",
- ".svg",
- ".webp",
- ".mp4",
- ".webm",
- ".mpg",
- ".mp2",
- ".mpeg",
- ".mpe",
- ".mpv",
- ".ocg",
- ".m4p",
- ".m4v",
- ".avi",
- ".wmv",
- ".mov",
- ".qt",
- ".flv",
- ".swf",
- ".md"
-]
-```
+* Markdown files
+* Image files
+* Text files
+* Video files
+* Pdfs
+* Almost all programming language with syntax highlighting
@@ -172,7 +107,7 @@ Arquivos disponíveis para pré-visualização agora:
## Propriedades
-Você pode ver as propriedades de um arquivo ou pasta clicando com o botão direito e selecionando a opção `Propriedades` ou selecionando o arquivo e pressionando `Ctrl + P` no teclado. Propriedades disponíveis por agora (serão melhoradas na próxima versão):
+You can view properties of a file/folder by right-clicking it and click `Properties` or select the file then press `Ctrl + P` as a shortcut. Available properties for now (will be improved at the next version):
- Tamanho
- Caminho do Arquivo
@@ -183,4 +118,4 @@ Você pode ver as propriedades de um arquivo ou pasta clicando com o botão dire
## Renomear o arquivo/pasta
-Você pode renomear um arquivo/pasta clicando com o botão direito do mouse nele e clique na opção `Renomear` ou selecione o arquivo e pressione `F2` no teclado. Ele irá solicitar um diálogo, digite o novo nome e o arquivo/pasta serão renomeados.
+You can rename a file/folder by right-clicking it and click the `Rename` option or select the file then press `F2` as a shortcut. It will prompt a dialog, enter the new name and the file/folder will be renamed.
diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/setting.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/setting.md
index 1087f0c8..a770561b 100644
--- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/setting.md
+++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/setting.md
@@ -12,33 +12,67 @@ Você pode abrir as configurações no Xplorer clicando no botão `Ajustes` à e
How to exit from Settings?
-You can exit from Settings on Xplorer by clicking the Arrow Up button on the upside left of Xplorer.
+You can exit from Settings on Xplorer by clicking on the upside left of Xplorer.
-## Tema do Aplicativo
+## Appearance
+
+### App Theme
Você pode alterar o tema do aplicativo do Xplorer's na aba `Aparência` das Configurações. Temas padrão disponíveis são `light`, `light+`, `dark` e `dark+`. Além disso, tem o tema `System Default` que irá ler automaticamente suas preferências do sistema. :::info O Xplorer suporta tema personalizado em breve, fique ligado! :::
-### Efeito Acrílico
+### Font Family
+
+You can change Xplorer's font family on the `Appearance` tab of the Settings to one of installed font families installed on your system.
+
+### Font Size
+
+You can change Xplorer's font size on the `Appearance` tab of the Settings. Please note that an ideal font size is between 10px to 30px.
+
+### Window Transparency
+
+Make Xplorer window transparent on the `Appearance` tab of the Settings by combining following options. Please note that an ideal transparency is between 70% to 100%. You can disable transparency by disable all of the transparency options.
+
+#### Transparent Sidebar
+
+Make the sidebar transparent 
+
+#### Transparent Topbar
+
+Make the topbar transparent 
+
+#### Transparent Workspace
+
+make the workspace transparent 
+
+### Frame Style
+
+You can choose the frame style on the `Appearance` tab of the Settings. The available options are `Default` and `System Default`. `Default` will use Xplorer's default style which is the same across platforms. `System Default` will use the system default frame style which is difference according to your platform.
-O efeito acrítico é o efeito que dá o efeito de transparência na barra lateral. Só funciona no Windows 10 ou superior.
+### File Preview
-## Pré-visualização de Arquivo
+File Preview here might means the file thumbnail.
-A pré-visualização de arquivo aqui significa a pré-visualização que substitui o ícone padrão de um arquivo.
+#### Automatically play video file as thumbnail
-### Reproduzir vídeo como pré-visualização
+This will automatically play the video file as a preview. :::caution THIS MIGHT CONSUME HIGH AMOUNT OF RAM This might consume a high amount of RAM because it's built on the HTML video player. You can just enable this setting and ignore this caution if you got a good-spec computer. :::
-Isto irá reproduzir automaticamente o arquivo de vídeo como visualização. :::caution, ISTO PODE CONSUMIR MAIS RAM Isso pode consumir uma quantidade escondida de RAM porque é construído sobre o reprodutor de vídeo HTML. Você pode apenas habilitar essa configuração e ignorar essa cautela se você tem um bom computador. :::
+#### Preview image on hover
-### Extrair o ícone de arquivo `EXE` e torná-lo como pré-visualização
+This fill automatically show the image when you hovering it for 500ms.
-Isso irá analisar e armazenar em cache o ícone de um arquivo `exe` e torná-lo uma prévia. Apenas no Windows.
+
-
+Some people might found it annoying and you can disable it by disabling this setting.
+
+#### Extract exe file icon and make it as the thumbnail
+
+This will parse and cache the icon from a `exe` file and make it a preview. Only on Windows.
+
+
:::warning This might causes Xplorer to crash.
@@ -48,22 +82,43 @@ The way to fix it is to disable the setting.
:::
-## Layout de arquivo padrão
+:::info Open issue The current approach is by calling the powershell program which might pops up cmd windows.
+
+Any contribution to call it directly from Xplorer is welcome. :::
+
+#### Show Image as Thumbnail
+
+This will show the image as a thumbnail of a file. Please note that this is not recommended for large directory as it reads the image to memory.
+
+#### Default file layout
+
+Default file layout of a directory. Just give it a try :)
+
+## Preference
+
+### App Language
+
+Localize Xplorer. Help us translate Xplorer [here](https://github.com/kimlimjustin/xplorer/discussions/30).
+
+### Hide Hidden Files
+
+Hide hidden files on Xplorer, you can find this setting on the `Preference` tab on Xplorer or by its shortcut, `Ctrl + H`.
-Layout de arquivo padrão de um diretório. Experimente :)
+### Hide System Files
-## Idioma do Aplicativo
+Hide Windows' system files on Xplorer. :::tip Learn what is system file [here](https://en.wikipedia.org/wiki/System_file). Just turn it off if you don't understand what it is. :::
-Localize Xplorer. Ajude-nos a traduzir o Xplorer [aqui](https://github.com/kimlimjustin/xplorer/discussions/30).
+### List and sort directories alongside files
-## Esconder arquivos ocultos
+If disabled, Xplorer will prioritize directories above files.
-Para ocultar arquivos no Xplorer, você pode encontrar esta configuração na guia `Preferências` no Xplorer ou por seu atalho, `Ctrl + H`.
+### Detect Drive Change
-## Esconder arquivos do sistema
+Turning this on will detect drive change and update the sidebar and drives section. Please note that this will take high ammount of RAM as this is not stabilized yet.
-Ocultar arquivos de sistema do Windows no Xplorer. :::tip Aprenda o que é arquivo de sistema [aqui](https://en.wikipedia.org/wiki/System_file). Apenas desligue-o se você não entender o que é. :::
+### On startup
-## Listar e ordenar diretórios juntamente com arquivos
+Option to do on starting Xplorer. Available options are:
-Se desativado, o Xplorer priorizará os diretórios acima dos arquivos.
+- New Tab
+- Continue previous session
diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/shortcut.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/shortcut.md
index 31963a0c..703beada 100644
--- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/shortcut.md
+++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/shortcut.md
@@ -1,35 +1,38 @@
# Atalhos
-| Atalho | Descrição |
-| --------------------- | -------------------------------- |
-| `Ctrl + A` | Selecionar Tudo |
-| `Ctrl + C` | Copiar |
-| `Ctrl + E` | Fechar a Aba |
-| `Ctrl + H` | Mostrar/Ocultar Arquivos Ocultos |
-| `Ctrl + O` | Pré-visualizar arquivo |
-| `Ctrl + P` | Propriedades Arquivos/Pastas |
-| `Ctrl + R` | Recarregar |
-| `Ctrl + T` | Nova Aba |
-| `Ctrl + V` | Colar |
-| `Ctrl + X` | Recortar |
-| `Ctrl + W` | Sair do Xplorer |
-| `Alt + Seta Esquerda` | Voltar |
-| `Alt + Seta Direita` | Avançar |
-| `Alt + Seta Cima` | Maximizar |
-| `Alt + Seta Baixo` | Minimizar |
-| `Alt + T` | Abrir no Terminal |
-| `Alt + P` | Fixar na barra lateral |
-| `Alt + Shift + C` | Copiar caminho de localização |
-| `F2` | Renomear |
-| `F5` | Atualizar |
-| `F10` | Minimizar |
-| `F11` | Maximizar |
-| `Shift + N` | Nova Pasta |
-| `Shift + Del` | Excluir Permanentemente |
-| `Shift + Enter` | Abrir no VSCode |
-| `Enter` | Abrir |
-| `Del` | Apagar |
+| Atalho | Descrição |
+| ------------------- | ---------------------------- |
+| `Ctrl + A` | Selecionar Tudo |
+| `Ctrl + C` | Copiar |
+| `Ctrl + H` | Toggle Hidden Files |
+| `Ctrl + N` | New window shortcut |
+| `Ctrl + O` | Open file in preview |
+| `Ctrl + P` | Propriedades Arquivos/Pastas |
+| `Ctrl + R` | Recarregar |
+| `Ctrl + T` | Nova Aba |
+| `Ctrl + V` | Colar |
+| `Ctrl + X` | Recortar |
+| `Ctrl + W` | Exit Tab |
+| `Ctrl + Y` | Redo |
+| `Ctrl + Z` | Undo |
+| `Ctrl + Shift + Z` | Redo |
+| `Alt + Left Arrow` | Go Back |
+| `Alt + Right Arrow` | Go Forward |
+| `Alt + Up Arrow` | Go to parent directory |
+| `Alt + N` | New File |
+| `Alt + T` | Open in terminal |
+| `Alt + P` | Pin to sidebar |
+| `Alt + Shift + C` | Copy location path |
+| `F2` | Rename |
+| `F5` | Refresh |
+| `F10` | Minimize |
+| `F11` | Maximize |
+| `Shift + N` | New Folders |
+| `Shift + Del` | Permanent Delete |
+| `Shift + Enter` | Open in vscode |
+| `Enter` | Open |
+| `Del` | Delete file |
-:::note Diferença entre `Recarregar` e `Atualizar` `Recarregar` atualiza o HTML interno enquanto `Atualizar` atualiza todo o processo do Electron.
+:::note Difference between `reload` and `refresh` `Reload` refreshes the internal process while `Refresh` refreshes the whole process.
:::
diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/xplorer as default.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
index 6d63c3c8..d90db55a 100644
--- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
+++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
@@ -12,7 +12,7 @@
4. Navegue para `Computer\HKEY_CURRENT_USER\Software\Classes\Directory`
5. Create a key named `shell` if not existed by right and set the default key-value to `openinxplorer`
6. Crie uma chave chamada `openinxplorer` em `shell`
-7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Users\User\AppData\Local\Programs\Microsoft VS Code\Code.exe" "%V"`
+7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Program Files\Xplorer\Xplorer.exe" "%V"`. (You may have to change `C:\Program Files\Xplorer\` to the location you installed Xplorer)
diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/intro.md b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/intro.md
index 2affd1ac..634e7bbc 100644
--- a/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/intro.md
+++ b/docs/i18n/pt-BR/docusaurus-plugin-content-docs/current/intro.md
@@ -6,16 +6,20 @@ sidebar_position: 1
## Sumário
-Welcome to Xplorer, A Free and Open Source (FOSS) File Explorer.
+Bem vindo ao Xplorer, Um Explorador de Arquivos de Código Aberto e Grátis (FOSS).
-O Xplorer é um explorador de arquivos construído do zero para ser totalmente personalizável, também parece moderno! É multiplataforma, feita utilizando a tecnologia Electron que permitiu que o File Explorer fosse executado não apenas no Windows, mas também no Linux e MacOS. Também permite a pré-visualização de arquivos diretamente dentro dele, não só de fotos ou documentos, mas também de vídeos!
+Xplorer is a file explorer built from ground-up to be fully customizable. And even without any customization, it already looks modern!
-## Funcionalidades
+Xplorer is a cross-platform application built using [Tauri](https://tauri.studio), and you can run it on Windows, MacOS, or Linux without having much trouble. One of the key feature is Xplorer allows you to preview the files you have directly inside Xplorer. And it's not only limited to picture or document preview, but also video preview.
-Então, resumindo, os recursos do Xplorer:
+To summarize, Xplorer's features contain:
-- Parece moderno
+- It looks modern
- Fácil de usar
- Multi-plataforma
-- Pré-visualização de Arquivo, até mesmo vídeos!
-- O mais importante, é gratuito e de código aberto! Which mean you can change components inside if you see fit and you also don't need to make your wallet go dry or break the bank.
+- [File Preview](https://xplorer.vercel.app/docs/guides/operation/#preview-file), even for videos!
+- Customizable
+- Supports multiple tab
+- Most importantly, Free and Open Source Software(FOSS), which means you can change components inside if you see fit
+
+Xplorer is currently under heavy development. You can give your suggestions and feedbacks in our [Discussions](https://github.com/kimlimjustin/xplorer/discussions/) page. If you feel comfortable in writing code using Typescript and Rust, we highly encourage you to [contribute to this project](https://xplorer.vercel.app/community/Contributing/).
diff --git a/docs/i18n/pt-BR/docusaurus-plugin-content-pages/index.jsx b/docs/i18n/pt-BR/docusaurus-plugin-content-pages/index.jsx
index af0bfb03..df4e4c70 100644
--- a/docs/i18n/pt-BR/docusaurus-plugin-content-pages/index.jsx
+++ b/docs/i18n/pt-BR/docusaurus-plugin-content-pages/index.jsx
@@ -5,102 +5,69 @@ import Slideshow from './slideshow';
import Link from '@docusaurus/Link';
export default function Home() {
- const { siteConfig } = useDocusaurusContext();
- return (
-
-
-
-
-
Explorador de Arquivos
-
Redefinido.
-
- Software gratuito e de Código Aberto. Roda em todos os lugares.
-
+
+ );
}
diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/Community/Contributing.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/Community/Contributing.md
new file mode 100644
index 00000000..be326698
--- /dev/null
+++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/Community/Contributing.md
@@ -0,0 +1,173 @@
+---
+sidebar_position: 2
+---
+
+# Contribute
+
+👍🎉 First off, thanks for taking the time to contribute! 🎉👍
+
+Xplorer is currently under heavy development. We are welcoming contributors to collaborate on Xplorer.
+
+## Get involved
+
+There are many ways to contribute to Xplorer, and many of them do not involve writing any code. Here are few ideas to get started:
+
+- Start using Xplorer! Go through the Tutorial guides. Does anything work as expected? If not, we're always looking for improvements. Let us know by opening an issue.
+- Look through the [Xplorer issues](https://github.com/kimlimjustin/xplorer/issues). If you find an issue you would like to fix, [open a pull request](#first-pull-request). Issues tagged as [good first issue](https://github.com/kimlimjustin/xplorer/labels/good%20first%20issue) are a good place to get started.
+- Help us make the docs better. File an issue if you find anything that is confusing, any grammatical error, or can be improved.
+- Take a look at [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) and give your opinion into a discussion or consider opening a pull request if you see something you want to work on.
+
+Contributions are very welcome!
+
+## Our development process
+
+Xplorer uses [GitHub](https://github.com/kimlimjustin/xplorer) as its source of truth. The core team will work directly there. All changes will be public from the beginning.
+
+### Reporting new issues/bugs. {#issues}
+
+When [opening a new issue](https://github.com/kimlimjustin/xplorer/issues), always make sure to fill out the issue template. We use GitHub issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue.
+
+- _One issue, one bug_: Please report a single bug per issue.
+- _Provide reproduction steps_: List all the steps necessary to reproduce the issue. The person reading your bug report should be able to follow these steps to reproduce your issue with minimal effort.
+
+### Feature Request {#feat}
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) and [GitHub Issues](https://github.com/kimlimjustin/xplorer) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional references like images, links of resources about the feature, etc.
+
+## Working on Xplorer code
+
+### Prerequisite
+
+- [Tauri environment](https://tauri.studio/en/docs/getting-started/intro#setting-up-your-environment)
+- [Node JS](https://nodejs.org/en/)
+- [Git](https://git-scm.com/)
+- [yarn](https://yarnpkg.com/)
+- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
+
+### Installation
+
+1. After cloning the repository, run `yarn` in the root of the repository and run `yarn` in the `docs` folder (if you want to working on Xplorer Docs).
+2. To start Xplorer locally, run `yarn dev`.
+
+ To start a local development server serving the Docusaurus docs, go into the `docs` directory and run `yarn start`
+
+### Gitpod {#gitpod-env}
+
+Gitpod is a Ready-to-Code environment in which you can get started immediately. Gitpod offers all dependencies pre-installed so you can just click and get started.
+
+To get started with Gitpod, click the button below and log in with your GitHub account.
+
+[](https://gitpod.io/#https://github.com/kimlimjustin/xplorer)
+
+:::note Remember to reload the Gitpod website after it loads up since it won't start the servers immediately, but by reloading, you can get it started. If you are developing the app, go to the Remote Explorer on the sidebar and visit port _6080_ which opens the noVNC app server. If you are developing the docs, go to the Remote explorer but instead of port 6080, visit port _3000_. You can edit normally as you do in VS Code, but if you want to use it locally, clik the hamburger menu button and click _Open in VS Code_. :::
+
+### Semantic commit messages {#commit-msg}
+
+See how a minor change to your commit message style can make you a better programmer.
+
+Format: `(): `
+
+`` is optional
+
+#### Example
+
+```
+feat: allow overriding of webpack config
+^--^ ^------------^
+| |
+| +-> Summary in present tense.
+|
++-------> Type: chore, docs, feat, fix, refactor, style, or test.
+```
+
+the various types of commits:
+
+- `feat`: new feature for the user
+- `fix`: bug fix for the user
+- `docs`: changes to the documentation
+- `style`: formatting, missing semi-colons, etc.
+- `refactor`: refactoring production code, eg. renaming a variable
+- `test`: adding missing tests, refactoring tests.
+- `chore`: updating grunt tasks etc
+
+Use lower case not the upper case!
+
+## Working on Xplorer docs
+
+Xplorer documentation website is built using [Docusaurus 2](https://docusaurus.io/), and its code is located at [`docs`](https://github.com/kimlimjustin/xplorer/tree/master/docs) folder.
+
+### Prerequisite
+
+- [node js](https://nodejs.org/en/)
+- [git](https://git-scm.com/downloads)
+- [yarn](https://yarnpkg.com/getting-started/install#about-global-installs)
+- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
+
+### Installation
+
+After cloning the repository, run `yarn` in the `docs` folder (you can go into the `docs` folder by running the `cd docs` command).
+
+If you want to use Gitpod, click [here](#gitpod-env) for the guide on how to use Gitpod.
+
+### Local development
+
+1. Run the `yarn start` command in the `docs` folder.
+2. Edit some markdown texts in the `docs` folder and the website will be hot reloaded.
+
+## Pull requests
+
+### Your first pull request. {#first-pull-request}
+
+So you have decided to contribute code back to upstream by opening a pull request. You've invested a good chunk of time, and we appreciate it. We will do our best to work with you and get the PR looked at.
+
+Working on your first Pull Request? You can learn how from this free video series:
+
+How to Contribute to an Open Source Project on GitHub
+
+We have a list of [beginner-friendly issues](https://github.com/kimlimjustin/xplorer/labels/good%20first%20issue) to help you get your feet wet in the Xplorer codebase and familiar with our contribution process. This is a great place to get started.
+
+### Proposing a change
+
+If you would like to request a new feature or enhancement but are not yet thinking about opening a pull request, you can also [open a discussion](#feat) and others will code it!
+
+If you intend to fix a bug, please discuss it through [Issues](#issues) before submitting a pull request.
+
+If you intend to add a new feature, please discuss it through [GitHub Discussions](#feat) to avoid multiple people working on the same feature request.
+
+### Sending a Pull Request
+
+make sure the PR does only one thing, otherwise please split it. It is recommended to follow this [commit message style](#commit-msg).
+
+1. Fork [the repository](https://github.com/kimlimjustin/xplorer) and create your branch from `master`.
+2. Make changes and ensure your commit message is understandable.
+3. Open a [PR](https://github.com/kimlimjustin/xplorer/pulls) and ensure to describe your pull request clearly.
+
+## Working on Xplorer resources
+
+### Locales
+
+We host our locales on the [crowdin](https://crwd.in/xplorer). To translate it, please follow these steps:
+
+- Sign up on [Crowdin](https://crowdin.com) and Join our project [here](https://crwd.in/xplorer).
+- Make sure your locale exists there, if it does not exist, leave a comment in [this discussion](https://github.com/kimlimjustin/xplorer/discussions/30) and I'll add the language option :)
+- Get familiar with the Crowdin translation UI, as you will need to use it to translate JSON and Markdown files
+- Translate the content!
+
+#### Priority Files to translate on Crowdin
+
+1. `src/Locales` files
+2. `docs/` files
+
+#### Production
+
+Once the files on `src/Locales` have been translated for more than 80%, we will add it into the Xplorer app, and for the docs, we will add it into production once the translation looks good!
+
+Please comment [here](https://github.com/kimlimjustin/xplorer/discussions/30) if you have any questions!
+
+### File Library
+
+The json library of file types and thumbnail are found under `lib` folder and the icons are found under `src/Icons` folder. You may add file types and icons for file extensions you want to use and submit a PR.
diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/Community/support.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/Community/support.md
new file mode 100644
index 00000000..8ea01be3
--- /dev/null
+++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/Community/support.md
@@ -0,0 +1,42 @@
+---
+sidebar_position: 1
+---
+
+# Support
+
+Xplorer is an open-source project which you can freely join and seek support 😊.
+
+On this page, we've listed some communities/forums you can participate in to seek support or help others.
+
+Before participating in Xplorer's communities, please read our [Code Of Conduct](/docs/community/CODE_OF_CONDUCT/).
+
+## Issues
+
+We use GitHub Issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue. Report a bug by opening a new issue [here](https://github.com/kimlimjustin/xplorer/issues/new).
+
+## GitHub Discussions
+
+GitHub Discussions is used for multiple purposes, such as:
+
+1. Asking questions
+2. Making feature requests and sharing ideas
+3. Chat on Xplorer
+4. Show and tell: Making custom themes/plug-ins for Xplorer and showing them there!
+
+### Feature Request
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussion) and [GitHub Issues](https://github.com/kimlimjustin/xplorer/issues) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional context like images, links to resources to implement the feature, etc.
+
+### Help
+
+You can ask for help using [GitHub Discussion](https://github.com/kimlimjustin/xplorer/discussions) or [Discord Channel](https://discord.gg/kK7rwxPt).
+
+:::note Remember to choose the discussion category as Q&A so that your question will be published with answers enabled. :::
+
+## News
+
+For the latest news about Xplorer, you can see it through posts on [Forem](https://dev.to/t/xplorer).
diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/common_problems.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/common_problems.md
index 0329306c..ebdcac5f 100644
--- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/common_problems.md
+++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/common_problems.md
@@ -1,3 +1,7 @@
+- - -
+sidebar_position: 3
+- - -
+
# Common Problems
**NB: For common problems during installation, please open [here](/docs/install/#common-problems)**
@@ -5,25 +9,6 @@
-### Xplorer keep loading and crashes.
-
-
-
-Try opening `cmd` by opening Win + R(Run) and type `cmd`.
-
-Enter following command:
-
-```
-wmic
-```
-
-If the output says the `wmic` is not recognized as internal or internal command, please follow the following steps given on [this](https://superuser.com/questions/1178674/wmic-is-not-recognized-as-an-internal-or-external-command-operable-program-or) or [this](https://knowledge.informatica.com/s/article/156865?language=en_US). Also, please make sure that Windows Defender isn't blocking Xplorer from accessing your documents.
-
-
-
-
-
-
### Opening folder like `Documents`, `Desktop`, `Downloads` make Xplorer crashes
diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/_category_.json b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/_category_.json
index 9154734a..a9722bc2 100644
--- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/_category_.json
+++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/_category_.json
@@ -1,4 +1,4 @@
{
- "label": "Руководства",
- "position": 3
-}
\ No newline at end of file
+ "label": "Руководства",
+ "position": 4
+}
diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/cli.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/cli.md
index 6bc6d7e1..08b86ec4 100644
--- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/cli.md
+++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/cli.md
@@ -1,7 +1,5 @@
# Запуск Xplorer из терминала
-:::info This feature hasn't been optimized yet. Она может работать нестабильно. This will be optimized in the feature release. :::
-
## Команды
Xplorer CLI:
@@ -10,28 +8,10 @@ Xplorer CLI:
xplorer [dir1] [dir2] [dir3]
```
-Xplorer откроет `dir`, `dir2`, `dir3` в качестве вкладок. If there's no directory(dir) passed into the command, Xplorer will start at the Home page.
-
-Параметры:
-
-| Команда | Сокращение | Описание |
-| ----------- | ---------- | ----------------------------------------- |
-| `--help` | `-h` | Справка |
-| `--version` | `-v` | Показать номер версии |
-| `--reveal` | `-r` | Открыть папку с содержимым и выбрать файл |
-
-
-
-ошибка xplorer: command not found в Windows
-
-
-Для начала вы должны зарегистрировать команду в системный путь.
+Xplorer will open `dir`, `dir2`, `dir3` as tabs on Xplorer. If there's no directory(dir) passed into the command, Xplorer will start at the Home page.
-1. Откройте `Свойства системы` в Windows.
-2. Click the `Environment Variables` button, it will pop up a window.
-3. On the table, search for the `Path` variable and click on it.
-4. Click the `Edit` button, it will pop up a window.
-5. Click the `New` button.
-6. Add `%USERPROFILE%\AppData\Local\Programs\xplorer`.
+Options:
-
+| Команда | Сокращение | Описание |
+| ---------- | ---------- | ---------------------------------------------- |
+| `--reveal` | `-r` | Open the containing folder and select the file |
diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/operation.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/operation.md
index c5e13b91..87a8a09a 100644
--- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/operation.md
+++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/operation.md
@@ -6,13 +6,9 @@ You can copy files by right-clicking it and click the `Copy` option or select th
:::info
-On Windows and macOS, Xplorer will copy the file paths into the local clipboard, because of this, you can copy a file from Xplorer and paste it into any folder in another system. However, on Linux, we create a string of Xplorer commands and copy it into the user clipboard, Xplorer will read the user's clipboard when pasting the file (because we haven't found any idea to implement it, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us). The string of the Xplorer command looks like this:
+For current implementation, Xplorer write down what to copy locally (not copying to clipboard).
-```
-Xplorer command - COPY
-~/xplorer
-~/test
-```
+TODO: implement copy to clipboard
:::
@@ -24,50 +20,48 @@ You can copy a file/folder location path into your clipboard by right-clicking i
You can cut files by right-clicking it and click the `Cut` option or select the file then press `Ctrl + X` as a shortcut and paste it by clicking the `Paste` option or press `Ctrl + V` on the destination folder.
-:::info This is done by creating a string of Xplorer command and copies it into the user clipboard to be used when pasting file (this is not integrated with the platform because we haven't found any idea, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.). The string of Xplorer command looks like this:
+:::info
-```
-Xplorer command - CUT
-E://xplorer
-E://test
-```
+For current implementation, Xplorer write down what to cut locally (not copying to clipboard).
:::
## Удаление файлов
-You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut. The trashed file can be accessed at `xplorer://Trash`.
+You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut.
-:::info
+### Trashed files
-- On Windows, this is done by creating a `Trash` folder on the `C:` drive and moving the file into it.
-- On Linux, this feature is fully integrated with the system.
-- В MacOS это делается путем создания папки `.local/Trash` в `homedir` и перемещения в неё файла.
+The trashed file can be accessed at `xplorer://Trash` or your system trash folder. :::danger Open Issue
-We are still working on Windows on macOS to integrate the `Trash` folder, which will be released before the stable version came out. Feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.
+Please note that Trash folder cannot be accessed on macos via Xplorer since the [trash crate](https://github.com/Byron/trash-rs) Xplorer relies to does not support it (see [this issue](https://github.com/Byron/trash-rs/issues/8) for more details).
-:::
+Any contributions to either the trash crate or Xplorer itself for this topic are welcome. :::
+
+### Restore files
+
+You can restore files by opening the `xplorer://Trash` and right-clicking it and click the `Restore` option
-### Удалить безвозвратно
+### Permanently delete
-:::danger A permanently deleted file cannot be restored. Пожалуйста, проверьте ещё раз перед тем, как удалить файл.
+:::danger A permanently deleted file cannot be restored. Please check again before permanently delete any files.
:::
-Вы можете навсегда удалить файл следующими способами:
+You can permanently delete a file by:
1. Delete it into `Trash` and right-clicking it and click the `Permanent Delete` option
2. Select the file and press `Shift + Del` as a shortcut
## Создать
-:::caution Будьте осторожны с именем файла/папки Xplorer обрабатывает `/` в имени файла или папки как подпапку/подфайл :::
+:::caution Be careful with new file/folder name Xplorer treats `/` on file name/folder as subdir/subfile :::
-### Файл
+### New file
You can create a new file by right-clicking the workspace, expand the `New` option and select the `file` option, or press `Alt + N` as a shortcut.
-### Папку
+### New folder
You can create a new folder by right-clicking the workspace, expand the `New` option and select the `folder` option, or press `Shift + N` as a shortcut.
@@ -75,13 +69,13 @@ You can create a new folder by right-clicking the workspace, expand the `New` op
You can open a file on the default application by double-clicking it or select the file then press `Enter` as a shortcut.
-### Открыть в терминале
+### Open in Terminal
This is a built-in function by Xplorer. You can open a folder on Terminal by right-clicking it and click the `Open in terminal` option or select the folder then press `Alt + T` as a shortcut.
-### Открыть в VS Code
+### Open in VSCode
-This is a built-in function by Xplorer. You can open a file/folder on VSCode by right-clicking it and click the `Open in vscode` option or select the file then press `Ctrl + Enter` as a shortcut. Вы не сможете это сделать, если у вас не установлен VS Code.
+This is a built-in function by Xplorer. You can open a file/folder on VSCode by right-clicking it and click the `Open in vscode` option or select the file then press `Ctrl + Enter` as a shortcut. You won't able to do this if you don't have VSCode installed.
## Закрепить в боковой панели
@@ -91,80 +85,21 @@ You can pin a file/folder into the sidebar by right-clicking it and click `Pin t
You can preview a file directly from Xplorer by right-clicking it and click the `Preview` option or select the file then press `Ctrl+O`.
-
+
:::info
-Файлы, доступные для предварительного просмотра:
+Files available to preview for now:
-```json
-[
- ".pdf",
- ".html",
- ".docx",
- ".htm",
- ".xlsx",
- ".xls",
- ".xlsb",
- "xls",
- ".ods",
- ".fods",
- ".csv",
- ".txt",
- ".py",
- ".js",
- ".bat",
- ".css",
- ".c++",
- ".cpp",
- ".cc",
- ".c",
- ".diff",
- ".patch",
- ".go",
- ".java",
- ".json",
- ".php",
- ".ts",
- ".tsx",
- ".jsx",
- ".jpg",
- ".png",
- ".gif",
- ".bmp",
- ".jpeg",
- ".jpe",
- ".jif",
- ".jfif",
- ".jfi",
- ".webp",
- ".tiff",
- ".tif",
- ".ico",
- ".svg",
- ".webp",
- ".mp4",
- ".webm",
- ".mpg",
- ".mp2",
- ".mpeg",
- ".mpe",
- ".mpv",
- ".ocg",
- ".m4p",
- ".m4v",
- ".avi",
- ".wmv",
- ".mov",
- ".qt",
- ".flv",
- ".swf",
- ".md"
-]
-```
+* Markdown files
+* Image files
+* Text files
+* Video files
+* Pdfs
+* Almost all programming language with syntax highlighting
@@ -172,7 +107,7 @@ You can preview a file directly from Xplorer by right-clicking it and click the
## Свойства
-You can view properties of a file/folder by right-clicking it and click `Properties` or select the file then press `Ctrl + P` as a shortcut. На данный момент доступны следующие свойства (список дополнится в будущих версиях):
+You can view properties of a file/folder by right-clicking it and click `Properties` or select the file then press `Ctrl + P` as a shortcut. Available properties for now (will be improved at the next version):
- Размер
- Путь к файлу
@@ -183,4 +118,4 @@ You can view properties of a file/folder by right-clicking it and click `Propert
## Переименовать файл/папку
-You can rename a file/folder by right-clicking it and click the `Rename` option or select the file then press `F2` as a shortcut. Появится диалоговое окно. Введите новое имя файла/папки, которую хотите переименовать.
+You can rename a file/folder by right-clicking it and click the `Rename` option or select the file then press `F2` as a shortcut. It will prompt a dialog, enter the new name and the file/folder will be renamed.
diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/setting.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/setting.md
index e19adc6f..515e4843 100644
--- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/setting.md
+++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/setting.md
@@ -12,33 +12,67 @@
How to exit from Settings?
-You can exit from Settings on Xplorer by clicking the Arrow Up button on the upside left of Xplorer.
+You can exit from Settings on Xplorer by clicking on the upside left of Xplorer.
-## Тема приложения
+## Appearance
+
+### App Theme
Вы можете изменить тему приложения Xplorer во вкладке `Внешний вид` в настройках. Доступные по умолчанию темы: `light`, `light+`, `dark`, и `dark+`. Besides, there is a `System Default` theme that will automatically read your system preference. :::info Xplorer will support a custom app theme soon, stay tuned! :::
-### Акриловый эффект
+### Font Family
+
+You can change Xplorer's font family on the `Appearance` tab of the Settings to one of installed font families installed on your system.
+
+### Font Size
+
+You can change Xplorer's font size on the `Appearance` tab of the Settings. Please note that an ideal font size is between 10px to 30px.
+
+### Window Transparency
+
+Make Xplorer window transparent on the `Appearance` tab of the Settings by combining following options. Please note that an ideal transparency is between 70% to 100%. You can disable transparency by disable all of the transparency options.
+
+#### Transparent Sidebar
+
+Make the sidebar transparent 
+
+#### Transparent Topbar
+
+Make the topbar transparent 
+
+#### Transparent Workspace
+
+make the workspace transparent 
+
+### Frame Style
+
+You can choose the frame style on the `Appearance` tab of the Settings. The available options are `Default` and `System Default`. `Default` will use Xplorer's default style which is the same across platforms. `System Default` will use the system default frame style which is difference according to your platform.
-The Acrylic Effect is the effect that gives the transparency effect on the sidebar. Работает только на Windows 10 и выше.
+### File Preview
-## Предпросмотр файла
+File Preview here might means the file thumbnail.
-Предпросмотр файла здесь означает предварительный просмотр, который заменяет значок файла по умолчанию.
+#### Automatically play video file as thumbnail
-### Play video file as a preview
+This will automatically play the video file as a preview. :::caution THIS MIGHT CONSUME HIGH AMOUNT OF RAM This might consume a high amount of RAM because it's built on the HTML video player. You can just enable this setting and ignore this caution if you got a good-spec computer. :::
-This will automatically play the video file as a preview. :::caution THIS MIGHT CONSUME HIGH AMOUNT OF RAM This might consume a high amount of RAM because it's built on the HTML video player. Вы можете включить этот параметр и проигнорировать предупреждение, если у вас хороший компьютер. :::
+#### Preview image on hover
-### Extract `EXE` file icon and make it a preview
+This fill automatically show the image when you hovering it for 500ms.
-This will parse and cache the icon from a `exe` file and make it a preview. Только на Windows.
+
-
+Some people might found it annoying and you can disable it by disabling this setting.
+
+#### Extract exe file icon and make it as the thumbnail
+
+This will parse and cache the icon from a `exe` file and make it a preview. Only on Windows.
+
+
:::warning This might causes Xplorer to crash.
@@ -48,22 +82,43 @@ The way to fix it is to disable the setting.
:::
-## Стандартное отображение файлов
+:::info Open issue The current approach is by calling the powershell program which might pops up cmd windows.
+
+Any contribution to call it directly from Xplorer is welcome. :::
+
+#### Show Image as Thumbnail
+
+This will show the image as a thumbnail of a file. Please note that this is not recommended for large directory as it reads the image to memory.
+
+#### Default file layout
Default file layout of a directory. Just give it a try :)
-## Язык приложения
+## Preference
+
+### App Language
Localize Xplorer. Help us translate Xplorer [here](https://github.com/kimlimjustin/xplorer/discussions/30).
-## Выключить показ скрытых файлов
+### Hide Hidden Files
Hide hidden files on Xplorer, you can find this setting on the `Preference` tab on Xplorer or by its shortcut, `Ctrl + H`.
-## Выключить показ системных файлов
+### Hide System Files
Hide Windows' system files on Xplorer. :::tip Learn what is system file [here](https://en.wikipedia.org/wiki/System_file). Just turn it off if you don't understand what it is. :::
-## List and sort directories alongside files
+### List and sort directories alongside files
If disabled, Xplorer will prioritize directories above files.
+
+### Detect Drive Change
+
+Turning this on will detect drive change and update the sidebar and drives section. Please note that this will take high ammount of RAM as this is not stabilized yet.
+
+### On startup
+
+Option to do on starting Xplorer. Available options are:
+
+- New Tab
+- Continue previous session
diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/shortcut.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/shortcut.md
index 7caff018..d7ed792f 100644
--- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/shortcut.md
+++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/shortcut.md
@@ -1,35 +1,38 @@
# Горячие клавиши
-| Клавиша | Описание |
-| ------------------- | ------------------------------- |
-| `Ctrl + A` | Выбрать всё |
-| `Ctrl + C` | Копировать |
-| `Ctrl + E` | Закрыть вкладку |
-| `Ctrl + H` | Вкл./выкл. показ скрытых файлов |
-| `Ctrl + O` | Предпросмотр файла |
-| `Ctrl + P` | Свойства файлов и папок |
-| `Ctrl + R` | Перезагрузить |
-| `Ctrl + T` | Новая вкладка |
-| `Ctrl + V` | Вставить |
-| `Ctrl + X` | Вырезать |
-| `Ctrl + W` | Выйти из Xplorer |
-| `Alt + Left Arrow` | Назад |
-| `Alt + Right Arrow` | Вперёд |
-| `Alt + Up Arrow` | развернуть |
-| `Alt + Down Arrow` | свернуть |
-| `Alt + T` | Открыть в терминале |
-| `Alt + P` | Закрепить в боковой панели |
-| `Alt + Shift + C` | Скопировать путь |
-| `F2` | Переименовать |
-| `F5` | Обновить |
-| `F10` | Свернуть |
-| `F11` | Развернуть |
-| `Shift + N` | Новая папка |
-| `Shift + Del` | Удалить навсегда |
-| `Shift + Enter` | Открыть в vscode |
-| `Enter` | Открыть |
-| `Del` | Удалить файл |
+| Клавиша | Описание |
+| ------------------- | ----------------------- |
+| `Ctrl + A` | Выбрать всё |
+| `Ctrl + C` | Копировать |
+| `Ctrl + H` | Toggle Hidden Files |
+| `Ctrl + N` | New window shortcut |
+| `Ctrl + O` | Open file in preview |
+| `Ctrl + P` | Свойства файлов и папок |
+| `Ctrl + R` | Перезагрузить |
+| `Ctrl + T` | Новая вкладка |
+| `Ctrl + V` | Вставить |
+| `Ctrl + X` | Вырезать |
+| `Ctrl + W` | Exit Tab |
+| `Ctrl + Y` | Redo |
+| `Ctrl + Z` | Undo |
+| `Ctrl + Shift + Z` | Redo |
+| `Alt + Left Arrow` | Go Back |
+| `Alt + Right Arrow` | Go Forward |
+| `Alt + Up Arrow` | Go to parent directory |
+| `Alt + N` | New File |
+| `Alt + T` | Open in terminal |
+| `Alt + P` | Pin to sidebar |
+| `Alt + Shift + C` | Copy location path |
+| `F2` | Rename |
+| `F5` | Refresh |
+| `F10` | Minimize |
+| `F11` | Maximize |
+| `Shift + N` | New Folders |
+| `Shift + Del` | Permanent Delete |
+| `Shift + Enter` | Open in vscode |
+| `Enter` | Open |
+| `Del` | Delete file |
-::note Разница между `перезагрузкой` и `обновлением` `Перезагрузка` обновляет внутренний HTML, а `Обновление` обновляет весь процесс Electron.
+:::note Difference between `reload` and `refresh` `Reload` refreshes the internal process while `Refresh` refreshes the whole process.
:::
diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/xplorer as default.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
index 8511471c..d725f87e 100644
--- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
+++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
@@ -12,7 +12,7 @@
4. Перейдите в `Компьютер\HKEY_CURRENT_USER\Software\Classes\Directory`
5. Create a key named `shell` if not existed by right and set the default key-value to `openinxplorer`
6. Создайте раздел `openinxplorer` под `shell`
-7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Users\User\AppData\Local\Programs\Microsoft VS Code\Code.exe" "%V"`
+7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Program Files\Xplorer\Xplorer.exe" "%V"`. (You may have to change `C:\Program Files\Xplorer\` to the location you installed Xplorer)
diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/intro.md b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/intro.md
index 86640b3a..ccc281a6 100644
--- a/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/intro.md
+++ b/docs/i18n/ru-RU/docusaurus-plugin-content-docs/current/intro.md
@@ -8,14 +8,18 @@ sidebar_position: 1
Welcome to Xplorer, A Free and Open Source (FOSS) File Explorer.
-Xplorer is a file explorer built from the ground up to be fully customizable and without customization, it also looks modern! It is cross-platform, built using Electron Technology that allowed our File Explorer to be run not only in Windows but also Linux and MacOS alike. It also allowed file preview directly inside it, not only pictures or documents but also videos!
+Xplorer is a file explorer built from ground-up to be fully customizable. And even without any customization, it already looks modern!
-## Особенности
+Xplorer is a cross-platform application built using [Tauri](https://tauri.studio), and you can run it on Windows, MacOS, or Linux without having much trouble. One of the key feature is Xplorer allows you to preview the files you have directly inside Xplorer. And it's not only limited to picture or document preview, but also video preview.
-So to summarize, Xplorer's features contain:
+To summarize, Xplorer's features contain:
-- Современный внешний вид
+- It looks modern
- Простоту использования
- Кроссплатформенность
-- Предпросмотр файлов, и даже видео!
-- И самое главное, он бесплатный и с открытым исходным кодом! Which mean you can change components inside if you see fit and you also don't need to make your wallet go dry or break the bank.
+- [File Preview](https://xplorer.vercel.app/docs/guides/operation/#preview-file), even for videos!
+- Customizable
+- Supports multiple tab
+- Most importantly, Free and Open Source Software(FOSS), which means you can change components inside if you see fit
+
+Xplorer is currently under heavy development. You can give your suggestions and feedbacks in our [Discussions](https://github.com/kimlimjustin/xplorer/discussions/) page. If you feel comfortable in writing code using Typescript and Rust, we highly encourage you to [contribute to this project](https://xplorer.vercel.app/community/Contributing/).
diff --git a/docs/i18n/ru-RU/docusaurus-plugin-content-pages/index.jsx b/docs/i18n/ru-RU/docusaurus-plugin-content-pages/index.jsx
index a3df6202..38990cae 100644
--- a/docs/i18n/ru-RU/docusaurus-plugin-content-pages/index.jsx
+++ b/docs/i18n/ru-RU/docusaurus-plugin-content-pages/index.jsx
@@ -5,102 +5,69 @@ import Slideshow from './slideshow';
import Link from '@docusaurus/Link';
export default function Home() {
- const { siteConfig } = useDocusaurusContext();
- return (
-
-
-
-
-
File Explorer.
-
Redefined.
-
- Free and Open Source Software. Runs everywhere.
-
+ Cross-platform File Explorer. Powered by the web.
+
+
+ Built using the{' '}
+
+ Tauri Framework
+ {' '}
+ , and written using{' '}
+
+ TypeScript
+ {' '}
+ for the frontend and{' '}
+
+ Rust
+ {' '}
+ for the backend, Xplorer promises you an unprecedented experience.
+
+
+
+
+
Designed out of the box
+
Say goodbye to the old design by traditional app and say hello to this simple yet powerful design.
+
+
+
+
Supports Multiple Tabs
+
Xplorer helps you organize you files easier by supporting multiple tabs .
+
+
+
+
File Preview
+
+ Xplorer supports files preview, from images, code preview, pdfs, to videos. Learn more{' '}
+ here.
+
+
+ );
}
diff --git a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/Community/Contributing.md b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/Community/Contributing.md
new file mode 100644
index 00000000..be326698
--- /dev/null
+++ b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/Community/Contributing.md
@@ -0,0 +1,173 @@
+---
+sidebar_position: 2
+---
+
+# Contribute
+
+👍🎉 First off, thanks for taking the time to contribute! 🎉👍
+
+Xplorer is currently under heavy development. We are welcoming contributors to collaborate on Xplorer.
+
+## Get involved
+
+There are many ways to contribute to Xplorer, and many of them do not involve writing any code. Here are few ideas to get started:
+
+- Start using Xplorer! Go through the Tutorial guides. Does anything work as expected? If not, we're always looking for improvements. Let us know by opening an issue.
+- Look through the [Xplorer issues](https://github.com/kimlimjustin/xplorer/issues). If you find an issue you would like to fix, [open a pull request](#first-pull-request). Issues tagged as [good first issue](https://github.com/kimlimjustin/xplorer/labels/good%20first%20issue) are a good place to get started.
+- Help us make the docs better. File an issue if you find anything that is confusing, any grammatical error, or can be improved.
+- Take a look at [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) and give your opinion into a discussion or consider opening a pull request if you see something you want to work on.
+
+Contributions are very welcome!
+
+## Our development process
+
+Xplorer uses [GitHub](https://github.com/kimlimjustin/xplorer) as its source of truth. The core team will work directly there. All changes will be public from the beginning.
+
+### Reporting new issues/bugs. {#issues}
+
+When [opening a new issue](https://github.com/kimlimjustin/xplorer/issues), always make sure to fill out the issue template. We use GitHub issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue.
+
+- _One issue, one bug_: Please report a single bug per issue.
+- _Provide reproduction steps_: List all the steps necessary to reproduce the issue. The person reading your bug report should be able to follow these steps to reproduce your issue with minimal effort.
+
+### Feature Request {#feat}
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) and [GitHub Issues](https://github.com/kimlimjustin/xplorer) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional references like images, links of resources about the feature, etc.
+
+## Working on Xplorer code
+
+### Prerequisite
+
+- [Tauri environment](https://tauri.studio/en/docs/getting-started/intro#setting-up-your-environment)
+- [Node JS](https://nodejs.org/en/)
+- [Git](https://git-scm.com/)
+- [yarn](https://yarnpkg.com/)
+- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
+
+### Installation
+
+1. After cloning the repository, run `yarn` in the root of the repository and run `yarn` in the `docs` folder (if you want to working on Xplorer Docs).
+2. To start Xplorer locally, run `yarn dev`.
+
+ To start a local development server serving the Docusaurus docs, go into the `docs` directory and run `yarn start`
+
+### Gitpod {#gitpod-env}
+
+Gitpod is a Ready-to-Code environment in which you can get started immediately. Gitpod offers all dependencies pre-installed so you can just click and get started.
+
+To get started with Gitpod, click the button below and log in with your GitHub account.
+
+[](https://gitpod.io/#https://github.com/kimlimjustin/xplorer)
+
+:::note Remember to reload the Gitpod website after it loads up since it won't start the servers immediately, but by reloading, you can get it started. If you are developing the app, go to the Remote Explorer on the sidebar and visit port _6080_ which opens the noVNC app server. If you are developing the docs, go to the Remote explorer but instead of port 6080, visit port _3000_. You can edit normally as you do in VS Code, but if you want to use it locally, clik the hamburger menu button and click _Open in VS Code_. :::
+
+### Semantic commit messages {#commit-msg}
+
+See how a minor change to your commit message style can make you a better programmer.
+
+Format: `(): `
+
+`` is optional
+
+#### Example
+
+```
+feat: allow overriding of webpack config
+^--^ ^------------^
+| |
+| +-> Summary in present tense.
+|
++-------> Type: chore, docs, feat, fix, refactor, style, or test.
+```
+
+the various types of commits:
+
+- `feat`: new feature for the user
+- `fix`: bug fix for the user
+- `docs`: changes to the documentation
+- `style`: formatting, missing semi-colons, etc.
+- `refactor`: refactoring production code, eg. renaming a variable
+- `test`: adding missing tests, refactoring tests.
+- `chore`: updating grunt tasks etc
+
+Use lower case not the upper case!
+
+## Working on Xplorer docs
+
+Xplorer documentation website is built using [Docusaurus 2](https://docusaurus.io/), and its code is located at [`docs`](https://github.com/kimlimjustin/xplorer/tree/master/docs) folder.
+
+### Prerequisite
+
+- [node js](https://nodejs.org/en/)
+- [git](https://git-scm.com/downloads)
+- [yarn](https://yarnpkg.com/getting-started/install#about-global-installs)
+- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
+
+### Installation
+
+After cloning the repository, run `yarn` in the `docs` folder (you can go into the `docs` folder by running the `cd docs` command).
+
+If you want to use Gitpod, click [here](#gitpod-env) for the guide on how to use Gitpod.
+
+### Local development
+
+1. Run the `yarn start` command in the `docs` folder.
+2. Edit some markdown texts in the `docs` folder and the website will be hot reloaded.
+
+## Pull requests
+
+### Your first pull request. {#first-pull-request}
+
+So you have decided to contribute code back to upstream by opening a pull request. You've invested a good chunk of time, and we appreciate it. We will do our best to work with you and get the PR looked at.
+
+Working on your first Pull Request? You can learn how from this free video series:
+
+How to Contribute to an Open Source Project on GitHub
+
+We have a list of [beginner-friendly issues](https://github.com/kimlimjustin/xplorer/labels/good%20first%20issue) to help you get your feet wet in the Xplorer codebase and familiar with our contribution process. This is a great place to get started.
+
+### Proposing a change
+
+If you would like to request a new feature or enhancement but are not yet thinking about opening a pull request, you can also [open a discussion](#feat) and others will code it!
+
+If you intend to fix a bug, please discuss it through [Issues](#issues) before submitting a pull request.
+
+If you intend to add a new feature, please discuss it through [GitHub Discussions](#feat) to avoid multiple people working on the same feature request.
+
+### Sending a Pull Request
+
+make sure the PR does only one thing, otherwise please split it. It is recommended to follow this [commit message style](#commit-msg).
+
+1. Fork [the repository](https://github.com/kimlimjustin/xplorer) and create your branch from `master`.
+2. Make changes and ensure your commit message is understandable.
+3. Open a [PR](https://github.com/kimlimjustin/xplorer/pulls) and ensure to describe your pull request clearly.
+
+## Working on Xplorer resources
+
+### Locales
+
+We host our locales on the [crowdin](https://crwd.in/xplorer). To translate it, please follow these steps:
+
+- Sign up on [Crowdin](https://crowdin.com) and Join our project [here](https://crwd.in/xplorer).
+- Make sure your locale exists there, if it does not exist, leave a comment in [this discussion](https://github.com/kimlimjustin/xplorer/discussions/30) and I'll add the language option :)
+- Get familiar with the Crowdin translation UI, as you will need to use it to translate JSON and Markdown files
+- Translate the content!
+
+#### Priority Files to translate on Crowdin
+
+1. `src/Locales` files
+2. `docs/` files
+
+#### Production
+
+Once the files on `src/Locales` have been translated for more than 80%, we will add it into the Xplorer app, and for the docs, we will add it into production once the translation looks good!
+
+Please comment [here](https://github.com/kimlimjustin/xplorer/discussions/30) if you have any questions!
+
+### File Library
+
+The json library of file types and thumbnail are found under `lib` folder and the icons are found under `src/Icons` folder. You may add file types and icons for file extensions you want to use and submit a PR.
diff --git a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/Community/support.md b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/Community/support.md
new file mode 100644
index 00000000..8ea01be3
--- /dev/null
+++ b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/Community/support.md
@@ -0,0 +1,42 @@
+---
+sidebar_position: 1
+---
+
+# Support
+
+Xplorer is an open-source project which you can freely join and seek support 😊.
+
+On this page, we've listed some communities/forums you can participate in to seek support or help others.
+
+Before participating in Xplorer's communities, please read our [Code Of Conduct](/docs/community/CODE_OF_CONDUCT/).
+
+## Issues
+
+We use GitHub Issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue. Report a bug by opening a new issue [here](https://github.com/kimlimjustin/xplorer/issues/new).
+
+## GitHub Discussions
+
+GitHub Discussions is used for multiple purposes, such as:
+
+1. Asking questions
+2. Making feature requests and sharing ideas
+3. Chat on Xplorer
+4. Show and tell: Making custom themes/plug-ins for Xplorer and showing them there!
+
+### Feature Request
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussion) and [GitHub Issues](https://github.com/kimlimjustin/xplorer/issues) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional context like images, links to resources to implement the feature, etc.
+
+### Help
+
+You can ask for help using [GitHub Discussion](https://github.com/kimlimjustin/xplorer/discussions) or [Discord Channel](https://discord.gg/kK7rwxPt).
+
+:::note Remember to choose the discussion category as Q&A so that your question will be published with answers enabled. :::
+
+## News
+
+For the latest news about Xplorer, you can see it through posts on [Forem](https://dev.to/t/xplorer).
diff --git a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/common_problems.md b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/common_problems.md
index 0329306c..ebdcac5f 100644
--- a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/common_problems.md
+++ b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/common_problems.md
@@ -1,3 +1,7 @@
+- - -
+sidebar_position: 3
+- - -
+
# Common Problems
**NB: For common problems during installation, please open [here](/docs/install/#common-problems)**
@@ -5,25 +9,6 @@
-### Xplorer keep loading and crashes.
-
-
-
-Try opening `cmd` by opening Win + R(Run) and type `cmd`.
-
-Enter following command:
-
-```
-wmic
-```
-
-If the output says the `wmic` is not recognized as internal or internal command, please follow the following steps given on [this](https://superuser.com/questions/1178674/wmic-is-not-recognized-as-an-internal-or-external-command-operable-program-or) or [this](https://knowledge.informatica.com/s/article/156865?language=en_US). Also, please make sure that Windows Defender isn't blocking Xplorer from accessing your documents.
-
-
-
-
-
-
### Opening folder like `Documents`, `Desktop`, `Downloads` make Xplorer crashes
diff --git a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/_category_.json b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/_category_.json
index 9154734a..a9722bc2 100644
--- a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/_category_.json
+++ b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/_category_.json
@@ -1,4 +1,4 @@
{
- "label": "Руководства",
- "position": 3
-}
\ No newline at end of file
+ "label": "Руководства",
+ "position": 4
+}
diff --git a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/cli.md b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/cli.md
index f827585c..08b86ec4 100644
--- a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/cli.md
+++ b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/cli.md
@@ -1,7 +1,5 @@
# Запуск Xplorer из терминала
-:::info This feature hasn't been optimized yet. It works but it might be laggy. This will be optimized in the feature release. :::
-
## Команды
Xplorer CLI:
@@ -12,26 +10,8 @@ xplorer [dir1] [dir2] [dir3]
Xplorer will open `dir`, `dir2`, `dir3` as tabs on Xplorer. If there's no directory(dir) passed into the command, Xplorer will start at the Home page.
-Параметры:
-
-| Команда | Сокращение | Описание |
-| ----------- | ---------- | ----------------------------------------- |
-| `--help` | `-h` | Справка |
-| `--version` | `-v` | Показать номер версии |
-| `--reveal` | `-r` | Открыть папку с содержимым и выбрать файл |
-
-
-
-xplorer: command not found ошибка в Windows
-
-
-Для начала вы должны зарегистрировать команду в системный путь.
-
-1. Open the `System Properties` on Windows.
-2. Click the `Environment Variables` button, it will popup a window.
-3. On the table, search for `Path` variable and click on it.
-4. Click `Edit` button, it will popup a window.
-5. Click `New` button
-6. Add `%USERPROFILE%\AppData\Local\Programs\xplorer`
+Options:
-
+| Команда | Сокращение | Описание |
+| ---------- | ---------- | ---------------------------------------------- |
+| `--reveal` | `-r` | Open the containing folder and select the file |
diff --git a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/operation.md b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/operation.md
index 08de8361..5683f722 100644
--- a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/operation.md
+++ b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/operation.md
@@ -6,47 +6,41 @@ You can copy files by right clicking it and click `Copy` option or select the fi
:::info
-On Windows and macOS, Xplorer will copy the file paths into the local clipboard, because of this, you can copy a file from Xplorer and paste it into any folder in another system. However, on Linux, we create a string of Xplorer commands and copy it into the user clipboard, Xplorer will read the user's clipboard when pasting the file (because we haven't found any idea to implement it, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us). The string of the Xplorer command looks like this:
+For current implementation, Xplorer write down what to copy locally (not copying to clipboard).
-```
-Xplorer command - COPY
-~/xplorer
-~/test
-```
+TODO: implement copy to clipboard
:::
## Copy Location Path
-You can copy a file/folder location path into your clipboard by right clicking it and click `Copy Location Path` or select the file then press `Alt + Shift + C` as shortcut.
+You can copy a file/folder location path into your clipboard by right-clicking it and click `Copy Location Path` or select the file then press `Alt + Shift + C` as a shortcut.
## Cut files
-You can cut files by right clicking it and click `Cut` option or select the file then press `Ctrl + X` as shortcut and paste it by clicking `Paste` option or press `Ctrl + V` on the destination folder.
+You can cut files by right-clicking it and click the `Cut` option or select the file then press `Ctrl + X` as a shortcut and paste it by clicking the `Paste` option or press `Ctrl + V` on the destination folder.
-:::info This is done by creating a string of Xplorer command and copies it into the user clipboard to be used when pasting file (this is not integrated with the platform because we haven't found any idea, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.). The string of Xplorer command looks like this:
+:::info
-```
-Xplorer command - CUT
-E://xplorer
-E://test
-```
+For current implementation, Xplorer write down what to cut locally (not copying to clipboard).
:::
## Delete files
-You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut. The trashed file can be accessed at `xplorer://Trash`.
+You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut.
-:::info
+### Trashed files
-- On Windows, this is done by creating a `Trash` folder on `C:` drive and moving the file into it.
-- On Linux, this feature is fully integrated with the sytem
-- On macOS, this is done by creating a `.local/Trash` folder on `homedir` and moving the file into it.
+The trashed file can be accessed at `xplorer://Trash` or your system trash folder. :::danger Open Issue
-We are still working on Windows on macOS to integrate the `Trash` folder, which will be released before the stable version came out. Feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.
+Please note that Trash folder cannot be accessed on macos via Xplorer since the [trash crate](https://github.com/Byron/trash-rs) Xplorer relies to does not support it (see [this issue](https://github.com/Byron/trash-rs/issues/8) for more details).
-:::
+Any contributions to either the trash crate or Xplorer itself for this topic are welcome. :::
+
+### Restore files
+
+You can restore files by opening the `xplorer://Trash` and right-clicking it and click the `Restore` option
### Permanently delete
@@ -65,15 +59,15 @@ You can permanently delete a file by:
### New file
-You can create a new file by right clicking the workspace, expand the `New` option and select `file` option or press `Alt + N` as shortcut.
+You can create a new file by right-clicking the workspace, expand the `New` option and select the `file` option, or press `Alt + N` as a shortcut.
### New folder
-You can create a new folder by right clicking the workspace, expand the `New` option and select `folder` option or press `Shift + N` as shortcut.
+You can create a new folder by right-clicking the workspace, expand the `New` option and select the `folder` option, or press `Shift + N` as a shortcut.
## Open file
-You can open a file on default application by double-clicking it or select the file then press `Enter` as shortcut.
+You can open a file on the default application by double-clicking it or select the file then press `Enter` as a shortcut.
### Open in Terminal
@@ -85,11 +79,11 @@ This is a built-in function by Xplorer. You can open a file/folder on VSCode by
## Pin to Sidebar
-You can pin a file/folder into sidebar by right clicking it and click `Pin to Sidebar` or select the file then press `Alt + P` as shortcut.
+You can pin a file/folder into the sidebar by right-clicking it and click `Pin to Sidebar` or select the file then press `Alt + P` as a shortcut.
## Preview file
-You can preview a file directly from Xplorer by right-clicking it and click `Preview` otioin or select the file then press `Ctrl+O`.
+You can preview a file directly from Xplorer by right-clicking it and click the `Preview` option or select the file then press `Ctrl+O`.
@@ -100,71 +94,12 @@ You can preview a file directly from Xplorer by right-clicking it and click `Pre
Files available to preview for now:
-```json
-[
- ".pdf",
- ".html",
- ".docx",
- ".htm",
- ".xlsx",
- ".xls",
- ".xlsb",
- "xls",
- ".ods",
- ".fods",
- ".csv",
- ".txt",
- ".py",
- ".js",
- ".bat",
- ".css",
- ".c++",
- ".cpp",
- ".cc",
- ".c",
- ".diff",
- ".patch",
- ".go",
- ".java",
- ".json",
- ".php",
- ".ts",
- ".tsx",
- ".jsx",
- ".jpg",
- ".png",
- ".gif",
- ".bmp",
- ".jpeg",
- ".jpe",
- ".jif",
- ".jfif",
- ".jfi",
- ".webp",
- ".tiff",
- ".tif",
- ".ico",
- ".svg",
- ".webp",
- ".mp4",
- ".webm",
- ".mpg",
- ".mp2",
- ".mpeg",
- ".mpe",
- ".mpv",
- ".ocg",
- ".m4p",
- ".m4v",
- ".avi",
- ".wmv",
- ".mov",
- ".qt",
- ".flv",
- ".swf",
- ".md"
-]
-```
+* Markdown files
+* Image files
+* Text files
+* Video files
+* Pdfs
+* Almost all programming language with syntax highlighting
diff --git a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/setting.md b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/setting.md
index 2afc6c84..e48188a6 100644
--- a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/setting.md
+++ b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/setting.md
@@ -12,29 +12,63 @@ You can open settings on Xplorer by clicking the `Settings` button on the left d
How to exit from Settings?
-You can exit from Settings on Xplorer by clicking the Arrow Up button on the upside left of Xplorer.
+You can exit from Settings on Xplorer by clicking on the upside left of Xplorer.
-## App Theme
+## Appearance
+
+### App Theme
You can change Xplorer's app theme on the `Appearance` tab of the Settings. Available default themes are `light`, `light+`, `dark`, and `dark+`. Besides, there is a `System Default` theme that will automatically read your system preference. :::info Xplorer will support a custom app theme soon, stay tuned! :::
-### Acrylic Effect
+### Font Family
+
+You can change Xplorer's font family on the `Appearance` tab of the Settings to one of installed font families installed on your system.
+
+### Font Size
+
+You can change Xplorer's font size on the `Appearance` tab of the Settings. Please note that an ideal font size is between 10px to 30px.
+
+### Window Transparency
+
+Make Xplorer window transparent on the `Appearance` tab of the Settings by combining following options. Please note that an ideal transparency is between 70% to 100%. You can disable transparency by disable all of the transparency options.
+
+#### Transparent Sidebar
-The Acrylic Effect is the effect that gives the transparency effect on the sidebar. Only works on Windows 10 and higher.
+Make the sidebar transparent 
-## File Preview
+#### Transparent Topbar
-The file preview here means the preview that replaces the default icon of a file.
+Make the topbar transparent 
-### Play video file as preview
+#### Transparent Workspace
+
+make the workspace transparent 
+
+### Frame Style
+
+You can choose the frame style on the `Appearance` tab of the Settings. The available options are `Default` and `System Default`. `Default` will use Xplorer's default style which is the same across platforms. `System Default` will use the system default frame style which is difference according to your platform.
+
+### File Preview
+
+File Preview here might means the file thumbnail.
+
+#### Automatically play video file as thumbnail
This will automatically play the video file as a preview. :::caution THIS MIGHT CONSUME HIGH AMOUNT OF RAM This might consume a high amount of RAM because it's built on the HTML video player. You can just enable this setting and ignore this caution if you got a good-spec computer. :::
-### Extract `EXE` file icon and make it as preview
+#### Preview image on hover
+
+This fill automatically show the image when you hovering it for 500ms.
+
+
+
+Some people might found it annoying and you can disable it by disabling this setting.
+
+#### Extract exe file icon and make it as the thumbnail
This will parse and cache the icon from a `exe` file and make it a preview. Only on Windows.
@@ -48,22 +82,43 @@ The way to fix it is to disable the setting.
:::
-## Default file layout
+:::info Open issue The current approach is by calling the powershell program which might pops up cmd windows.
+
+Any contribution to call it directly from Xplorer is welcome. :::
+
+#### Show Image as Thumbnail
+
+This will show the image as a thumbnail of a file. Please note that this is not recommended for large directory as it reads the image to memory.
+
+#### Default file layout
Default file layout of a directory. Just give it a try :)
-## App Language
+## Preference
+
+### App Language
Localize Xplorer. Help us translate Xplorer [here](https://github.com/kimlimjustin/xplorer/discussions/30).
-## Hide Hidden Files
+### Hide Hidden Files
Hide hidden files on Xplorer, you can find this setting on the `Preference` tab on Xplorer or by its shortcut, `Ctrl + H`.
-## Hide System Files
+### Hide System Files
Hide Windows' system files on Xplorer. :::tip Learn what is system file [here](https://en.wikipedia.org/wiki/System_file). Just turn it off if you don't understand what it is. :::
-## List and sort directories alongside with files
+### List and sort directories alongside files
If disabled, Xplorer will prioritize directories above files.
+
+### Detect Drive Change
+
+Turning this on will detect drive change and update the sidebar and drives section. Please note that this will take high ammount of RAM as this is not stabilized yet.
+
+### On startup
+
+Option to do on starting Xplorer. Available options are:
+
+- New Tab
+- Continue previous session
diff --git a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/shortcut.md b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/shortcut.md
index ee867ac2..d7ed792f 100644
--- a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/shortcut.md
+++ b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/shortcut.md
@@ -1,35 +1,38 @@
# Горячие клавиши
-| Клавиша | Описание |
-| ------------------- | ------------------------------- |
-| `Ctrl + A` | Выбрать всё |
-| `Ctrl + C` | Копировать |
-| `Ctrl + E` | Закрыть вкладку |
-| `Ctrl + H` | Вкл./выкл. показ скрытых файлов |
-| `Ctrl + O` | Предпросмотр файла |
-| `Ctrl + P` | Свойства файлов и папок |
-| `Ctrl + R` | Перезагрузить |
-| `Ctrl + T` | Новая вкладка |
-| `Ctrl + V` | Вставить |
-| `Ctrl + X` | Вырезать |
-| `Ctrl + W` | Выйти из Xplorer |
-| `Alt + Left Arrow` | Назад |
-| `Alt + Right Arrow` | Вперёд |
-| `Alt + Up Arrow` | развернуть |
-| `Alt + Down Arrow` | свернуть |
-| `Alt + T` | Открыть в терминале |
-| `Alt + P` | Закрепить в боковой панели |
-| `Alt + Shift + C` | Скопировать путь |
-| `F2` | Переименовать |
-| `F5` | Обновить |
-| `F10` | Свернуть |
-| `F11` | Развернуть |
-| `Shift + N` | Новая папка |
-| `Shift + Del` | Удалить навсегда |
-| `Shift + Enter` | Открыть в vscode |
-| `Enter` | Открыть |
-| `Del` | Удалить файл |
+| Клавиша | Описание |
+| ------------------- | ----------------------- |
+| `Ctrl + A` | Выбрать всё |
+| `Ctrl + C` | Копировать |
+| `Ctrl + H` | Toggle Hidden Files |
+| `Ctrl + N` | New window shortcut |
+| `Ctrl + O` | Open file in preview |
+| `Ctrl + P` | Свойства файлов и папок |
+| `Ctrl + R` | Перезагрузить |
+| `Ctrl + T` | Новая вкладка |
+| `Ctrl + V` | Вставить |
+| `Ctrl + X` | Вырезать |
+| `Ctrl + W` | Exit Tab |
+| `Ctrl + Y` | Redo |
+| `Ctrl + Z` | Undo |
+| `Ctrl + Shift + Z` | Redo |
+| `Alt + Left Arrow` | Go Back |
+| `Alt + Right Arrow` | Go Forward |
+| `Alt + Up Arrow` | Go to parent directory |
+| `Alt + N` | New File |
+| `Alt + T` | Open in terminal |
+| `Alt + P` | Pin to sidebar |
+| `Alt + Shift + C` | Copy location path |
+| `F2` | Rename |
+| `F5` | Refresh |
+| `F10` | Minimize |
+| `F11` | Maximize |
+| `Shift + N` | New Folders |
+| `Shift + Del` | Permanent Delete |
+| `Shift + Enter` | Open in vscode |
+| `Enter` | Open |
+| `Del` | Delete file |
-:::note Difference between `reload` and `refresh` `Reload` refreshes the internal HTML while `Refresh` refreshes the whole Electron process.
+:::note Difference between `reload` and `refresh` `Reload` refreshes the internal process while `Refresh` refreshes the whole process.
:::
diff --git a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/xplorer as default.md b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
index 24fbd5e3..1622a512 100644
--- a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
+++ b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
@@ -12,7 +12,7 @@
4. Navigate to `Computer\HKEY_CURRENT_USER\Software\Classes\Directory`
5. Create a key named `shell` if not existed by right and set the default key value to `openinxplorer`
6. Create a key named `openinxplorer` under `shell`
-7. Create a key named `command` under `openinxplorer` and set the default key value to `"C:\Users\User\AppData\Local\Programs\Microsoft VS Code\Code.exe" "%V"`
+7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Program Files\Xplorer\Xplorer.exe" "%V"`. (You may have to change `C:\Program Files\Xplorer\` to the location you installed Xplorer)
diff --git a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/intro.md b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/intro.md
index 4c7d9fc5..859591eb 100644
--- a/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/intro.md
+++ b/docs/i18n/uk-UA/docusaurus-plugin-content-docs/current/intro.md
@@ -8,14 +8,18 @@ sidebar_position: 1
Ласкаво просимо до Xplorer, безкоштовного та опенсорсного файлового менеджера.
-Xplorer is a file explorer built from the ground up to be fully customizable and without customization, it also looks modern! It is cross-platform, built using Electron Technology that allowed our File Explorer to be run not only in Windows but also Linux and MacOS alike. It also allowed file preview directly inside it, not only pictures or documents but also videos!
+Xplorer is a file explorer built from ground-up to be fully customizable. And even without any customization, it already looks modern!
-## Особливості
+Xplorer is a cross-platform application built using [Tauri](https://tauri.studio), and you can run it on Windows, MacOS, or Linux without having much trouble. One of the key feature is Xplorer allows you to preview the files you have directly inside Xplorer. And it's not only limited to picture or document preview, but also video preview.
-Xplorer включает у себе:
+To summarize, Xplorer's features contain:
-- Сучасний зовнішній вид
+- It looks modern
- Простоту використання
- Кроссплатформенність
-- Попередній перегляд файлів і навіть відео!
-- Most importantly, it's Free and Open Source! Which mean you can change components inside if you see fit and you also don't need to make your wallet go dry or break the bank.
+- [File Preview](https://xplorer.vercel.app/docs/guides/operation/#preview-file), even for videos!
+- Customizable
+- Supports multiple tab
+- Most importantly, Free and Open Source Software(FOSS), which means you can change components inside if you see fit
+
+Xplorer is currently under heavy development. You can give your suggestions and feedbacks in our [Discussions](https://github.com/kimlimjustin/xplorer/discussions/) page. If you feel comfortable in writing code using Typescript and Rust, we highly encourage you to [contribute to this project](https://xplorer.vercel.app/community/Contributing/).
diff --git a/docs/i18n/uk-UA/docusaurus-plugin-content-pages/index.jsx b/docs/i18n/uk-UA/docusaurus-plugin-content-pages/index.jsx
index a3df6202..38990cae 100644
--- a/docs/i18n/uk-UA/docusaurus-plugin-content-pages/index.jsx
+++ b/docs/i18n/uk-UA/docusaurus-plugin-content-pages/index.jsx
@@ -5,102 +5,69 @@ import Slideshow from './slideshow';
import Link from '@docusaurus/Link';
export default function Home() {
- const { siteConfig } = useDocusaurusContext();
- return (
-
-
-
-
-
File Explorer.
-
Redefined.
-
- Free and Open Source Software. Runs everywhere.
-
+ Cross-platform File Explorer. Powered by the web.
+
+
+ Built using the{' '}
+
+ Tauri Framework
+ {' '}
+ , and written using{' '}
+
+ TypeScript
+ {' '}
+ for the frontend and{' '}
+
+ Rust
+ {' '}
+ for the backend, Xplorer promises you an unprecedented experience.
+
+
+
+
+
Designed out of the box
+
Say goodbye to the old design by traditional app and say hello to this simple yet powerful design.
+
+
+
+
Supports Multiple Tabs
+
Xplorer helps you organize you files easier by supporting multiple tabs .
+
+
+
+
File Preview
+
+ Xplorer supports files preview, from images, code preview, pdfs, to videos. Learn more{' '}
+ here.
+
+
+ );
}
diff --git a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/Community/Contributing.md b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/Community/Contributing.md
new file mode 100644
index 00000000..d8ffcd96
--- /dev/null
+++ b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/Community/Contributing.md
@@ -0,0 +1,173 @@
+---
+sidebar_position: 2
+---
+
+# 参与贡献
+
+👍🎉 首先, 感谢您花时间来贡献! 🎉👍
+
+Xplorer目前正在开发中。 我们欢迎您参与 Xplorer 的开发。
+
+## 参与
+
+您有诸多方式可以为 Xplorer 做出贡献，其中大多数无需您撰写甚至一行代码。 您可以从这些想法开始：
+
+- 开始使用 Xplorer ！ 请转到入门指南。 每一步都如教程所写的能正常工作吗？ 如果没有，我们总是在寻求改进。 通过提出一个 Issues，让我们了解情况。
+- 查看 [Xplorer Issues](https://github.com/kimlimjustin/xplorer/issues)。 若您有想修复的Issues，请[提交合并请求](#your-first-pull-request)。 标记为 [_头号好议题 (Good first issue)_](https://github.com/facebook/docusaurus/labels/Good%20first%20issue) 的都是好出发点。
+- 帮助我们改进文档。 如果您发现任何令人困惑的语文，或者任何语法错误，或者可以改进，请提交问题。
+- 查看 [GitHub 讨论](https://github.com/kimlimjustin/xplorer/discussions) 并将您的意见提交讨论，如果您看到一些你想要解决的问题，就考虑打开拉取请求。
+
+我们十分欢迎您的贡献。
+
+## 开发流程
+
+Docusaurus 使用 [GitHub](https://github.com/facebook/docusaurus) 作为其万物根基。 核心团队将使用此平台。 自初始的任何更改均为公共可见。
+
+### 提交新议题 {#issues}
+
+当[提交新议题时](https://github.com/facebook/docusaurus/issues/new/choose)，请务必确保您填写了议题模板。 我们使用 GitHub 问题来跟踪公开的漏洞。 请确保您的描述清晰，并且有足够的指示来复制问题。
+
+- **议题，一提：**请只对一个漏洞提交一个议题。
+- **提供重现步骤：**列出足以重现此问题的全部步骤。 阅读您漏洞反馈的人应能根据您所提供的步骤来重现问题。
+
+### 建议新功能 {#feat}
+
+我们使用 [GitHub 讨论](https://github.com/kimlimjustin/xplorer/discussions) and [GitHub Issues](https://github.com/kimlimjustin/xplorer) 追踪用户的想法。 在这里建议一个新功能 [](https://github.com/kimlimjustin/xplorer/discussions/new)！ 优秀的功能请求通常含有：
+
+- 功能概要
+- 什么 & 为何你想添加此功能
+- 附加附件，如图像，实现功能的资源链接等。
+
+## 在 Xplorer 代码上工作
+
+### 前提条件
+
+- [Tauri 环境](https://tauri.studio/en/docs/getting-started/intro#setting-up-your-environment)
+- [Node JS](https://nodejs.org/en/)
+- [Git](https://git-scm.com/)
+- [yarn](https://yarnpkg.com/)
+- 代码编辑器，我们建议您使用 [VS Code](https://code.visualstudio.com/)
+
+### 安装
+
+1. 在克隆仓库后， 在资源库的根目录下运行 `yarn` 并运行 `yarn` 在 `文档` 文件夹中(如果你想在 Xplorer 文档上工作的话)。
+2. 要在本地启动 Xplorer，请运行 `yarn dev`。
+
+ 要开启 Docusaurus 本地开发服务器，前往 `website` 目录并运行 `yarn start`
+
+### Gitpod {#gitpod-env}
+
+Gitpod is a Ready-to-Code environment in which you can get started immediately. Gitpod offers all dependencies pre-installed so you can just click and get started.
+
+To get started with Gitpod, click the button below and log in with your GitHub account.
+
+[](https://gitpod.io/#https://github.com/kimlimjustin/xplorer)
+
+:::note Remember to reload the Gitpod website after it loads up since it won't start the servers immediately, but by reloading, you can get it started. If you are developing the app, go to the Remote Explorer on the sidebar and visit port _6080_ which opens the noVNC app server. If you are developing the docs, go to the Remote explorer but instead of port 6080, visit port _3000_. You can edit normally as you do in VS Code, but if you want to use it locally, clik the hamburger menu button and click _Open in VS Code_. :::
+
+### Semantic commit messages {#commit-msg}
+
+See how a minor change to your commit message style can make you a better programmer.
+
+Format: `(): `
+
+`` is optional
+
+#### Example
+
+```
+feat: allow overriding of webpack config
+^--^ ^------------^
+| |
+| +-> Summary in present tense.
+|
++-------> Type: chore, docs, feat, fix, refactor, style, or test.
+```
+
+the various types of commits:
+
+- `feat`: new feature for the user
+- `fix`: bug fix for the user
+- `docs`: changes to the documentation
+- `style`: formatting, missing semi-colons, etc.
+- `refactor`: refactoring production code, eg. renaming a variable
+- `test`: adding missing tests, refactoring tests.
+- `chore`: updating grunt tasks etc
+
+Use lower case not the upper case!
+
+## Working on Xplorer docs
+
+Xplorer documentation website is built using [Docusaurus 2](https://docusaurus.io/), and its code is located at [`docs`](https://github.com/kimlimjustin/xplorer/tree/master/docs) folder.
+
+### Prerequisite
+
+- [node js](https://nodejs.org/en/)
+- [git](https://git-scm.com/downloads)
+- [yarn](https://yarnpkg.com/getting-started/install#about-global-installs)
+- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
+
+### Installation
+
+After cloning the repository, run `yarn` in the `docs` folder (you can go into the `docs` folder by running the `cd docs` command).
+
+If you want to use Gitpod, click [here](#gitpod-env) for the guide on how to use Gitpod.
+
+### Local development
+
+1. Run the `yarn start` command in the `docs` folder.
+2. Edit some markdown texts in the `docs` folder and the website will be hot reloaded.
+
+## Pull requests
+
+### Your first pull request. {#first-pull-request}
+
+So you have decided to contribute code back to upstream by opening a pull request. You've invested a good chunk of time, and we appreciate it. We will do our best to work with you and get the PR looked at.
+
+Working on your first Pull Request? You can learn how from this free video series:
+
+How to Contribute to an Open Source Project on GitHub
+
+We have a list of [beginner-friendly issues](https://github.com/kimlimjustin/xplorer/labels/good%20first%20issue) to help you get your feet wet in the Xplorer codebase and familiar with our contribution process. This is a great place to get started.
+
+### Proposing a change
+
+If you would like to request a new feature or enhancement but are not yet thinking about opening a pull request, you can also [open a discussion](#feat) and others will code it!
+
+If you intend to fix a bug, please discuss it through [Issues](#issues) before submitting a pull request.
+
+If you intend to add a new feature, please discuss it through [GitHub Discussions](#feat) to avoid multiple people working on the same feature request.
+
+### Sending a Pull Request
+
+make sure the PR does only one thing, otherwise please split it. It is recommended to follow this [commit message style](#commit-msg).
+
+1. Fork [the repository](https://github.com/kimlimjustin/xplorer) and create your branch from `master`.
+2. Make changes and ensure your commit message is understandable.
+3. Open a [PR](https://github.com/kimlimjustin/xplorer/pulls) and ensure to describe your pull request clearly.
+
+## Working on Xplorer resources
+
+### Locales
+
+We host our locales on the [crowdin](https://crwd.in/xplorer). To translate it, please follow these steps:
+
+- Sign up on [Crowdin](https://crowdin.com) and Join our project [here](https://crwd.in/xplorer).
+- Make sure your locale exists there, if it does not exist, leave a comment in [this discussion](https://github.com/kimlimjustin/xplorer/discussions/30) and I'll add the language option :)
+- Get familiar with the Crowdin translation UI, as you will need to use it to translate JSON and Markdown files
+- Translate the content!
+
+#### Priority Files to translate on Crowdin
+
+1. `src/Locales` files
+2. `docs/` files
+
+#### Production
+
+Once the files on `src/Locales` have been translated for more than 80%, we will add it into the Xplorer app, and for the docs, we will add it into production once the translation looks good!
+
+Please comment [here](https://github.com/kimlimjustin/xplorer/discussions/30) if you have any questions!
+
+### File Library
+
+The json library of file types and thumbnail are found under `lib` folder and the icons are found under `src/Icons` folder. You may add file types and icons for file extensions you want to use and submit a PR.
diff --git a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/Community/support.md b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/Community/support.md
new file mode 100644
index 00000000..8ea01be3
--- /dev/null
+++ b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/Community/support.md
@@ -0,0 +1,42 @@
+---
+sidebar_position: 1
+---
+
+# Support
+
+Xplorer is an open-source project which you can freely join and seek support 😊.
+
+On this page, we've listed some communities/forums you can participate in to seek support or help others.
+
+Before participating in Xplorer's communities, please read our [Code Of Conduct](/docs/community/CODE_OF_CONDUCT/).
+
+## Issues
+
+We use GitHub Issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue. Report a bug by opening a new issue [here](https://github.com/kimlimjustin/xplorer/issues/new).
+
+## GitHub Discussions
+
+GitHub Discussions is used for multiple purposes, such as:
+
+1. Asking questions
+2. Making feature requests and sharing ideas
+3. Chat on Xplorer
+4. Show and tell: Making custom themes/plug-ins for Xplorer and showing them there!
+
+### Feature Request
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussion) and [GitHub Issues](https://github.com/kimlimjustin/xplorer/issues) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional context like images, links to resources to implement the feature, etc.
+
+### Help
+
+You can ask for help using [GitHub Discussion](https://github.com/kimlimjustin/xplorer/discussions) or [Discord Channel](https://discord.gg/kK7rwxPt).
+
+:::note Remember to choose the discussion category as Q&A so that your question will be published with answers enabled. :::
+
+## News
+
+For the latest news about Xplorer, you can see it through posts on [Forem](https://dev.to/t/xplorer).
diff --git a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/common_problems.md b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/common_problems.md
index 0329306c..ebdcac5f 100644
--- a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/common_problems.md
+++ b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/common_problems.md
@@ -1,3 +1,7 @@
+- - -
+sidebar_position: 3
+- - -
+
# Common Problems
**NB: For common problems during installation, please open [here](/docs/install/#common-problems)**
@@ -5,25 +9,6 @@
-### Xplorer keep loading and crashes.
-
-
-
-Try opening `cmd` by opening Win + R(Run) and type `cmd`.
-
-Enter following command:
-
-```
-wmic
-```
-
-If the output says the `wmic` is not recognized as internal or internal command, please follow the following steps given on [this](https://superuser.com/questions/1178674/wmic-is-not-recognized-as-an-internal-or-external-command-operable-program-or) or [this](https://knowledge.informatica.com/s/article/156865?language=en_US). Also, please make sure that Windows Defender isn't blocking Xplorer from accessing your documents.
-
-
-
-
-
-
### Opening folder like `Documents`, `Desktop`, `Downloads` make Xplorer crashes
diff --git a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/_category_.json b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/_category_.json
index 2a648072..b1419d2f 100644
--- a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/_category_.json
+++ b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/_category_.json
@@ -1,4 +1,4 @@
{
- "label": "Guides",
- "position": 3
-}
\ No newline at end of file
+ "label": "Guides",
+ "position": 4
+}
diff --git a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/cli.md b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/cli.md
index b1ea164c..e125b4f0 100644
--- a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/cli.md
+++ b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/cli.md
@@ -1,7 +1,5 @@
# Launch Xplorer from Terminal
-:::info This feature hasn't been optimized yet. It works but it might be laggy. This will be optimized in the feature release. :::
-
## Commands
Xplorer CLI:
@@ -14,24 +12,6 @@ Xplorer will open `dir`, `dir2`, `dir3` as tabs on Xplorer. If there's no direct
Options:
-| Command | Alias | Description |
-| ----------- | ----- | ---------------------------------------------- |
-| `--help` | `-h` | Show help |
-| `--version` | `-v` | Show version number |
-| `--reveal` | `-r` | Open the containing folder and select the file |
-
-
-
-xplorer: command not found error on Windows
-
-
-Firstly, you have to register the command into the system path.
-
-1. Open the `System Properties` on Windows.
-2. Click the `Environment Variables` button, it will pop up a window.
-3. On the table, search for the `Path` variable and click on it.
-4. Click the `Edit` button, it will pop up a window.
-5. Click the `New` button.
-6. Add `%USERPROFILE%\AppData\Local\Programs\xplorer`.
-
-
+| Command | Alias | Description |
+| ---------- | ----- | ---------------------------------------------- |
+| `--reveal` | `-r` | Open the containing folder and select the file |
diff --git a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/operation.md b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/operation.md
index 4804e090..75cdea48 100644
--- a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/operation.md
+++ b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/operation.md
@@ -6,13 +6,9 @@ You can copy files by right-clicking it and click the `Copy` option or select th
:::info
-On Windows and macOS, Xplorer will copy the file paths into the local clipboard, because of this, you can copy a file from Xplorer and paste it into any folder in another system. However, on Linux, we create a string of Xplorer commands and copy it into the user clipboard, Xplorer will read the user's clipboard when pasting the file (because we haven't found any idea to implement it, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us). The string of the Xplorer command looks like this:
+For current implementation, Xplorer write down what to copy locally (not copying to clipboard).
-```
-Xplorer command - COPY
-~/xplorer
-~/test
-```
+TODO: implement copy to clipboard
:::
@@ -24,29 +20,27 @@ You can copy a file/folder location path into your clipboard by right-clicking i
You can cut files by right-clicking it and click the `Cut` option or select the file then press `Ctrl + X` as a shortcut and paste it by clicking the `Paste` option or press `Ctrl + V` on the destination folder.
-:::info This is done by creating a string of Xplorer command and copies it into the user clipboard to be used when pasting file (this is not integrated with the platform because we haven't found any idea, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.). The string of Xplorer command looks like this:
+:::info
-```
-Xplorer command - CUT
-E://xplorer
-E://test
-```
+For current implementation, Xplorer write down what to cut locally (not copying to clipboard).
:::
## Delete files
-You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut. The trashed file can be accessed at `xplorer://Trash`.
+You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut.
-:::info
+### Trashed files
-- On Windows, this is done by creating a `Trash` folder on the `C:` drive and moving the file into it.
-- On Linux, this feature is fully integrated with the system.
-- On macOS, this is done by creating a `.local/Trash` folder on `homedir` and moving the file into it.
+The trashed file can be accessed at `xplorer://Trash` or your system trash folder. :::danger Open Issue
-We are still working on Windows on macOS to integrate the `Trash` folder, which will be released before the stable version came out. Feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.
+Please note that Trash folder cannot be accessed on macos via Xplorer since the [trash crate](https://github.com/Byron/trash-rs) Xplorer relies to does not support it (see [this issue](https://github.com/Byron/trash-rs/issues/8) for more details).
-:::
+Any contributions to either the trash crate or Xplorer itself for this topic are welcome. :::
+
+### Restore files
+
+You can restore files by opening the `xplorer://Trash` and right-clicking it and click the `Restore` option
### Permanently delete
@@ -100,71 +94,12 @@ You can preview a file directly from Xplorer by right-clicking it and click the
Files available to preview for now:
-```json
-[
- ".pdf",
- ".html",
- ".docx",
- ".htm",
- ".xlsx",
- ".xls",
- ".xlsb",
- "xls",
- ".ods",
- ".fods",
- ".csv",
- ".txt",
- ".py",
- ".js",
- ".bat",
- ".css",
- ".c++",
- ".cpp",
- ".cc",
- ".c",
- ".diff",
- ".patch",
- ".go",
- ".java",
- ".json",
- ".php",
- ".ts",
- ".tsx",
- ".jsx",
- ".jpg",
- ".png",
- ".gif",
- ".bmp",
- ".jpeg",
- ".jpe",
- ".jif",
- ".jfif",
- ".jfi",
- ".webp",
- ".tiff",
- ".tif",
- ".ico",
- ".svg",
- ".webp",
- ".mp4",
- ".webm",
- ".mpg",
- ".mp2",
- ".mpeg",
- ".mpe",
- ".mpv",
- ".ocg",
- ".m4p",
- ".m4v",
- ".avi",
- ".wmv",
- ".mov",
- ".qt",
- ".flv",
- ".swf",
- ".md"
-]
-```
+* Markdown files
+* Image files
+* Text files
+* Video files
+* Pdfs
+* Almost all programming language with syntax highlighting
diff --git a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/setting.md b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/setting.md
index 8219e5f5..e48188a6 100644
--- a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/setting.md
+++ b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/setting.md
@@ -12,29 +12,63 @@ You can open settings on Xplorer by clicking the `Settings` button on the left d
How to exit from Settings?
-You can exit from Settings on Xplorer by clicking the Arrow Up button on the upside left of Xplorer.
+You can exit from Settings on Xplorer by clicking on the upside left of Xplorer.
-## App Theme
+## Appearance
+
+### App Theme
You can change Xplorer's app theme on the `Appearance` tab of the Settings. Available default themes are `light`, `light+`, `dark`, and `dark+`. Besides, there is a `System Default` theme that will automatically read your system preference. :::info Xplorer will support a custom app theme soon, stay tuned! :::
-### Acrylic Effect
+### Font Family
+
+You can change Xplorer's font family on the `Appearance` tab of the Settings to one of installed font families installed on your system.
+
+### Font Size
+
+You can change Xplorer's font size on the `Appearance` tab of the Settings. Please note that an ideal font size is between 10px to 30px.
+
+### Window Transparency
+
+Make Xplorer window transparent on the `Appearance` tab of the Settings by combining following options. Please note that an ideal transparency is between 70% to 100%. You can disable transparency by disable all of the transparency options.
+
+#### Transparent Sidebar
-The Acrylic Effect is the effect that gives the transparency effect on the sidebar. Only works on Windows 10 and higher.
+Make the sidebar transparent 
-## File Preview
+#### Transparent Topbar
-The file preview here means the preview that replaces the default icon of a file.
+Make the topbar transparent 
-### Play video file as a preview
+#### Transparent Workspace
+
+make the workspace transparent 
+
+### Frame Style
+
+You can choose the frame style on the `Appearance` tab of the Settings. The available options are `Default` and `System Default`. `Default` will use Xplorer's default style which is the same across platforms. `System Default` will use the system default frame style which is difference according to your platform.
+
+### File Preview
+
+File Preview here might means the file thumbnail.
+
+#### Automatically play video file as thumbnail
This will automatically play the video file as a preview. :::caution THIS MIGHT CONSUME HIGH AMOUNT OF RAM This might consume a high amount of RAM because it's built on the HTML video player. You can just enable this setting and ignore this caution if you got a good-spec computer. :::
-### Extract `EXE` file icon and make it a preview
+#### Preview image on hover
+
+This fill automatically show the image when you hovering it for 500ms.
+
+
+
+Some people might found it annoying and you can disable it by disabling this setting.
+
+#### Extract exe file icon and make it as the thumbnail
This will parse and cache the icon from a `exe` file and make it a preview. Only on Windows.
@@ -48,22 +82,43 @@ The way to fix it is to disable the setting.
:::
-## Default file layout
+:::info Open issue The current approach is by calling the powershell program which might pops up cmd windows.
+
+Any contribution to call it directly from Xplorer is welcome. :::
+
+#### Show Image as Thumbnail
+
+This will show the image as a thumbnail of a file. Please note that this is not recommended for large directory as it reads the image to memory.
+
+#### Default file layout
Default file layout of a directory. Just give it a try :)
-## App Language
+## Preference
+
+### App Language
Localize Xplorer. Help us translate Xplorer [here](https://github.com/kimlimjustin/xplorer/discussions/30).
-## Hide Hidden Files
+### Hide Hidden Files
Hide hidden files on Xplorer, you can find this setting on the `Preference` tab on Xplorer or by its shortcut, `Ctrl + H`.
-## Hide System Files
+### Hide System Files
Hide Windows' system files on Xplorer. :::tip Learn what is system file [here](https://en.wikipedia.org/wiki/System_file). Just turn it off if you don't understand what it is. :::
-## List and sort directories alongside files
+### List and sort directories alongside files
If disabled, Xplorer will prioritize directories above files.
+
+### Detect Drive Change
+
+Turning this on will detect drive change and update the sidebar and drives section. Please note that this will take high ammount of RAM as this is not stabilized yet.
+
+### On startup
+
+Option to do on starting Xplorer. Available options are:
+
+- New Tab
+- Continue previous session
diff --git a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/shortcut.md b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/shortcut.md
index 5a2ac3cb..1dcb2c04 100644
--- a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/shortcut.md
+++ b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/shortcut.md
@@ -4,19 +4,22 @@
| ------------------- | ------------------------ |
| `Ctrl + A` | Select All |
| `Ctrl + C` | Copy |
-| `Ctrl + E` | Close Tab |
| `Ctrl + H` | Toggle Hidden Files |
-| `Ctrl + O` | Preview file |
+| `Ctrl + N` | New window shortcut |
+| `Ctrl + O` | Open file in preview |
| `Ctrl + P` | Files/Folders Properties |
| `Ctrl + R` | Reload |
| `Ctrl + T` | New Tab |
| `Ctrl + V` | Paste |
| `Ctrl + X` | Cut |
-| `Ctrl + W` | Exit Xplorer |
+| `Ctrl + W` | Exit Tab |
+| `Ctrl + Y` | Redo |
+| `Ctrl + Z` | Undo |
+| `Ctrl + Shift + Z` | Redo |
| `Alt + Left Arrow` | Go Back |
| `Alt + Right Arrow` | Go Forward |
-| `Alt + Up Arrow` | maximize |
-| `Alt + Down Arrow` | minimize |
+| `Alt + Up Arrow` | Go to parent directory |
+| `Alt + N` | New File |
| `Alt + T` | Open in terminal |
| `Alt + P` | Pin to sidebar |
| `Alt + Shift + C` | Copy location path |
@@ -30,6 +33,6 @@
| `Enter` | Open |
| `Del` | Delete file |
-:::note Difference between `reload` and `refresh` `Reload` refreshes the internal HTML while `Refresh` refreshes the whole Electron process.
+:::note Difference between `reload` and `refresh` `Reload` refreshes the internal process while `Refresh` refreshes the whole process.
:::
diff --git a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/xplorer as default.md b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
index f575bfa4..e69d60f6 100644
--- a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
+++ b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
@@ -12,7 +12,7 @@
4. Navigate to `Computer\HKEY_CURRENT_USER\Software\Classes\Directory`
5. Create a key named `shell` if not existed by right and set the default key-value to `openinxplorer`
6. Create a key named `openinxplorer` under `shell`
-7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Users\User\AppData\Local\Programs\Microsoft VS Code\Code.exe" "%V"`
+7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Program Files\Xplorer\Xplorer.exe" "%V"`. (You may have to change `C:\Program Files\Xplorer\` to the location you installed Xplorer)
diff --git a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/intro.md b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/intro.md
index 84728f3d..e52c059e 100644
--- a/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/intro.md
+++ b/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/intro.md
@@ -8,14 +8,18 @@ sidebar_position: 1
Welcome to Xplorer, A Free and Open Source (FOSS) File Explorer.
-Xplorer is a file explorer built from the ground up to be fully customizable and without customization, it also looks modern! It is cross-platform, built using Electron Technology that allowed our File Explorer to be run not only in Windows but also Linux and MacOS alike. It also allowed file preview directly inside it, not only pictures or documents but also videos!
+Xplorer is a file explorer built from ground-up to be fully customizable. And even without any customization, it already looks modern!
-## 特色
+Xplorer is a cross-platform application built using [Tauri](https://tauri.studio), and you can run it on Windows, MacOS, or Linux without having much trouble. One of the key feature is Xplorer allows you to preview the files you have directly inside Xplorer. And it's not only limited to picture or document preview, but also video preview.
-So to summarize, Xplorer's features contain:
+To summarize, Xplorer's features contain:
-- 现代化
+- It looks modern
- Easy to use
- Cross-platform
-- File Preview, even videos!
-- Most importantly, it's Free and Open Source! Which mean you can change components inside if you see fit and you also don't need to make your wallet go dry or break the bank.
+- [File Preview](https://xplorer.vercel.app/docs/guides/operation/#preview-file), even for videos!
+- Customizable
+- Supports multiple tab
+- Most importantly, Free and Open Source Software(FOSS), which means you can change components inside if you see fit
+
+Xplorer is currently under heavy development. You can give your suggestions and feedbacks in our [Discussions](https://github.com/kimlimjustin/xplorer/discussions/) page. If you feel comfortable in writing code using Typescript and Rust, we highly encourage you to [contribute to this project](https://xplorer.vercel.app/community/Contributing/).
diff --git a/docs/i18n/zh-CN/docusaurus-plugin-content-pages/index.jsx b/docs/i18n/zh-CN/docusaurus-plugin-content-pages/index.jsx
index a3df6202..38990cae 100644
--- a/docs/i18n/zh-CN/docusaurus-plugin-content-pages/index.jsx
+++ b/docs/i18n/zh-CN/docusaurus-plugin-content-pages/index.jsx
@@ -5,102 +5,69 @@ import Slideshow from './slideshow';
import Link from '@docusaurus/Link';
export default function Home() {
- const { siteConfig } = useDocusaurusContext();
- return (
-
-
-
-
-
File Explorer.
-
Redefined.
-
- Free and Open Source Software. Runs everywhere.
-
+ Cross-platform File Explorer. Powered by the web.
+
+
+ Built using the{' '}
+
+ Tauri Framework
+ {' '}
+ , and written using{' '}
+
+ TypeScript
+ {' '}
+ for the frontend and{' '}
+
+ Rust
+ {' '}
+ for the backend, Xplorer promises you an unprecedented experience.
+
+
+
+
+
Designed out of the box
+
Say goodbye to the old design by traditional app and say hello to this simple yet powerful design.
+
+
+
+
Supports Multiple Tabs
+
Xplorer helps you organize you files easier by supporting multiple tabs .
+
+
+
+
File Preview
+
+ Xplorer supports files preview, from images, code preview, pdfs, to videos. Learn more{' '}
+ here.
+
+
+ );
}
diff --git a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/Community/Contributing.md b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/Community/Contributing.md
new file mode 100644
index 00000000..be326698
--- /dev/null
+++ b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/Community/Contributing.md
@@ -0,0 +1,173 @@
+---
+sidebar_position: 2
+---
+
+# Contribute
+
+👍🎉 First off, thanks for taking the time to contribute! 🎉👍
+
+Xplorer is currently under heavy development. We are welcoming contributors to collaborate on Xplorer.
+
+## Get involved
+
+There are many ways to contribute to Xplorer, and many of them do not involve writing any code. Here are few ideas to get started:
+
+- Start using Xplorer! Go through the Tutorial guides. Does anything work as expected? If not, we're always looking for improvements. Let us know by opening an issue.
+- Look through the [Xplorer issues](https://github.com/kimlimjustin/xplorer/issues). If you find an issue you would like to fix, [open a pull request](#first-pull-request). Issues tagged as [good first issue](https://github.com/kimlimjustin/xplorer/labels/good%20first%20issue) are a good place to get started.
+- Help us make the docs better. File an issue if you find anything that is confusing, any grammatical error, or can be improved.
+- Take a look at [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) and give your opinion into a discussion or consider opening a pull request if you see something you want to work on.
+
+Contributions are very welcome!
+
+## Our development process
+
+Xplorer uses [GitHub](https://github.com/kimlimjustin/xplorer) as its source of truth. The core team will work directly there. All changes will be public from the beginning.
+
+### Reporting new issues/bugs. {#issues}
+
+When [opening a new issue](https://github.com/kimlimjustin/xplorer/issues), always make sure to fill out the issue template. We use GitHub issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue.
+
+- _One issue, one bug_: Please report a single bug per issue.
+- _Provide reproduction steps_: List all the steps necessary to reproduce the issue. The person reading your bug report should be able to follow these steps to reproduce your issue with minimal effort.
+
+### Feature Request {#feat}
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussions) and [GitHub Issues](https://github.com/kimlimjustin/xplorer) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional references like images, links of resources about the feature, etc.
+
+## Working on Xplorer code
+
+### Prerequisite
+
+- [Tauri environment](https://tauri.studio/en/docs/getting-started/intro#setting-up-your-environment)
+- [Node JS](https://nodejs.org/en/)
+- [Git](https://git-scm.com/)
+- [yarn](https://yarnpkg.com/)
+- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
+
+### Installation
+
+1. After cloning the repository, run `yarn` in the root of the repository and run `yarn` in the `docs` folder (if you want to working on Xplorer Docs).
+2. To start Xplorer locally, run `yarn dev`.
+
+ To start a local development server serving the Docusaurus docs, go into the `docs` directory and run `yarn start`
+
+### Gitpod {#gitpod-env}
+
+Gitpod is a Ready-to-Code environment in which you can get started immediately. Gitpod offers all dependencies pre-installed so you can just click and get started.
+
+To get started with Gitpod, click the button below and log in with your GitHub account.
+
+[](https://gitpod.io/#https://github.com/kimlimjustin/xplorer)
+
+:::note Remember to reload the Gitpod website after it loads up since it won't start the servers immediately, but by reloading, you can get it started. If you are developing the app, go to the Remote Explorer on the sidebar and visit port _6080_ which opens the noVNC app server. If you are developing the docs, go to the Remote explorer but instead of port 6080, visit port _3000_. You can edit normally as you do in VS Code, but if you want to use it locally, clik the hamburger menu button and click _Open in VS Code_. :::
+
+### Semantic commit messages {#commit-msg}
+
+See how a minor change to your commit message style can make you a better programmer.
+
+Format: `(): `
+
+`` is optional
+
+#### Example
+
+```
+feat: allow overriding of webpack config
+^--^ ^------------^
+| |
+| +-> Summary in present tense.
+|
++-------> Type: chore, docs, feat, fix, refactor, style, or test.
+```
+
+the various types of commits:
+
+- `feat`: new feature for the user
+- `fix`: bug fix for the user
+- `docs`: changes to the documentation
+- `style`: formatting, missing semi-colons, etc.
+- `refactor`: refactoring production code, eg. renaming a variable
+- `test`: adding missing tests, refactoring tests.
+- `chore`: updating grunt tasks etc
+
+Use lower case not the upper case!
+
+## Working on Xplorer docs
+
+Xplorer documentation website is built using [Docusaurus 2](https://docusaurus.io/), and its code is located at [`docs`](https://github.com/kimlimjustin/xplorer/tree/master/docs) folder.
+
+### Prerequisite
+
+- [node js](https://nodejs.org/en/)
+- [git](https://git-scm.com/downloads)
+- [yarn](https://yarnpkg.com/getting-started/install#about-global-installs)
+- Code Editor, we recommend you to use [VS Code](https://code.visualstudio.com/)
+
+### Installation
+
+After cloning the repository, run `yarn` in the `docs` folder (you can go into the `docs` folder by running the `cd docs` command).
+
+If you want to use Gitpod, click [here](#gitpod-env) for the guide on how to use Gitpod.
+
+### Local development
+
+1. Run the `yarn start` command in the `docs` folder.
+2. Edit some markdown texts in the `docs` folder and the website will be hot reloaded.
+
+## Pull requests
+
+### Your first pull request. {#first-pull-request}
+
+So you have decided to contribute code back to upstream by opening a pull request. You've invested a good chunk of time, and we appreciate it. We will do our best to work with you and get the PR looked at.
+
+Working on your first Pull Request? You can learn how from this free video series:
+
+How to Contribute to an Open Source Project on GitHub
+
+We have a list of [beginner-friendly issues](https://github.com/kimlimjustin/xplorer/labels/good%20first%20issue) to help you get your feet wet in the Xplorer codebase and familiar with our contribution process. This is a great place to get started.
+
+### Proposing a change
+
+If you would like to request a new feature or enhancement but are not yet thinking about opening a pull request, you can also [open a discussion](#feat) and others will code it!
+
+If you intend to fix a bug, please discuss it through [Issues](#issues) before submitting a pull request.
+
+If you intend to add a new feature, please discuss it through [GitHub Discussions](#feat) to avoid multiple people working on the same feature request.
+
+### Sending a Pull Request
+
+make sure the PR does only one thing, otherwise please split it. It is recommended to follow this [commit message style](#commit-msg).
+
+1. Fork [the repository](https://github.com/kimlimjustin/xplorer) and create your branch from `master`.
+2. Make changes and ensure your commit message is understandable.
+3. Open a [PR](https://github.com/kimlimjustin/xplorer/pulls) and ensure to describe your pull request clearly.
+
+## Working on Xplorer resources
+
+### Locales
+
+We host our locales on the [crowdin](https://crwd.in/xplorer). To translate it, please follow these steps:
+
+- Sign up on [Crowdin](https://crowdin.com) and Join our project [here](https://crwd.in/xplorer).
+- Make sure your locale exists there, if it does not exist, leave a comment in [this discussion](https://github.com/kimlimjustin/xplorer/discussions/30) and I'll add the language option :)
+- Get familiar with the Crowdin translation UI, as you will need to use it to translate JSON and Markdown files
+- Translate the content!
+
+#### Priority Files to translate on Crowdin
+
+1. `src/Locales` files
+2. `docs/` files
+
+#### Production
+
+Once the files on `src/Locales` have been translated for more than 80%, we will add it into the Xplorer app, and for the docs, we will add it into production once the translation looks good!
+
+Please comment [here](https://github.com/kimlimjustin/xplorer/discussions/30) if you have any questions!
+
+### File Library
+
+The json library of file types and thumbnail are found under `lib` folder and the icons are found under `src/Icons` folder. You may add file types and icons for file extensions you want to use and submit a PR.
diff --git a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/Community/support.md b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/Community/support.md
new file mode 100644
index 00000000..8ea01be3
--- /dev/null
+++ b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/Community/support.md
@@ -0,0 +1,42 @@
+---
+sidebar_position: 1
+---
+
+# Support
+
+Xplorer is an open-source project which you can freely join and seek support 😊.
+
+On this page, we've listed some communities/forums you can participate in to seek support or help others.
+
+Before participating in Xplorer's communities, please read our [Code Of Conduct](/docs/community/CODE_OF_CONDUCT/).
+
+## Issues
+
+We use GitHub Issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue. Report a bug by opening a new issue [here](https://github.com/kimlimjustin/xplorer/issues/new).
+
+## GitHub Discussions
+
+GitHub Discussions is used for multiple purposes, such as:
+
+1. Asking questions
+2. Making feature requests and sharing ideas
+3. Chat on Xplorer
+4. Show and tell: Making custom themes/plug-ins for Xplorer and showing them there!
+
+### Feature Request
+
+We use [GitHub Discussions](https://github.com/kimlimjustin/xplorer/discussion) and [GitHub Issues](https://github.com/kimlimjustin/xplorer/issues) to track ideas from users. Suggest a new feature [here](https://github.com/kimlimjustin/xplorer/discussions/new)! Great Feature Requests tend to have:
+
+- A quick idea summary.
+- What & why you wanted to add the specific feature.
+- Additional context like images, links to resources to implement the feature, etc.
+
+### Help
+
+You can ask for help using [GitHub Discussion](https://github.com/kimlimjustin/xplorer/discussions) or [Discord Channel](https://discord.gg/kK7rwxPt).
+
+:::note Remember to choose the discussion category as Q&A so that your question will be published with answers enabled. :::
+
+## News
+
+For the latest news about Xplorer, you can see it through posts on [Forem](https://dev.to/t/xplorer).
diff --git a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/common_problems.md b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/common_problems.md
index 0329306c..ebdcac5f 100644
--- a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/common_problems.md
+++ b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/common_problems.md
@@ -1,3 +1,7 @@
+- - -
+sidebar_position: 3
+- - -
+
# Common Problems
**NB: For common problems during installation, please open [here](/docs/install/#common-problems)**
@@ -5,25 +9,6 @@
-### Xplorer keep loading and crashes.
-
-
-
-Try opening `cmd` by opening Win + R(Run) and type `cmd`.
-
-Enter following command:
-
-```
-wmic
-```
-
-If the output says the `wmic` is not recognized as internal or internal command, please follow the following steps given on [this](https://superuser.com/questions/1178674/wmic-is-not-recognized-as-an-internal-or-external-command-operable-program-or) or [this](https://knowledge.informatica.com/s/article/156865?language=en_US). Also, please make sure that Windows Defender isn't blocking Xplorer from accessing your documents.
-
-
-
-
-
-
### Opening folder like `Documents`, `Desktop`, `Downloads` make Xplorer crashes
diff --git a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/_category_.json b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/_category_.json
index de66c189..fff5a263 100644
--- a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/_category_.json
+++ b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/_category_.json
@@ -1,4 +1,4 @@
{
- "label": "使用指南",
- "position": 3
-}
\ No newline at end of file
+ "label": "使用指南",
+ "position": 4
+}
diff --git a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/cli.md b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/cli.md
index bdd79bb4..635aba13 100644
--- a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/cli.md
+++ b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/cli.md
@@ -1,7 +1,5 @@
# 從終端機啟動Xplorer
-:::info This feature hasn't been optimized yet. 可以使用但可能反應較慢 This will be optimized in the feature release. :::
-
## 指令
Xplorer CLI:
@@ -10,28 +8,10 @@ Xplorer CLI:
xplorer [dir1] [dir2] [dir3]
```
-Xplorer會以分頁開啟`資料夾`, `資料夾2`, `資料夾3`。 If there's no directory(dir) passed into the command, Xplorer will start at the Home page.
-
-選項
-
-| 指令 | 代稱 | 說明 |
-| ----------- | ---- | ------------ |
-| `--help` | `-h` | 顯示說明 |
-| `--version` | `-v` | 顯示版本編號 |
-| `--reveal` | `-r` | 打開包含文件夾並選擇文件 |
-
-
-
-於Windows系統中使用時出現xplorer: command not found錯誤
-
-
-首先，您需要將指令新增至環境變數。
+Xplorer will open `dir`, `dir2`, `dir3` as tabs on Xplorer. If there's no directory(dir) passed into the command, Xplorer will start at the Home page.
-1. 在Windows系統中開啟`系統內容`
-2. Click the `Environment Variables` button, it will pop up a window.
-3. On the table, search for the `Path` variable and click on it.
-4. Click the `Edit` button, it will pop up a window.
-5. Click the `New` button.
-6. Add `%USERPROFILE%\AppData\Local\Programs\xplorer`.
+Options:
-
+| 指令 | 代稱 | 說明 |
+| ---------- | ---- | ---------------------------------------------- |
+| `--reveal` | `-r` | Open the containing folder and select the file |
diff --git a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/operation.md b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/operation.md
index 4804e090..75cdea48 100644
--- a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/operation.md
+++ b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/operation.md
@@ -6,13 +6,9 @@ You can copy files by right-clicking it and click the `Copy` option or select th
:::info
-On Windows and macOS, Xplorer will copy the file paths into the local clipboard, because of this, you can copy a file from Xplorer and paste it into any folder in another system. However, on Linux, we create a string of Xplorer commands and copy it into the user clipboard, Xplorer will read the user's clipboard when pasting the file (because we haven't found any idea to implement it, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us). The string of the Xplorer command looks like this:
+For current implementation, Xplorer write down what to copy locally (not copying to clipboard).
-```
-Xplorer command - COPY
-~/xplorer
-~/test
-```
+TODO: implement copy to clipboard
:::
@@ -24,29 +20,27 @@ You can copy a file/folder location path into your clipboard by right-clicking i
You can cut files by right-clicking it and click the `Cut` option or select the file then press `Ctrl + X` as a shortcut and paste it by clicking the `Paste` option or press `Ctrl + V` on the destination folder.
-:::info This is done by creating a string of Xplorer command and copies it into the user clipboard to be used when pasting file (this is not integrated with the platform because we haven't found any idea, feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.). The string of Xplorer command looks like this:
+:::info
-```
-Xplorer command - CUT
-E://xplorer
-E://test
-```
+For current implementation, Xplorer write down what to cut locally (not copying to clipboard).
:::
## Delete files
-You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut. The trashed file can be accessed at `xplorer://Trash`.
+You can cut files by right-clicking it and click the `Delete` option or select the file then press `Del` as a shortcut.
-:::info
+### Trashed files
-- On Windows, this is done by creating a `Trash` folder on the `C:` drive and moving the file into it.
-- On Linux, this feature is fully integrated with the system.
-- On macOS, this is done by creating a `.local/Trash` folder on `homedir` and moving the file into it.
+The trashed file can be accessed at `xplorer://Trash` or your system trash folder. :::danger Open Issue
-We are still working on Windows on macOS to integrate the `Trash` folder, which will be released before the stable version came out. Feel free to [open a PR](/community/Contributing/#pull-requests) if you can help us.
+Please note that Trash folder cannot be accessed on macos via Xplorer since the [trash crate](https://github.com/Byron/trash-rs) Xplorer relies to does not support it (see [this issue](https://github.com/Byron/trash-rs/issues/8) for more details).
-:::
+Any contributions to either the trash crate or Xplorer itself for this topic are welcome. :::
+
+### Restore files
+
+You can restore files by opening the `xplorer://Trash` and right-clicking it and click the `Restore` option
### Permanently delete
@@ -100,71 +94,12 @@ You can preview a file directly from Xplorer by right-clicking it and click the
Files available to preview for now:
-```json
-[
- ".pdf",
- ".html",
- ".docx",
- ".htm",
- ".xlsx",
- ".xls",
- ".xlsb",
- "xls",
- ".ods",
- ".fods",
- ".csv",
- ".txt",
- ".py",
- ".js",
- ".bat",
- ".css",
- ".c++",
- ".cpp",
- ".cc",
- ".c",
- ".diff",
- ".patch",
- ".go",
- ".java",
- ".json",
- ".php",
- ".ts",
- ".tsx",
- ".jsx",
- ".jpg",
- ".png",
- ".gif",
- ".bmp",
- ".jpeg",
- ".jpe",
- ".jif",
- ".jfif",
- ".jfi",
- ".webp",
- ".tiff",
- ".tif",
- ".ico",
- ".svg",
- ".webp",
- ".mp4",
- ".webm",
- ".mpg",
- ".mp2",
- ".mpeg",
- ".mpe",
- ".mpv",
- ".ocg",
- ".m4p",
- ".m4v",
- ".avi",
- ".wmv",
- ".mov",
- ".qt",
- ".flv",
- ".swf",
- ".md"
-]
-```
+* Markdown files
+* Image files
+* Text files
+* Video files
+* Pdfs
+* Almost all programming language with syntax highlighting
diff --git a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/setting.md b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/setting.md
index 46b74be6..2186e202 100644
--- a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/setting.md
+++ b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/setting.md
@@ -12,29 +12,63 @@
How to exit from Settings?
-You can exit from Settings on Xplorer by clicking the Arrow Up button on the upside left of Xplorer.
+You can exit from Settings on Xplorer by clicking on the upside left of Xplorer.
-## 應用主題
+## Appearance
+
+### App Theme
你可以在設定中的`外觀`頁面變更Xplorer主題。 可以套用的預設主題有`light`、`light+`、`dark`和`dark+`。 Besides, there is a `System Default` theme that will automatically read your system preference. :::info Xplorer will support a custom app theme soon, stay tuned! :::
-### Acrylic Effect
+### Font Family
+
+You can change Xplorer's font family on the `Appearance` tab of the Settings to one of installed font families installed on your system.
+
+### Font Size
+
+You can change Xplorer's font size on the `Appearance` tab of the Settings. Please note that an ideal font size is between 10px to 30px.
+
+### Window Transparency
+
+Make Xplorer window transparent on the `Appearance` tab of the Settings by combining following options. Please note that an ideal transparency is between 70% to 100%. You can disable transparency by disable all of the transparency options.
+
+#### Transparent Sidebar
-The Acrylic Effect is the effect that gives the transparency effect on the sidebar. Only works on Windows 10 and higher.
+Make the sidebar transparent 
-## File Preview
+#### Transparent Topbar
-The file preview here means the preview that replaces the default icon of a file.
+Make the topbar transparent 
-### Play video file as a preview
+#### Transparent Workspace
+
+make the workspace transparent 
+
+### Frame Style
+
+You can choose the frame style on the `Appearance` tab of the Settings. The available options are `Default` and `System Default`. `Default` will use Xplorer's default style which is the same across platforms. `System Default` will use the system default frame style which is difference according to your platform.
+
+### File Preview
+
+File Preview here might means the file thumbnail.
+
+#### Automatically play video file as thumbnail
This will automatically play the video file as a preview. :::caution THIS MIGHT CONSUME HIGH AMOUNT OF RAM This might consume a high amount of RAM because it's built on the HTML video player. You can just enable this setting and ignore this caution if you got a good-spec computer. :::
-### Extract `EXE` file icon and make it a preview
+#### Preview image on hover
+
+This fill automatically show the image when you hovering it for 500ms.
+
+
+
+Some people might found it annoying and you can disable it by disabling this setting.
+
+#### Extract exe file icon and make it as the thumbnail
This will parse and cache the icon from a `exe` file and make it a preview. Only on Windows.
@@ -48,22 +82,43 @@ The way to fix it is to disable the setting.
:::
-## Default file layout
+:::info Open issue The current approach is by calling the powershell program which might pops up cmd windows.
+
+Any contribution to call it directly from Xplorer is welcome. :::
+
+#### Show Image as Thumbnail
+
+This will show the image as a thumbnail of a file. Please note that this is not recommended for large directory as it reads the image to memory.
+
+#### Default file layout
Default file layout of a directory. Just give it a try :)
-## App Language
+## Preference
+
+### App Language
Localize Xplorer. Help us translate Xplorer [here](https://github.com/kimlimjustin/xplorer/discussions/30).
-## Hide Hidden Files
+### Hide Hidden Files
Hide hidden files on Xplorer, you can find this setting on the `Preference` tab on Xplorer or by its shortcut, `Ctrl + H`.
-## Hide System Files
+### Hide System Files
Hide Windows' system files on Xplorer. :::tip Learn what is system file [here](https://en.wikipedia.org/wiki/System_file). Just turn it off if you don't understand what it is. :::
-## List and sort directories alongside files
+### List and sort directories alongside files
If disabled, Xplorer will prioritize directories above files.
+
+### Detect Drive Change
+
+Turning this on will detect drive change and update the sidebar and drives section. Please note that this will take high ammount of RAM as this is not stabilized yet.
+
+### On startup
+
+Option to do on starting Xplorer. Available options are:
+
+- New Tab
+- Continue previous session
diff --git a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/shortcut.md b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/shortcut.md
index 5f012191..9ade2e8c 100644
--- a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/shortcut.md
+++ b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/shortcut.md
@@ -1,35 +1,38 @@
# 快速鍵
-| 按鍵組合 | 功能 |
-| ----------------- | -------------- |
-| `Ctrl + A` | 全選 |
-| `Ctrl + C` | 複製 |
-| `Ctrl + E` | 關閉分頁 |
-| `Ctrl + H` | 隱藏/顯示隱藏的檔案、資料夾 |
-| `Ctrl + O` | 預覽檔案 |
-| `Ctrl + P` | 檔案/資料夾屬性 |
-| `Ctrl + R` | 重新載入 |
-| `Ctrl + T` | 新分頁 |
-| `Ctrl + V` | 貼上 |
-| `Ctrl + X` | 剪下 |
-| `Ctrl + W` | 離開Xplorer |
-| `Alt + ←` | 上一頁 |
-| `Alt + →` | 下一頁 |
-| `Alt + ↑` | 視窗最大化 |
-| `Alt + ↓` | 視窗最小化 |
-| `Alt + T` | 在終端機開啟 |
-| `Alt + P` | 釘選至側邊攔 |
-| `Alt + Shift + C` | 複製路徑 |
-| `F2` | 重新命名 |
-| `F5` | 重新整理 |
-| `F10` | 最小化視窗 |
-| `F11` | 最大化視窗 |
-| `Shift + N` | 新增資料夾 |
-| `Shift + Del` | 永久刪除 |
-| `Shift + Enter` | 以Code開啟 |
-| `Enter` | 開啟 |
-| `Del` | 刪除檔案 |
+| 按鍵組合 | 功能 |
+| ------------------- | ---------------------- |
+| `Ctrl + A` | 全選 |
+| `Ctrl + C` | 複製 |
+| `Ctrl + H` | Toggle Hidden Files |
+| `Ctrl + N` | New window shortcut |
+| `Ctrl + O` | Open file in preview |
+| `Ctrl + P` | 檔案/資料夾屬性 |
+| `Ctrl + R` | 重新載入 |
+| `Ctrl + T` | 新分頁 |
+| `Ctrl + V` | 貼上 |
+| `Ctrl + X` | 剪下 |
+| `Ctrl + W` | Exit Tab |
+| `Ctrl + Y` | Redo |
+| `Ctrl + Z` | Undo |
+| `Ctrl + Shift + Z` | Redo |
+| `Alt + Left Arrow` | Go Back |
+| `Alt + Right Arrow` | Go Forward |
+| `Alt + Up Arrow` | Go to parent directory |
+| `Alt + N` | New File |
+| `Alt + T` | Open in terminal |
+| `Alt + P` | Pin to sidebar |
+| `Alt + Shift + C` | Copy location path |
+| `F2` | Rename |
+| `F5` | Refresh |
+| `F10` | Minimize |
+| `F11` | Maximize |
+| `Shift + N` | New Folders |
+| `Shift + Del` | Permanent Delete |
+| `Shift + Enter` | Open in vscode |
+| `Enter` | Open |
+| `Del` | Delete file |
-:::note `重新載入` 和 `重新整理`不同的地方在於： `重新載入` 刷新內部HTML，而`重新整理` 則會刷新整個Electron進程
+:::note Difference between `reload` and `refresh` `Reload` refreshes the internal process while `Refresh` refreshes the whole process.
:::
diff --git a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/xplorer as default.md b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
index f575bfa4..e69d60f6 100644
--- a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
+++ b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/guides/xplorer as default.md
@@ -12,7 +12,7 @@
4. Navigate to `Computer\HKEY_CURRENT_USER\Software\Classes\Directory`
5. Create a key named `shell` if not existed by right and set the default key-value to `openinxplorer`
6. Create a key named `openinxplorer` under `shell`
-7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Users\User\AppData\Local\Programs\Microsoft VS Code\Code.exe" "%V"`
+7. Create a key named `command` under `openinxplorer` and set the default key-value to `"C:\Program Files\Xplorer\Xplorer.exe" "%V"`. (You may have to change `C:\Program Files\Xplorer\` to the location you installed Xplorer)
diff --git a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/intro.md b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/intro.md
index 0a6664b7..6ca0ff98 100644
--- a/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/intro.md
+++ b/docs/i18n/zh-TW/docusaurus-plugin-content-docs/current/intro.md
@@ -8,14 +8,18 @@ sidebar_position: 1
Welcome to Xplorer, A Free and Open Source (FOSS) File Explorer.
-Xplorer is a file explorer built from the ground up to be fully customizable and without customization, it also looks modern! It is cross-platform, built using Electron Technology that allowed our File Explorer to be run not only in Windows but also Linux and MacOS alike. It also allowed file preview directly inside it, not only pictures or documents but also videos!
+Xplorer is a file explorer built from ground-up to be fully customizable. And even without any customization, it already looks modern!
-## 特色
+Xplorer is a cross-platform application built using [Tauri](https://tauri.studio), and you can run it on Windows, MacOS, or Linux without having much trouble. One of the key feature is Xplorer allows you to preview the files you have directly inside Xplorer. And it's not only limited to picture or document preview, but also video preview.
-So to summarize, Xplorer's features contain:
+To summarize, Xplorer's features contain:
-- 看起來現代
+- It looks modern
- 簡單易用
- 跨平台
-- 檔案預覽，包括影片！
-- 最重要的，它是免費且開源的！ Which mean you can change components inside if you see fit and you also don't need to make your wallet go dry or break the bank.
+- [File Preview](https://xplorer.vercel.app/docs/guides/operation/#preview-file), even for videos!
+- Customizable
+- Supports multiple tab
+- Most importantly, Free and Open Source Software(FOSS), which means you can change components inside if you see fit
+
+Xplorer is currently under heavy development. You can give your suggestions and feedbacks in our [Discussions](https://github.com/kimlimjustin/xplorer/discussions/) page. If you feel comfortable in writing code using Typescript and Rust, we highly encourage you to [contribute to this project](https://xplorer.vercel.app/community/Contributing/).
diff --git a/docs/i18n/zh-TW/docusaurus-plugin-content-pages/index.jsx b/docs/i18n/zh-TW/docusaurus-plugin-content-pages/index.jsx
index a3df6202..38990cae 100644
--- a/docs/i18n/zh-TW/docusaurus-plugin-content-pages/index.jsx
+++ b/docs/i18n/zh-TW/docusaurus-plugin-content-pages/index.jsx
@@ -5,102 +5,69 @@ import Slideshow from './slideshow';
import Link from '@docusaurus/Link';
export default function Home() {
- const { siteConfig } = useDocusaurusContext();
- return (
-
-
-
-
-
File Explorer.
-
Redefined.
-
- Free and Open Source Software. Runs everywhere.
-
+ Cross-platform File Explorer. Powered by the web.
+
+
+ Built using the{' '}
+
+ Tauri Framework
+ {' '}
+ , and written using{' '}
+
+ TypeScript
+ {' '}
+ for the frontend and{' '}
+
+ Rust
+ {' '}
+ for the backend, Xplorer promises you an unprecedented experience.
+
+
+
+
+
Designed out of the box
+
Say goodbye to the old design by traditional app and say hello to this simple yet powerful design.
+
+
+
+
Supports Multiple Tabs
+
Xplorer helps you organize you files easier by supporting multiple tabs .
+
+
+
+
File Preview
+
+ Xplorer supports files preview, from images, code preview, pdfs, to videos. Learn more{' '}
+ here.
+
+ Cross-platform File Explorer. Powered by the web.
+
+
+ Built using the{' '}
+
+ Tauri Framework
+ {' '}
+ , and written using{' '}
+
+ TypeScript
+ {' '}
+ for the frontend and{' '}
+
+ Rust
+ {' '}
+ for the backend, Xplorer promises you an unprecedented experience.
+
+
+
+
+
Designed out of the box
+
Say goodbye to the old design by traditional app and say hello to this simple yet powerful design.
+
+
+
+
Supports Multiple Tabs
+
Xplorer helps you organize you files easier by supporting multiple tabs .
+
+
+
+
File Preview
+
+ Xplorer supports files preview, from images, code preview, pdfs, to videos. Learn more{' '}
+ here.
+
` : ''; // Element Result
+ for (const drive of drives) {
+ const driveName = drive.mount_point.split('/')[drive.mount_point.split('/').length - 1]; // Get name of drive
result += `
-
- `;
- return result;
-}
-export default Favorites
\ No newline at end of file
+const Favorites = async (): Promise => {
+ if (!FavoritesData) {
+ FavoritesData = new FavoritesAPI();
+ await FavoritesData.build();
+ }
+ const data = await Storage.get('favorites'); // Get user favorites data on sidebar
+ const favorites = data?.favorites ?? (await defaultFavorites());
+
+ let result = '';
+ result += `
${await Translate('Favorites')}
`;
+ const defaultFavoritesList = (await defaultFavorites()).map((favorite) => favorite.name);
+ for (const favorite of favorites) {
+ if (favorite.path === 'xplorer://Home') continue;
+ const fileData = new FileAPI(favorite.path);
+ const exists = await fileData.exists();
+ if (!exists && !(await isDefaultFavorite(favorite.path))) continue;
+ let icon = favorite.icon;
+ if (!icon) {
+ if (defaultFavoritesList.indexOf(favorite.name) === -1) {
+ const isdir = await new DirectoryAPI(favorite.path).isDir();
+ icon = await fileThumbnail(exists ? favorite.path : favorite.name, isdir ? 'folder' : 'file', false);
+ } else {
+ icon = await fileThumbnail(favorite.name.toLowerCase(), 'folder', false);
+ }
+ }
+ result += `
+
- 
- 
-