Name: ago
Owner: gophergala2016
Description: ago is _a go_ program.
Created: 2016-01-23 04:20:22.0
Updated: 2017-05-02 02:14:28.0
Pushed: 2017-03-28 06:46:06.0
Size: 57
Language: Go
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
ago
is a go program.
The name will be changed in future, maybe.
In short, the program chooses useful words in specific documents that need to be understanded well and helps user to understand them well. The help will be made by listing the each word and its meaning, and let user to test whether he is understanding the word well in himself. The self test result will feedback the important word election.
This program has made for author's english vocabulary memorization training. Because the description of the program is general, however, the program can be used for wider general case. For example, terminologies for specific area such as computer science or mathematics.
At first, the program receives multiple specific documents. The documents could be pdf, url, etc in future. For now, however, it receives text file only. The program counts frequency of each word in the documents. Words that used frequently be measured as important.
After that, when user requires, the program shows the each word in importance order. For each word, the program gives the user to remember the meaning of the word. When user let program knows he has spent enough time to remember, program shows the meaning of the word and few useful informations about the word to user. User can let the program knows whether he remembered the meaning well or not. If user says he is remembering the meaning well, importance of the word becomes lower. In other case, the importance becomes higher.
Basic usage is similar to other familiar CLI tools like git
, perf
, etc.
The usage is as below:
<command> [arguments ...]
In short, ago supports several subcommands with optional arguments for thse subcommands. User can use those subcommands to manage documents and words.
Commands are:
add-docs
: Put one or more documents under management of ago
. Currently,
only text file is supported. User can specify files they want to add by
giving path to the files as argument. ago
automatically extracts words
inside the documents into its internal storage and manage their importance
with referenced count and user feedback.ls-docs
: List currently added documents. Output of the command is name of
document and its id. Because different documents may have same name, a
document should be identified by the id.rm-docs
: Remove one or more documents from ago
. User should give id(s) of
documents they want to remove as argument. Removed documents not be
displayed via ls-docs
and words under the documents will be removed from
ago
, too.`dic
: Search meaning of a word and its usage example using dictionary.
Currently, it uses Daum English-Korean Dictionary[1] service. However, as
the design says, it can be alternated to English dictionary or other in
future as user want. This command is quite useful for non-English native
terminal familiar hacker. In the case, he can reduce time consumed by
dictionary searching because terminal is close and dictionary on browser or
book shelf is far.test
: Start a self test. Within test, ago
gives a important word and
gives time for user to remember the meaning of the word. After that, user
can signal ago
. ago
shows real meaning and usage example of the word to
user by using the dic
command internally. After that, user can feedback
ago
whether he remembered the meaning well or not. The feedback be used to
calculate the importance of the word.Below is an example of ago
usage. It has lots of assumptions not described
here. However, clever one like you may understand the meaning well ;)
ago ls-docs
ago add-docs ~/linux/README ~/linux/Documentation/SubmittingPatches
ago ls-docs
EADME
ubmittingPatches
ago rm-docs 1
ago ls-docs
EADME
ago dic hack
ing
?? ??? ? ????
ples
attacks have been conducted by an iPhone-hacking wonder kid.
?? (Teentimes) ? ??? ??? ?? ?? ??? ?? ??? ??.
seems as if a series of hacking incidents are plaguing the nation.
?? (Teentimes) ??? ?? ???? ??? ???? ? ??.
king companies to "help them" in the long run is still unjustified.
?? (Teentimes) "??? ?? ??" ?? ???? ?? ????? ???.
Statement: Hacks can be used as a powerful and effective artistic
ression.
?? (Teentimes) 2? ??: ??? ???? ???? ??? ????
? ??.
ing said that Nintendo has been hacked and Sony has been hacked twice.
?? (Teentimes) ???? ?? ???? ??? ??? ??? ? ???
???.
???
ago test
the game begin
y? (Yes/[No])
==========================================
tion 1/5:
the ]]
s Enter after you remember the meaning of it:
erence: 185 Test success/fail: 0/0
------------------------------------------
maning of the was:
ing
???? ????
ple
problems do not magically disappear, but you may feel better.
?? (Kidstimes) ? ???? ???? ????? ???, ?? ???
?? ??.
ry point that you do not challenge makes your opponent's argument stronger.
?? (Kidstimes) ??? ??? ???? ?? ?? ??? ??? ????
?? ??? ????.
ike can become more so if you attach Fontus to the bike.
?? (Kidstimes) ?? ???? ???? Fontus? ?????, ??? ??
? ? ????.
can donate money to the NoPhone project on a website.
?? (Kidstimes) ??? ?????? ?? ????? ?? ??? ?
?.
e you do, learning it will become fun instead of work.
?? (Kidstimes) ?? ??? ??, ??? ??? ?? ??? ?? ??
? ? ????.
???
------------------------------------------
you understanding it well? (Yes/No)
feedback, Yes applied
------------------------------------------
==========================================
tion 2/5:
to ]]
s Enter after you remember the meaning of it:
erence: 83 Test success/fail: 0/0
GPL v3
SeongJae Park (sj38.park@gmail.com)