diff --git a/.README.md.un~ b/.README.md.un~ new file mode 100644 index 0000000..a16feb5 Binary files /dev/null and b/.README.md.un~ differ diff --git a/README.md b/README.md index 3dda5a5..206812f 100644 --- a/README.md +++ b/README.md @@ -13,9 +13,7 @@ Instructions: ## installation - At the moment, Bibliofile is a work-in-progress. - -I have uploaed the crate to crates.io since it is in a minimally-workable state at the moment, but if you wish to compile it yourself simply follow these directions: +Bibliofile is an ncurses-inspired ebook reader for the terminal written in Rust! There is a release available, but if you wish, you can customize the code and follow the build instructions below: ### 1 @@ -34,20 +32,21 @@ I have uploaed the crate to crates.io since it is in a minimally-workable state Clone the repository to the directory of your choice ```git - git clone https://git.whoisthisjoker.com/daniel/bibliofile + git clone https://gitea.whoisthisjoker.com/danjoredd/bibliofile ``` ### 3 cd into the directory *bibliofile*. Compile the program. This is best done with cargo. +you will need at least Cargo 1.60 to compile, as of August 2024. + ```rust - cargo build + cargo build --release ``` The executable will be in target/debug. - - Please keep in mind, at this point in development compilation success is not guaranteed. + ## running @@ -58,10 +57,6 @@ cd into the directory *bibliofile*. Compile the program. This is best done with There will be buttons at the bottom of each page that allow you to turn pages. Simply press "last" or "next" to turn the page. There are not yet any keyboard commands to turn pages, but that is the next feature I mean to implement. -## disclamers - -This program is incomplete. It will be lacking features such s searching text, skipping pages, and using the table of contents. I update this program regularly, so stay tuned! - ## license Bibliofile: A TUI epub reader inspired by DOS-era programs diff --git a/README.md~ b/README.md~ new file mode 100644 index 0000000..3dda5a5 --- /dev/null +++ b/README.md~ @@ -0,0 +1,79 @@ +# Bibliofile +### A TUI-based ebook reader inspired by NCurses-era programs! + +Bibliofile is a simplified epub reader with automatic bookmarking! + +Instructions: + + - installation + - use + - feedback + + + + ## installation + + At the moment, Bibliofile is a work-in-progress. + +I have uploaed the crate to crates.io since it is in a minimally-workable state at the moment, but if you wish to compile it yourself simply follow these directions: + + + ### 1 + + Install Rust. The full Instructions on how to do this are here: https://www.rust-lang.org/tools/install + + The easiest way of installing Rust is with the following command: + + ```bash + curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh + ``` + + + ### 2 + + Clone the repository to the directory of your choice + + ```git + git clone https://git.whoisthisjoker.com/daniel/bibliofile + ``` + + ### 3 + +cd into the directory *bibliofile*. Compile the program. This is best done with cargo. + + ```rust + cargo build + ``` + + The executable will be in target/debug. + + Please keep in mind, at this point in development compilation success is not guaranteed. + + ## running + + Running the program is simple, as at this point there is not many features. Simply run + + ```bibliofile [booknamehere.epub]``` + +There will be buttons at the bottom of each page that allow you to turn pages. Simply press "last" or "next" to turn the page. There are not yet any keyboard commands to turn pages, but that is the next feature I mean to implement. + + +## disclamers + +This program is incomplete. It will be lacking features such s searching text, skipping pages, and using the table of contents. I update this program regularly, so stay tuned! + +## license + + Bibliofile: A TUI epub reader inspired by DOS-era programs + + Copyright (C) 2023 Daniel Redd joes + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + You should have received a copy of the GNU General Public License + along with this program. If not, see .