7.0k sao GitHub và vẫn tăng — Gazler/githug là dự án Shell mà TopGit đang theo dõi trên nền tảng. Git your game on!
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Githug is designed to give you a practical way of learning git. It has a series of levels, each requiring you to use git commands to arrive at a correct answer.
Playing Githug
Githug should work on Linux, OS X and Windows.
Prerequisites
Githug requires Ruby 1.8.7 or higher.
You can check which version of Ruby is installed with the following command:
ruby --version
If ruby is not installed, follow the installation instructions on ruby-lang.org.
Installation
To install Githug, run
gem install githug
If you get a complaint about permissions, you can rerun the command with sudo:
sudo gem install githug
Usage with Docker
An unofficial Docker image for this project by @odiraneyya is available on (Docker Hub).
Starting the Game
After the gem is installed change directory to the location where you want the game-related assets to be stored.
Then run githug:
githug
You will be prompted to create a directory.
No githug directory found, do you wish to create one? [yn]
Type y (yes) to continue, n (no) to cancel and quit Githug.
Commands
Githug has 4 game commands:
play - The default command, checks your solution for the current level
hint - Gives you a hint (if available) for the current level
reset - Reset the current level or reset the level to a given name or path
levels - List all the levels
Change Log
The change log is available on the wiki. Change log
Contributing
To suggest a level or create a level that has been suggested, check out the wiki.
Get yourself on the contributors list by doing the following:
Fork the repository
Make a level in the levels directory (covered below)
Add your level to the LEVELS array inside lib/githug/level.rb in a position that makes sense (the "commit" level after the "add" and "init" levels for example)
Make sure your level works (covered below)
Submit a pull request
Todo List
A follow-up to the level, more information on a specific command, etc.
More levels!
Writing Levels
Githug has a DSL for writing levels. Here is an example:
difficulty 1
description "There is a file in your folder called README, you should add it to your staging area"
setup do
repo.init
FileUtils.touch("README")
end
solution do
return false unless repo.status.files.keys.include?("README")
return false if repo.status.files["README"].untracked
true
end
hint do
puts "You can type `git` in your shell to get a list of available git commands"
end
difficulty, description and solution are required.
You can include multiple hints like this:
hints [
"You can type `git` in your shell to get a list of available git commands",
"Check the man for `git add`"]
By default, setup will remove all files from the game folder. You do not need to include a setup method if you don't want an initial git repository (if you are testing git init or only checking an answer.)
You can call repo.init to initialize an empty repository.
All methods called on repo are sent to the grit gem if the method does not exist, and you can use that for most git related commands (repo.add, repo.commit, etc.).
Another method exists called init_from_level and it is used like so:
setup do
init_from_level
end
This will copy the contents of a repository specified in the levels folder for your level. For example, if your level is called "merge" then it will copy the contents of the "merge" folder. It is recommended that you perform the following steps:
mkdir "yourlevel"
cd "yourlevel"
git init
some git stuff
important rename ".git" to ".githug" so that it isn't treated as a submodule
cd "../"
git add "yourlevel"
After doing this, your level should be able to copy the contents from that git repository and use those for your level. See the "blame" level for an example of this.
Testing Levels
The easiest way to test a level is:
Change into your git_hug repository
Run githug reset PATH_TO_YOUR_LEVEL
Solve the level
Run githug test PATH_TO_YOUR_LEVEL
Please note that the githug test command can be run as githug test --errors to get an error stack trace from your solve method.
It would be ideal if you add an integration test for your level. These tests live in spec/githug_spec and must be run in order. If you add a level but do not add a test, please add a simple skip_level test case similar to the contribute level.
FAQs
Answers are not being checked properly
This is a common issue we are facing and we are actively working to fix it.
For now, run the following commands to change the default branch name to master. This should fix most of the issues you may face.
Gazler/githug thuộc nhóm Developer Tools trên TopGit, cùng 1 topic GitHub. Trang Trending và Topics liệt kê các repo cùng số sao và cùng ngôn ngữ để so sánh.
Đọc thêm về Gazler/githug ở đâu?
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/Gazler/githug là nguồn chính thức.
Gazler/githug có phải mã nguồn mở không?
Có — Gazler/githug phát hành theo license MIT, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/Gazler/githug.
Gazler/githug là gì?
Gazler/githug (Gazler/githug) là dự án Shell trên GitHub. Theo mô tả gốc: Git your game on!
Gazler/githug so với các dự án Developer Tools khác thế nào?
Gazler/githug được TopGit xếp vào nhóm Developer Tools, với 7.0k sao GitHub và viết bằng Shell. Xem trang chủ đề Developer Tools trên TopGit để so sánh với các dự án tương tự theo số sao và mức độ hoạt động.
Vì sao Gazler/githug được xếp vào nhóm Developer Tools?
TopGit xếp Gazler/githug vào nhóm Developer Tools dựa trên GitHub topics và mô tả của repo (gắn thẻ: "git"). Việc phân loại dựa trên metadata thật của repo, không phải đoán theo cảm tính biên tập.
Đọc đầy đủ README ở tab phía trên.
Chưa chắc githug có hợp với bạn?
Để ChatGPT, Claude hoặc Perplexity tìm hiểu giúp — bấm bên dưới và xem AI nói gì về githug.