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
137 Commits
2 Branches
0 Tags
7.1 MiB
JavaScript 74.4%
CSS 20.1%
HTML 5.5%
 
 
 
Go to file
Brogan Clements 3859b0de50 Update github action to use the parser at EbookFoundation/free-programming-books-parser 2022-04-25 15:51:38 -04: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 Remove Default and SectDropdown as they are no longer used 2022-04-25 14:11:46 -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 README: add line about the search index being updated daily 2022-04-25 15:50:54 -04:00
fpb.json update fpb.json 2022-04-22 04:45:41 +00:00
package-lock.json Correct issues with id linking 2022-04-04 00:55:37 -04:00
package.json Add comments and bugfixes to MarkdownParser and ParsedLink 2022-04-25 13:53:58 -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 -g
  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:.github.io/free-programming-books-search/"