请选择 进入手机版 | 继续访问电脑版
  • 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    公众号

jwasham/computer-science-flash-cards: Mini website for testing both general CS k ...

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称:

jwasham/computer-science-flash-cards

开源软件地址:

https://github.com/jwasham/computer-science-flash-cards

开源编程语言:

HTML 53.6%

开源软件介绍:

Computer Science Flash Cards

This is a little website I've put together to allow me to easily make flash cards and quiz myself for memorization of:

  • General cs knowledge
    • vocabulary
    • definitions of processes
    • powers of 2
    • design patterns
  • Code
    • data structures
    • algorithms
    • solving problems
    • bitwise operations

Will be able to use it on:

  • desktop
  • mobile (phone and tablet)

It uses:

  • Python 3
  • Flask
  • SQLite

About the Site

Here's a brief rundown: https://startupnextdoor.com/flash-cards-site-complete/

Screenshots

UI for listing cards. From here you can add and edit cards.

Card UI


The front of a General flash card.

Memorizing general knowledge


The reverse (answer side) of a Code flash card.

Code view

Important Note

The set included in this project (cards-jwasham.db) is not my full set, and is way too big already.

Thanks for asking for my list of 1,792 cards. But it’s too much. I even printed them out. It’s 50 pages, front and back, in tiny text. It would take about 8 hours to just read them all.

My set includes a lot of obscure info from books I’ve read, Python trivia, machine learning knowledge, assembly language, etc.

I've added it to the project if you want it (cards-jwasham-extreme.db). You've been warned.

Please make your own set, and while you’re making them, only make cards for what you need to know. Otherwise, it gets out of hand.

How to convert to Anki or CSV

If you don't want to run a server, you can simply use Anki or a similar service/app. Use this script to convert from my sets (SQLite .db file), or yours, to CSV:

https://github.com/eyedol/tools/blob/master/anki_data_builder.py

Thanks @eyedol

Anki Flashcards:

Thanks @JackKuo-tw

How to run it on a server

  1. Clone project to a directory on your web server.
  2. Edit the config.txt file. Change the secret key, username and password. The username and password will be the login for your site. There is only one user - you.
  3. Follow this long tutorial to get Flask running. It was way more work than it should be: https://www.digitalocean.com/community/tutorials/how-to-serve-flask-applications-with-uwsgi-and-nginx-on-ubuntu-16-04
    • wsgi.py is the entry point. It calls flash_cards.py
    • This is my systemd file /etc/systemd/system/flash_cards.service: view
      • you can see the paths where I installed it, and the name of my virtualenv directory
    • when done with tutorial:
    sudo systemctl restart flash_cards
    sudo systemctl daemon-reload
  4. When you see a login page, you're good to go.
  5. Log in.
  6. Click the "General" or "Code" button and make a card!
  7. When you're ready to start memorizing, click either "General" or "Code" in the top menu.

How to run it on local host (Quick Guide)

Provided by @devyash - [email protected] - Reach out to this contributor if you have trouble.

  1. Install dependencies:
    1. Install Python
    2. Add python as environment variable windows
    3. To install pip, securely download get-pip.py
    4. Run python get-pip.py in terminal
    5. Add pip to your PATH system variable windows
    6. Run pip install -r requirements.txt in terminal after going to correct folder
  2. Type python flash_cards.py - if you get error for flask then use python -m pip install Flask first then run flash_card.py file
  3. Open localhost:5000/
  4. Login using 'admin' and 'default' for the username and password, respectively.

NOTE: If you wish to use John's flash cards then also do following steps:

  1. Copy db files such as cards-jwasham-extreme OR cards-jwasham and paste them in db folder
  2. Edit file flash_cards.py line 8 and replace 'cards.db' with any of the other database files e.g.('cards-jwasham.db')
  3. Repeat the above steps from step 3

Every time you wish to run your db just open folder in terminal and run python flash_cards.py

How to run with Docker

Provided by @Tinpee - [email protected] - Reach out to this contributor if you have trouble.

Make sure you already installed docker and optionally docker-compose

  1. Clone project to any where you want and go to source folder.
  2. Edit the config.txt file. Change the secret key, username and password. The username and password will be the login for your site. There is only one user - you.
  3. Build image:
    • Docker: docker build . -t cs-flash-cards
    • Compose: docker-compose build
  4. Run container:
    • Docker: docker run -d -p 8000:8000 --name cs-flash-cards cs-flash-cards
    • Compose: docker-compose up
  5. Go your browser and type http://localhost:8000

If you already had a backup file cards.db. Run following command:

Note: We don't need to rebuild image, just delete old container if you already built.

docker run -d -p 8000:8000 --name cs-flash-cards -v <path_to_folder_contains_cards_db>:/src/db cs-flash-cards
  • <path_to_folder_contains_cards_db>: is the full path contains cards.db.
  • Example: /home/tinpee/cs-flash-cards/db, and cards.db is inside this folder.

For convenience, if you don't have cards.db, this container will auto copy a new one from cards-empty.db.


How to backup data ?

We just need store cards.db file, and don't need any sql command.

  • If you run container with -v <folder_db>:/src/db just go to folder_db and store cards.db anywhere you want.
  • Without -v flag. Type: docker cp <name_of_container>:/src/db/cards.db /path/to/save

How to restore data ?

  • Delete old container (not image): docker rm cs-flash-cards
  • Build a new one with -v flag: docker run -d -p 8000:8000 --name cs-flash-cards -v <path_to_folder_contains_cards_db>:/src/db cs-flash-cards
  • Voila :)

How to deploy docker file on heroku

- export CARDS_SETTINGS=/src/config.txt
gunicorn --bind  0.0.0.0:$8000 flash_cards:app
+ export CARDS_SETTINGS=/src/config.txt
gunicorn --bind  0.0.0.0:$PORT flash_cards:app
  • deploy docker file with following commands
heroku login
heroku container:login
heroku create
# Creating app... done, ⬢ your-app-name
heroku container:push web --app your-app-name
heroku container:release web --app your-app-name
heroku open --app your-app-name

Alternative for Node fans

@ashwanikumar04 put together an alternative flash cards site running Node: https://github.com/ashwanikumar04/flash-cards

Check out the demo!

Happy learning!




鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap