EbookFoundation
/
free-programming-books-search
mirror of https://github.com/EbookFoundation/free-programming-books-search.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
144 Commits
2 Branches
0 Tags
7.1 MiB
JavaScript 74.4%
CSS 20.1%
HTML 5.5%
 
 
 
Go to file
David Ordás ca50ecd8b1
remove trailing spaces to fix markdownlint rule: MD009/no-trailing-spaces [Expected: 0 or 2; Actual: 1] 		2022-04-30 19:12:55 +02:00
.github/workflows Update github action to use the parser at EbookFoundation/free-programming-books-parser 2022-04-25 15:51:38 -04:00
public Update page title 2022-02-17 18:34:43 -05:00
src updated REadme. Also dark mode is now changed based on browser pref 2022-04-25 18:04:25 -04:00
.gitignore Transfer the webpage from a personal repo to this one 2022-01-27 14:47:59 -06:00
LICENSE Initial commit 2022-01-27 13:01:18 -05:00
README.md remove trailing spaces to fix markdownlint rule: MD009/no-trailing-spaces [Expected: 0 or 2; Actual: 1] 2022-04-30 19:12:55 +02:00
fpb.json update fpb.json 2022-04-29 00:01:30 +00:00
package-lock.json updated REadme. Also dark mode is now changed based on browser pref 2022-04-25 18:04:25 -04:00
package.json updated REadme. Also dark mode is now changed based on browser pref 2022-04-25 18:04:25 -04:00

README.md

free-programming-books-search

The free-programming-books-search is a companion project of free-programming-books. It allows users to search by book title or author and filter by language. The search index is updated once per day, so changes made on free-programming-books may not be immediately reflected.

Contents

Installation

NPM Installation

  1. Make sure you have Node.js installed. If you already do, skip to Running the Website
  2. Otherwise, download the LTS installer from Node.js website.
  3. Follow the instructions of the installer, make sure npm is listed as a package to be installed.
  4. Click Install.
  5. Verify that Node.Js has been installed by going to command line and typing in node. It should show the current version.
  6. Close out of Node by either closing and reopening the command line or with Ctrl + C.
  7. Make sure to check out the NPM website for more info.

Running the Website

  1. Make sure you have Git installed.
  2. Clone the repo from Github with Git.
  3. Navigate to the folder using command line. (easy way is to type "cd" and then drag and drop the folder into command line)
  4. Type npm install
  5. Type npm install react-scripts
  6. Type npm start. At this point, the commnand prompt should start up the server, and a tab in your default browser should open up to localhost.

Deployment

MAKE SURE YOU HAVE COMPLETED THE INSTALLATION STEPS FIRST!

  1. First, make sure that you the local folder containing the files has a remote configured called "origin".
    1. If you aren't sure, navigate to the folder using Git (type "cd", then drag and drop folder in to Git command line.).
    2. Type git init
    3. Type git remote add origin <repo url>,replacing with the url of your github repository.
  2. Now, run npm install -g gh-pages.
  3. Run npm run deploy.
  4. This should deploy your code to "https:yourusername.github.io/free-programming-books-search/"

How It All Works

  1. THERE IS NO DATABASE INVOLVED. Rather, the books are stored in a markdown on free-programming-books and is parsed daily by free-programming-books. The books and all info pertaining to them are stored in a json file called fpb.json.

  2. This Json is downloaded locally and searched locally when the actual search function is used.

FAQ

  • What database are we using to store the books?

    • NONE! The books are stored in a json file which is downloaded locally.

  • I added a book but it's not showing up on search?

    • Give it some time. The parser is run once a day, so it may tak up to 24 hours for the search to reflect that.