Added README.org

Signed-off-by: TuDatTr <tuan-dat.tran@tudattr.dev>
master
TuDatTr 2023-06-10 22:07:36 +02:00
parent 7976bdc248
commit 1e4cee6b03
1 changed files with 63 additions and 0 deletions

63
README.org Normal file
View File

@ -0,0 +1,63 @@
#+title: gsearch
gsearch is a command-line tool based on gscite that allows you to quickly search for citations. It provides a convenient way to retrieve references based on a search term and display them in BibTeX format.
* Installation
To use gsearch, you need to have Rust and Cargo installed on your system. If you don't have them installed, you can follow the official Rust installation guide at [[https://www.rust-lang.org/tools/install][https://www.rust-lang.org/tools/install]].
Once you have Rust and Cargo set up, you can clone the gsearch repository from GitHub:
#+begin_src shell
git clone https://github.com/your_username/gsearch.git
#+end_src
Change to the project directory:
#+begin_src shell
cd gsearch
#+end_src
Build the project using Cargo:
#+begin_src shell
cargo build --release
#+end_src
After a successful build, you can find the gsearch binary in the target/release directory.
* Usage
To search for citations using gsearch, you need to provide a search term as a command-line argument. Here's an example:
#+begin_src shell
./gsearch --search_term "machine learning"
#+end_src
The above command will search for references related to "machine learning" and display the first reference in BibTeX format.
* Command-Line Arguments
gsearch supports the following command-line arguments:
- ~--search_term~ or ~-s~: The search term to be used for retrieving references. It is a required argument.
* Output
gsearch retrieves references using the gscite library and displays the first reference in BibTeX format. The output will be printed to the console.
* Dependencies
gsearch depends on the following libraries:
[[https://crates.io/crates/gscite][gscite]]: A Rust library for retrieving citations from Google Scholar.
[[https://crates.io/crates/futures_util][futures_util]]: A collection of utility functions and combinators for working with asynchronous Rust.
[[https://crates.io/crates/clap][clap]]: A powerful command-line argument parsing library for Rust.
* Contributing
Contributions to gsearch are welcome! If you find a bug or want to suggest an enhancement, you can open an issue on the [[https://gitlab.com/TuDatTr/gsearch/-/issues][GitLab Repository]]. If you would like to contribute code, feel free to submit a pull request.
When contributing to gsearch, please follow the existing code style and conventions. Make sure to write clear commit messages and add appropriate tests for your changes.
License
This project is licensed under the MIT License. See the [[LICENSE][LICENSE]] file for more information.
* Disclaimer
gsearch is a personal project created for educational and personal use only. It is not affiliated with or endorsed by Google Scholar. Use it responsibly and at your own risk.