luciano/clojure-koans
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

update README.md, more than half is translated

Browse source
This commit is contained in:
brannx 2018-03-13 14:33:53 +03:00 committed by GitHub
parent faa02b5fae
commit 98c3162220
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 52 additions and 61 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

113
README.md
View file

@ -1,48 +1,43 @@
# Clojure Koans # Clojure Koans
The Clojure Koans are a fun way to get started with Clojure - no experience Для того чтобы приступить к решению Clojure коанов, следуйте инструкциям ниже.
assumed or required. Follow the instructions below to start making tests pass!
## Getting Started ## Getting Started
I recommend starting from a cloned or forked repo. This way you'll be able to Прежде всего клонируйте репозиторий или создайте свой форк. Далее вы можете создать отдельную ветку
track your progress in Git. You might want to create your own branch - that way чтобы избежать конфликтов при обновлении кланов.
if you pull back the latest koans from master, it'll be a bit easier to manage
the inevitable conflicts if we make changes to exercises you've already
completed.
You have a few options for installation: Способы установки зависимостей:
- Install the dependencies for the koans (such as Clojure) on your machine - Установите все зависимости локально
- Use Vagrant and the configuration in this repository - Используйте Vagrant
- Use Docker - Используйте Docker
Instructions for each option are below! Инструкции для каждого для реализации каждого способа ниже.
### Installation on Your Machine ### Локальная установка
The only things you'll need to run the Clojure Koans are: Вам необходимо:
- JDK (I suggest version 8, but anything 6 or above should work fine) - JDK (от 6 до 8 версии)
- [Leiningen](http://github.com/technomancy/leiningen), a build tool for Clojure - [Leiningen](http://github.com/technomancy/leiningen), инструмент сборки для Clojure
Once you've cloned this repo and installed the dependencies, you can run: После этого выполните в клонированной папке:
``` ```
lein repl lein repl
``` ```
to make sure all the dependencies get downloaded properly (and then `(exit)` Leiningen скачает все зависимости, затем наберите `(exit)` чтобы выйти.
when you want to quit). See below for details on the REPL.
### Installation with Vagrant ### Установка, используя Vagrant
Make sure you have [Vagrant](https://www.vagrantup.com/) and Установите [Vagrant](https://www.vagrantup.com/) и
[VirtualBox](https://www.virtualbox.org) installed. [VirtualBox](https://www.virtualbox.org).
In the root directory of the project, execute: В корневой директории выполните:
``` ```
vagrant up vagrant up
@ -52,39 +47,38 @@ lein koan run
``` ```
### Installation with Docker ### Установка, используя Docker
Once you've got [Docker](https://www.docker.com/) installed, you're basically Установите [Docker](https://www.docker.com/), затем выполните:
all set. You can run these commands to get started:
To run koans: для запуска коанов:
``` ```
docker run --rm -it -v $(pwd):/app -w /app clojure lein koan run docker run --rm -it -v $(pwd):/app -w /app clojure lein koan run
``` ```
To start up a REPL: для запуска REPL:
``` ```
docker run --rm -it -v $(pwd):/app -w /app clojure lein repl docker run --rm -it -v $(pwd):/app -w /app clojure lein repl
``` ```
## Running the Koans ## Запуск коанов
Run the koans via: Команда:
`lein koan run` `lein koan run`
If want to run directly from a REPL, once you are inside the `lein repl` prompt you can run the koans with Для запуска из REPL:
`(exec "run")` `(exec "run")`
Either way, it's an auto-runner, so as you save your files with the correct В любом случае программа запустится и будет ожидать сохранения файла с коанами
answers, it will advance you to the next koan or file (conveniently, all files и даст вам знать правильно ли было решение или нет.
are prefixed with the sequence that you should follow). Каждый коан сопровождён указаниями и направляющими вопросами.
You'll see something like this: Пример:
Now meditate on /home/colin/Projects/clojure-koans/src/koans/01_equalities.clj:3 Now meditate on /home/colin/Projects/clojure-koans/src/koans/01_equalities.clj:3
--------------------- ---------------------
@ -92,9 +86,9 @@ You'll see something like this:
We shall contemplate truth by testing reality, via equality. We shall contemplate truth by testing reality, via equality.
(= __ true) (= __ true)
The output is telling you that you have a failing test in the file named Программа сообщает вам о том, что в файле `01_equalities.clj`, строка 3 тест не пройдён
`01_equalities.clj`, on line 3. So you need to open that file up and make и коан не решён. Подумайте и внесите изменения!
it pass! You'll always be filling in the blanks to make tests pass. Вам всегда будет предложено заполнить пустое место,обозначенное символами подчёркивания.
Sometimes there could be several correct answers (or even an infinite number): Sometimes there could be several correct answers (or even an infinite number):
any of them will work in these cases. Some tests will pass even if you replace any of them will work in these cases. Some tests will pass even if you replace
the blanks with whitespace (or nothing) instead of the expected answer. Make sure the blanks with whitespace (or nothing) instead of the expected answer. Make sure
@ -141,43 +135,40 @@ will show you what those commands mean.
You can exit the REPL with `CTRL-d`, `(exit)`, or `(quit)`. You can exit the REPL with `CTRL-d`, `(exit)`, or `(quit)`.
## Contributing ## Развитие
Patches are encouraged! Make sure the answer sheet still passes Убедитесь, что (`lein koan test`) пройдены и присылайте патчи в pull request.
(`lein koan test`), and send a pull request.
The file ideaboard.txt has lots of good ideas for new koans to start, or things Файл ideaboard.txt содержит различные идеи для реализации новых или изменения текущих коанов.
to add to existing koans. So write some fun exercises, add your answers to Ответы на упражнения пишите в `resources/koans.clj`!
`resources/koans.clj`, and we'll get them in there!
Please follow the guidelines in Следуйте эти рекомендациям
http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html for http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html.
commmit messages, and put your code in a feature branch (not master) before Для упрощения оценки ваших патчей, — сохраняйте код в feature ветку (не master) перед pull request.
making the pull request. This makes patches easier to review.
Feel free to contact me (Colin Jones / trptcolin) on Github or elsewhere if you Если у вас остались вопросы или нужны рекомендации,
have any questions or want more direction before you start pitching in. связывайтесь со мной (Colin Jones / trptcolin) через Github или иным способом.
## Contributors ## Участники
https://github.com/functional-koans/clojure-koans/contributors https://github.com/functional-koans/clojure-koans/contributors
## Credits ## Благодарность
These exercises were started by [Aaron Bedra](http://github.com/abedra) of Эти упражнения создавались [Aaron Bedra](http://github.com/abedra)
[Relevance, Inc.](http://github.com/relevance) in early 2010, as a learning [Relevance, Inc.](http://github.com/relevance) в начале 2010 как инструмент
tool for newcomers to functional programming. Aaron's macro-fu makes these для изучения функционального программирования для новичков.
koans clear and fun to use and improve upon, and without Relevance's Макрос-фу Аарона делали эти коаны доступными для использования и изучения языка,
initiative, this project would not exist. а также для их дальнейшей разработки и улучшения.
Без инициативы со стороны Relevance Inc. этот проект не был бы осуществлён.
Using the [koans](http://en.wikipedia.org/wiki/koan) metaphor as a tool for Использование впервые [коанов](http://en.wikipedia.org/wiki/koan) в качестве метафоры
learning a programming language started with the для обучающих упражнений было заслугой [Ruby Koans](http://rubykoans.com) от [EdgeCase](http://github.com/edgecase).
[Ruby Koans](http://rubykoans.com) by [EdgeCase](http://github.com/edgecase).
## License ## Лицензия
The use and distribution terms for this software are covered by the The use and distribution terms for this software are covered by the
Eclipse Public License 1.0 (http://opensource.org/licenses/eclipse-1.0.php) Eclipse Public License 1.0 (http://opensource.org/licenses/eclipse-1.0.php)