base on The simple but flexible text editor <!-- Heading --> <br /> <p align="center"> <a href="https://github.com/curlpipe/ox/"> <img src="assets/logo.png" alt="Logo" width="150" height="150"> </a> <h1 align="center" style="font-size: 50px;">Ox editor</h1> <p align="center" style="font-size: 20px;"> The simple but flexible text editor <br><br> <div align="center" style="display:inline;"> <img src="/assets/showcase.gif?raw=true" width="100%"> </div> <br> </p>    ## About Ox is an independent text editor that can be used to write everything from text to code. If you're looking for a text editor that... 1. :feather: Is lightweight and efficient 2. :wrench: Can be configured to your heart's content 3. :package: Has useful features out of the box and a library of plug-ins for everything else ...then Ox is right up your street It runs in your terminal as a text-user-interface, just like vim, nano and micro, however, it is not based on any existing editors and has been built from the ground up. It works best on linux, but macOS and Windows are also supported. ## Selling Points ### Lightweight and Efficient - :feather: Ox is lightweight, with the precompiled binary taking up a few megabytes in storage space. - :knot: It uses a `rope` data structure which allows incremental editing, file reading and file writing, which will speed up performance, particularly on huge files. - :crab: It was built in Rust, which is a quick lower-level language that has a strong reputation in the performance department. ### Strong configurability - :electric_plug: Plug-In system where you can write your own plug-ins or choose from pre-existing ones - 💬 Discord RPC - 📗 Git integration with diffs, stats and more - 🕸️ Handy web development tools such as Emmet and live HTML viewer - ⏲️ Productivity tools such as a pomodoro timer and todo list tracker - :wrench: A wide number of options for configuration including colours, key bindings and behaviours - :moon: Ox uses Lua as a configuration language for familiarity when scripting and configuring - :handshake: A configuration assistant to quickly get Ox set up for you from the get-go ### Out of the box features - :paintbrush: Syntax highlighting - :arrow_right_hook: Undo and redo - :mag: Search and replace text - :file_folder: Opening multiple files at once - :eye: UI that shows you the state of the editor and file - :computer_mouse: You can move the cursor and select text with your mouse - :writing_hand: Convenient shortcuts when writing code - :crossed_swords: Multi-editing features such as multiple cursors and recordable macros - :window: Splits to view multiple documents on the same screen at the same time - :file_cabinet: File tree to view, open, create, delete, copy and move files ### Robustness - :globe_with_meridians: Handles double-width unicode characters like a charm, including those of the Chinese, Korean and Japanese languages and emojis - :boxing_glove: Backend has been thoroughly tested via automated unit tests - :rainbow: Automatically adapts your colour schemes to work on terminals with limited colours ## Installation To get started, please click on your operating system - :penguin: [Linux](#linux) - :window: [Windows](#windows) - :apple: [MacOS](#macos) ### Linux Here are the list of available methods for installing on Linux: - [Manually](#manual) - [Binary](#binaries) - [Arch Linux](#arch-linux) - [Fedora](#fedora) - [Debian / Ubuntu](#debian) #### Arch Linux Install one of the following from the AUR: - `ox-bin` - install the pre-compiled binary (fastest) - `ox-git` - compile from source (best) #### Fedora You can find an RPM in the [releases page](https://github.com/curlpipe/ox/releases) Install using the following command: ```sh sudo dnf install /path/to/rpm/file ``` #### Debian You can find a deb file in the [releases page](https://github.com/curlpipe/ox/releases) Install using the following command: ```sh sudo dpkg -i /path/to/deb/file ``` ### Windows Here are the list of available methods for installing on Windows: - [Manually (best)](#manual) - [Binary](#binaries) ### MacOS Here are the list of available methods for installing on macOS: - [Manually](#manual) - [Binary](#binaries) - [Homebrew](#homebrew) - [MacPorts](#macports) #### Homebrew Install `ox` from Homebrew core tap. ```sh brew install ox ``` #### MacPorts On macOS, you can install `ox` via [MacPorts](https://www.macports.org) ```sh sudo port selfupdate sudo port install ox ``` ### Binaries There are precompiled binaries available for all platforms in the [releases page](https://github.com/curlpipe/ox/releases). - For Linux: download the `ox` executable and copy it to `/usr/bin/ox`, then run `sudo chmod +x /usr/bin/ox` - For MacOS: download the `ox-macos` executable and copy it to `/usr/local/bin/ox`, then run `sudo chmod +x /usr/local/bin/ox` - For Windows: download the `ox.exe` executable and copy it into a location in `PATH` see [this guide](https://zwbetz.com/how-to-add-a-binary-to-your-path-on-macos-linux-windows/#windows-cli) for how to do it ### Manual This is the absolute best way to install Ox, it will ensure you always have the latest version and everything works for your system. You must have a working installation of the Rust compiler to use this method. Visit the website for [rustup](https://rustup.rs/) and follow the instructions there for your operating system. Now with a working version of rust, you can run the command: ```sh cargo install --git https://github.com/curlpipe/ox ``` This will take at worst around 2 minutes. On some more modern systems, it will take around 30 seconds. Please note that you should add `.cargo/bin` to your path, which is where the `ox` executable will live, although `rustup` will likely do that for you, so no need to worry too much. ## Quick Start Guide This is just a quick guide to help get you up to speed quickly with how to use the editor. You dive into more details in the documentation section below, but this quick start guide is a good place to start. ### Opening Files At the moment, you can open ox by using the command ```sh ox ``` This will open up an empty document. However, if you've just downloaded Ox, the configuration assistant will automatically start up and help you configure the editor initially. If you wish to open a file straight from the command line, you can run ```sh ox /path/to/file ``` To open and edit a file. You can provide multiple arguments of files if you wish to open more than one, for example: ```sh ox file1.txt file2.txt ``` You can also open a file from within Ox by using the <kbd>Ctrl</kbd> + <kbd>O</kbd> key binding If at any time, you wish to create a new file, you can use <kbd>Ctrl</kbd> + <kbd>N</kbd> to do so. You can find more command line options for Ox by typing: ```sh ox --help ``` When you open multiple files, notice the tabs at the top. You can close the file you're looking at using the <kbd>Ctrl</kbd> + <kbd>Q</kbd> key binding. When no more documents are open, the editor will automatically close for you. If you want to move tabs and look at other files that are open, you can use <kbd>Shift</kbd> + <kbd>Left</kbd> and <kbd>Shift</kbd> + <kbd>Right</kbd> to move back and forth respectively. ### Editing Files There are no modes in Ox, so you can just type straight into an open file, just as you would Nano, or Windows notepad. You can move the cursor around the file using the standard arrow keys. You can also use: - <kbd>PageUp</kbd> - Move up a page in the viewport - <kbd>PageDown</kbd> - Move down a page in the viewport - <kbd>Home</kbd> - Go to the start of the current line - <kbd>End</kbd> - Go to the end of the current line - <kbd>Ctrl</kbd> + <kbd>Left</kbd> - Go to the previous word - <kbd>Ctrl</kbd> + <kbd>Right</kbd> - Go to the next word - <kbd>Ctrl</kbd> + <kbd>Up</kbd> - Go to the top of the document - <kbd>Ctrl</kbd> + <kbd>Down</kbd> - Go to the bottom of the document No surprises here, to insert characters, use the letters and numbers on your keyboard. <kbd>Enter</kbd> will put a new line in, <kbd>Tab</kbd> will create a tab (or indent) and <kbd>Backspace</kbd> / <kbd>Delete</kbd> to delete characters. If you modify a file, you may notice a `[+]` symbol, this means the file has been modified without saving. You can save a document in many ways, including <kbd>Ctrl</kbd> + <kbd>S</kbd> to save it to the file it was opened from. <kbd>Ctrl</kbd> + <kbd>A</kbd> to save all files that are open and <kbd>Alt</kbd> + <kbd>S</kbd> to save as, where a prompt for a new file name to write to will be shown. We've covered most keyboard shortcuts, but there are some other features you might want to make use of, the following table shows the keyboard shortcuts we haven't covered yet. | Keybinding | What it does | | ------------ | ------------ | | `Ctrl + F` | Searches the document for a search query. Allows pressing of <kbd>←</kbd> to move the cursor to the previous occurrence of the query and <kbd>→</kbd> to move to the next occurrence of the query. Press <kbd>Return</kbd> or <kbd>Esc</kbd> to leave the search. Note: you can use regular expressions for search queries. | | `Ctrl + Z` | Undoes your last action. The changes are committed to the undo stack every time you press the space bar, create / destroy a new line and when there is no activity after a certain period of time which can be used to capture points where you pause for thought or grab a coffee etc... | | `Ctrl + Y` | Redoes your last action. The changes are committed to the undo stack every time you press the space bar, create / destroy a new line and when there is no activity after a certain period of time which can be used to capture points where you pause for thought or grab a coffee etc... | | `Ctrl + R` | Allows replacing of occurrences in the document. Uses the same keybindings as the search feature: <kbd>←</kbd> to move the cursor to the previous occurrence of the query and <kbd>→</kbd> to move to the next occurrence of the query. You can also press <kbd>Return</kbd> to carry out the replace action. To exit replace mode once you're finished, you can press <kbd>Esc</kbd>. You can also use <kbd>Tab</kbd> to replace every instance in the document at once. Note: you can use regular expressions for search queries. | | `Ctrl + K` | Opens the command line. | | `Ctrl + W` | Shortcut to delete a whole word. | | `Alt + Up` | Move the current line up. | | `Alt + Down`| Move the current line down. | | `Ctrl + D` | Delete the current line. | | `Ctrl + C` | Copy selected text. | | `Alt + Left`| Move to the previous tab. | | `Alt + Right`| Move to the next tab. | ### Configuration Ox features a configuration system that allows the editor to be modified and personalised. By default, you will be greeted by a configuration assistant when first starting Ox, when no configuration file is in place. This will help you generate a configuration file. By default, Ox will look for a file here: `$XDG_CONFIG_HOME/.oxrc` or `~/.oxrc`. On Windows, Ox will try to look here `C:/Users/user/ox/.oxrc` (where `user` is the user name of your account) Ox's configuration language is [Lua](https://lua.org). For reference, there is a default config in the `config` folder in the repository. You can either download it and place it in the default config directory or create your own using the example ones as a reference. ## Documentation If you've been through the quick start guide above, but are looking for more detail, you can find in-depth documentation on the [wiki page](https://github.com/curlpipe/ox/wiki/) This will take you step-by-step in great detail through 6 different stages: 1. **Installation** - advice and how-tos on installation 2. **Configuring** - changing the layout, adding to and changing the syntax highlighting 3. **General Editing** - editing a document and controlling the editor 4. **Command Line** - using the command line interface 5. **Plugins** - installing or uninstalling community plug-ins and writing or distributing your own plug-ins 6. **Roadmap** - planned features Hopefully, it contains everything you need to take you from a beginner to a power user. ## License Distributed under the GNU GPLv2 License. See `LICENSE` for more information. ## Contact You can contact me on Discord at my handle `curlpipe`. I'll be happy to answer any questions you may have! ## Acknowledgements - [Luke (curlpipe)](https://github.com/curlpipe), principal developer - [HKalbasi](https://github.com/HKalbasi), key contributor - [Spike (spikecodes)](https://github.com/spikecodes), for the logo - The community, for the stars, ideas, suggestions and bug reports The creators of the following technologies: * [Rust language](https://rust-lang.org) * [Kaolinite](https://github.com/curlpipe/kaolinite) * [Synoptic](https://github.com/curlpipe/synoptic) * [Crossterm](https://github.com/crossterm-rs/crossterm) * [Mlua](https://github.com/mlua-rs/mlua) * [Jargon-args](https://crates.io/crates/jargon-args) * [Regex](https://docs.rs/regex/1.3.9/regex/) * [Unicode-rs](https://unicode-rs.github.io/) * [Quick-error](https://github.com/tailhook/quick-error) * [Shellexpand](https://github.com/netvl/shellexpand) ", Assign "at most 3 tags" to the expected json: {"id":"5172","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"