From 677f430dd530e73b804a8094a24caf78226071bf Mon Sep 17 00:00:00 2001 From: dan Date: Thu, 29 Aug 2024 19:33:01 -0500 Subject: [PATCH] updated readme --- .README.md.un~ | Bin 0 -> 7121 bytes README.md | 17 ++++------- README.md~ | 79 +++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 85 insertions(+), 11 deletions(-) create mode 100644 .README.md.un~ create mode 100644 README.md~ diff --git a/.README.md.un~ b/.README.md.un~ new file mode 100644 index 0000000000000000000000000000000000000000..a16feb5f0bd0643ef62bdcfc950824220df892b1 GIT binary patch literal 7121 zcmeI1&x;&I6vt;b@mJhvG$nBP&0pVdZcJ<`hqkOtCdik5~1DjpThL5(P_pP8ro>Cxm@koO7bz&J5Vf0tnVUdou+ z_AY3Q;`8!&kg(8FxI&jsR8Pr4Y z(g?i@z`lPiSelAVf!tX4rwaME7*v2o%}nQ6g08gXn&gmPg@Qz&cKy9{bIwOV}O*VKPgz_h`4 zX0mpTtc+i@qq?HPdz+)-cI~yDVf>=9YneG~-HMCwT5?nCEEre%z0Q~DJGUg3qF+Tn z9nwT%n0_wdOCP1a6!ZTxn6Ay#9VTMAHCY0Yor7-i-VpM%LZ1RmKc$!+!el$ph-phQ zRnMJF8)IXZCZgMtMG@b_(BTD~7^S~UAp12%HtEdI8HwN}dCqEuoVe7wVgg3`&36uS zEi!WDOo=pGO0KVH>niTP1jQ24tYQKc-((r~Tg=|23o>t1t;(QvKJG%6ypM6VPUs6< zL@PtcMoaY7g8y$R|1l@@JX79xwE8wyKWq*no^2U<)UhyUVS2h%Sf{{s&E Bp-BJ$ literal 0 HcmV?d00001 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 .