Merge 803d591466 into bc3598b1cd

This commit fixes a very minor typo in the `java` (English) tutorial.

angularjs.html.markdown

@@ -3,7 +3,7 @@ category: framework
 framework: AngularJS
 contributors:
     - ["Walter Cordero", "http://waltercordero.com"]
-filename: learnangular.html
+filename: learnangular.txt
 ---
 
 ## AngularJS Tutorial.

ar-ar/html-ar.html.markdown

@@ -1,7 +1,7 @@
 ---
 language: HTML
 lang: ar-ar
-filename: learnhtml-tf.html
+filename: learnhtml-tf.txt
 contributors:
     - ["Christophe THOMAS", "https://github.com/WinChris"]
 translators:

ca-es/html-ca.html.markdown

@@ -1,6 +1,6 @@
 ---
 language: HTML
-filename: html-ca.md
+filename: html-ca.txt
 contributors:
     - ["Christophe THOMAS", "https://github.com/WinChris"]
 translators:

de-de/hq9+-de.html.markdown

@@ -1,6 +1,6 @@
 ---
 language: HQ9+
-filename: hq9+-de.html
+filename: hq9+-de.txt
 contributors:
     - ["Alexey Nazaroff", "https://github.com/rogaven"]
 translators:

de-de/html-de.html.markdown

@@ -4,7 +4,7 @@ contributors:
     - ["Christophe THOMAS", "https://github.com/WinChris"]
 translators:
     - ["Dennis Keller", "https://github.com/denniskeller"]
-filename: learnhtml-de.html
+filename: learnhtml-de.txt
 lang: de-de
 ---
 

de-de/processing-de.html.markdown

@@ -6,7 +6,6 @@ contributors:
     - ["Divay Prakash", "https://github.com/divayprakash"]
 translators:
   - ["caminsha", "https://github.com/caminsha"]
-filename: processing-de.md
 lang: de-de
 ---
 

de-de/shutit-de.html.markdown

@@ -1,6 +1,6 @@
 ---
 category: framework
-filename: learnshutit-de.html
+filename: learnshutit-de.py
 framework: ShutIt
 contributors:
     - ["Ian Miell", "http://ian.meirionconsulting.tk"]

el-gr/css-gr.html.markdown

@@ -2,7 +2,7 @@
 language: CSS
 contributors:
     - ["Kostas Bariotis", "http://kostasbariotis.com"]
-filename: css-gr.html.markdown
+filename: css-gr.css
 lang: el-gr
 ---
 

el-gr/html-gr.html.markdown

@@ -1,6 +1,6 @@
 ---
 language: HTML
-filename: learnhtml-gr.html
+filename: learnhtml-gr.txt
 contributors:
     - ["Dimitri Kokkonis", "https://github.com/kokkonisd"]
 lang: el-gr

el-gr/json-gr.html.markdown

@@ -1,6 +1,6 @@
 ---
 language: JSON
-filename: json-gr.html.markdown
+filename: json-gr.json
 contributors:
   - ["Anna Harren", "https://github.com/iirelu"]
   - ["Marco Scannadinari", "https://github.com/marcoms"]

es-es/dart-es.html.markdown

@@ -4,7 +4,7 @@ contributors:
     - ["Joao Pedrosa", "https://github.com/jpedrosa/"]
 translators:
     - ["Jorge Antonio Atempa", "http://www.twitter.com/atempa09"]
-filename: dart-es.md
+filename: dart-es.dart
 lang: es-es
 ---
 

es-es/groovy-es.html.markdown

@@ -5,7 +5,7 @@ contributors:
 translators:
     - ["Jhoon Saravia", "https://github.com/jhoon"]
 lang: es-es
-filename: groovy-es.html
+filename: groovy-es.groovy
 ---
 
 Groovy - Un lenguaje dinámico para la plataforma Java. [Leer más aquí](http://www.groovy-lang.org/).

es-es/haskell-es.html.markdown

@@ -4,7 +4,7 @@ contributors:
     - ["Adit Bhargava", "http://adit.io"]
 translators:
     - ["Jorge Antonio Atempa", "http://www.twitter.com/atempa09"]
-filename: haskell-es.md
+filename: haskell-es.hs
 lang: es-es
 ---
 

es-es/hq9+-es.html.markdown

@@ -1,6 +1,6 @@
 ---
 language: HQ9+
-filename: hq9+-es.html
+filename: hq9+-es.txt
 contributors:
     - ["Alexey Nazaroff", "https://github.com/rogaven"]
 translators:

es-es/html-es.html.markdown

@@ -1,6 +1,6 @@
 ---
 language: HTML
-filename: learnhtml-es.html
+filename: learnhtml-es.txt
 contributors:
     - ["Christophe THOMAS", "https://github.com/WinChris"]
 translators:

es-es/wolfram-es.html.markdown

@@ -3,7 +3,7 @@ language: Wolfram
 lang: es-es
 contributors:
     - ["Daniel Caballero", "http://github.com/danielcaballero796/"]
-filename: learnwolfram-es.md
+filename: learnwolfram-es.nb
 ---
 
 Wolfram es un lenguaje subyacente originalmente utilizado en Mathematica, pero ahora esta disponible para su uso en múltiples contextos.

fortran.html.markdown

@@ -41,7 +41,7 @@ program example         ! declare a program called example.
     real :: v, x        ! WARNING: default initial values are compiler dependent!
     real :: a = 3, b = 2E12, c = 0.01
     integer :: i, j, k = 1, m
-    real, parameter :: PI = 3.1415926535897931    ! declare a constant.
+    real, parameter :: PI = 3.14159265            ! declare a constant.
     logical :: y = .TRUE., n = .FALSE.            ! boolean type.
     complex :: w = (0, 1)                         ! sqrt(-1)
     character(len=3) :: month                     ! string of 3 characters.
@@ -461,10 +461,10 @@ end module fruity
 ! to express loop-level parallelism
 
 integer :: i
-real :: array(100)
+real :: array(10)
 
 DO CONCURRENT (i = 1:size(array))
-    array(i) = sqrt(i**i)
+    array(i) = sqrt(real(i)**i)
 END DO
 
 

fr-fr/html-fr.html.markdown

@@ -1,6 +1,6 @@
 ---
 language: HTML
-filename: learnhtml-fr.html
+filename: learnhtml-fr.txt
 contributors:
     - ["Christophe THOMAS", "https://github.com/WinChris"]
 lang: fr-fr

he-he/html-he.html.markdown

@@ -1,6 +1,6 @@
 ---
 language: HTML
-filename: learnhtml-he.html
+filename: learnhtml-he.txt
 contributors:
     - ['Christophe THOMAS', 'https://github.com/WinChris']
 translators:

hq9+.html.markdown

@@ -1,6 +1,6 @@
 ---
 language: HQ9+
-filename: hq9+.html
+filename: hq9+.txt
 contributors:
     - ["Alexey Nazaroff", "https://github.com/rogaven"]
 ---

id-id/hq9+-id.html.markdown

@@ -1,6 +1,6 @@
 ---
 language: HQ9+
-filename: hq9+-id.html
+filename: hq9+-id.txt
 contributors:
     - ["Alexey Nazaroff", "https://github.com/rogaven"]
 translators:

id-id/rst-id.html.markdown

@@ -1,6 +1,6 @@
 ---
 language: reStructuredText (RST)
-filename: rst-id.html
+filename: rst-id.rst
 contributors:
     - ["DamienVGN", "https://github.com/martin-damien"]
     - ["Andre Polykanine", "https://github.com/Oire"]

it-it/rust-it.html.markdown

@@ -3,7 +3,7 @@ language: Rust
 contributors:
     - ["Carlo Milanesi", "http://github.com/carlomilanesi"]
 lang: it-it
-filename: rust-it.html.markdown
+filename: rust-it.rs
 ---
 
 Rust è un linguaggio di programmazione sviluppato da Mozilla Research.

java.html.markdown

@@ -225,7 +225,7 @@ public class LearnJava {
         String fooString = "My String Is Here!";
 
         // Text blocks
-        vat textBlock = """
+        var textBlock = """
                         This is a <Text Block> in Java 
                         """;
 

nl-nl/html-nl.html.markdown

@@ -1,6 +1,6 @@
 ---
 language: HTML
-filename: learnhtml-nl.html
+filename: learnhtml-nl.txt
 contributors:
     - ["Christophe THOMAS", "https://github.com/WinChris"]
 translators:

qsharp.html.markdown

@@ -4,6 +4,7 @@ contributors:
     - ["Vincent van Wingerden", "https://github.com/vivanwin"]
     - ["Mariia Mykhailova", "https://github.com/tcNickolas"]
     - ["Andrew Ryan Davis", "https://github.com/AndrewDavis1191"]
+    - ["Alex Hansen", "https://github.com/sezna"]
 filename: LearnQSharp.qs
 ---
 
@@ -16,35 +17,36 @@ Q# is a high-level domain-specific language which enables developers to write qu
 /////////////////////////////////////
 // 1. Quantum data types and operators
 
-// The most important part of quantum programs is qubits. 
+// The most important part of quantum programs is qubits.
 // In Q# type Qubit represents the qubits which can be used.
 // This will allocate an array of two new qubits as the variable qs.
-using (qs = Qubit[2]) {
+operation QuantumDataTypes() : Unit {
+    use qs = Qubit[2];
 
     // The qubits have internal state that you cannot access to read or modify directly.
-    // You can inspect the current state of your quantum program 
+    // You can inspect the current state of your quantum program
     // if you're running it on a classical simulator.
     // Note that this will not work on actual quantum hardware!
-    DumpMachine();
+    Std.Diagnostics.DumpMachine();
 
     // If you want to change the state of a qubit
     // you have to do this by applying quantum gates to the qubit.
-    H(qs[0]);    // This changes the state of the first qubit 
-                // from |0⟩ (the initial state of allocated qubits) 
-                // to (|0⟩ + |1⟩) / sqrt(2).
+    H(qs[0]);   // This changes the state of the first qubit
+    // from |0⟩ (the initial state of allocated qubits)
+    // to (|0⟩ + |1⟩) / sqrt(2).
     // qs[1] = |1⟩; - this does NOT work, you have to manipulate a qubit by using gates.
 
     // You can apply multi-qubit gates to several qubits.
     CNOT(qs[0], qs[1]);
 
-    // You can also apply a controlled version of a gate: 
+    // You can also apply a controlled version of a gate:
     // a gate that is applied if all control qubits are in |1⟩ state.
-    // The first argument is an array of control qubits, 
+    // The first argument is an array of control qubits,
     // the second argument is the target qubit.
-    Controlled Y([qs[0]], qs[1]); 
+    Controlled Y([qs[0]], qs[1]);
 
-    // If you want to apply an anti-controlled gate 
-    // (a gate that is applied if all control qubits are in |0⟩ state), 
+    // If you want to apply an anti-controlled gate
+    // (a gate that is applied if all control qubits are in |0⟩ state),
     // you can use a library function.
     ApplyControlledOnInt(0, X, [qs[0]], qs[1]);
 
@@ -58,96 +60,101 @@ using (qs = Qubit[2]) {
 /////////////////////////////////////
 // 2. Classical data types and operators
 
-// Numbers in Q# can be stored in Int, BigInt or Double.
-let i = 1;            // This defines an Int variable i equal to 1
-let bi = 1L;          // This defines a BigInt variable bi equal to 1
-let d = 1.0;          // This defines a Double variable d equal to 1
+function ClassicalDataTypes() : Unit {
+    // Numbers in Q# can be stored in Int, BigInt or Double.
+    let i = 1;            // This defines an Int variable i equal to 1
+    let bi = 1L;          // This defines a BigInt variable bi equal to 1
+    let d = 1.0;          // This defines a Double variable d equal to 1
 
-// Arithmetic is done as expected, as long as the types are the same
-let n = 2 * 10;                // = 20
-// Q# does not have implicit type cast, 
-// so to perform arithmetic on values of different types, 
-// you need to cast type explicitly
-let nd = IntAsDouble(2) * 1.0; // = 20.0
+    // Arithmetic is done as expected, as long as the types are the same
+    let n = 2 * 10;                // = 20
+    // Q# does not have implicit type cast,
+    // so to perform arithmetic on values of different types,
+    // you need to cast type explicitly
+    let nd = Std.Convert.IntAsDouble(2) * 1.0; // = 20.0
 
-// Boolean type is called Bool
-let trueBool = true;
-let falseBool = false;
+    // Boolean type is called Bool
+    let trueBool = true;
+    let falseBool = false;
 
-// Logic operators work as expected
-let andBool = true and false;
-let orBool = true or false;
-let notBool = not false;
+    // Logic operators work as expected
+    let andBool = true and false;
+    let orBool = true or false;
+    let notBool = not false;
 
-// Strings
-let str = "Hello World!";
+    // Strings
+    let str = "Hello World!";
 
-// Equality is ==
-let x = 10 == 15; // is false
+    // Equality is ==
+    let x = 10 == 15; // is false
 
-// Range is a sequence of integers and can be defined like: start..step..stop
-let xi = 1..2..7; // Gives the sequence 1,3,5,7
+    // Range is a sequence of integers and can be defined like: start..step..stop
+    let xi = 1..2..7; // Gives the sequence 1,3,5,7
 
-// Assigning new value to a variable:
-// by default all Q# variables are immutable;
-// if the variable was defined using let, you cannot reassign its value.
+    // Assigning new value to a variable:
+    // by default all Q# variables are immutable;
+    // if the variable was defined using let, you cannot reassign its value.
 
-// When you want to make a variable mutable, you have to declare it as such, 
-// and use the set word to update value
-mutable xii = true;
-set xii = false;
+    // When you want to make a variable mutable, you have to declare it as such,
+    // and use the set word to update value
+    mutable xii = true;
+    set xii = false;
 
-// You can create an array for any data type like this
-let xiii = new Double[10];
+    // You can create an array for any data type like this
+    let xiii = [0.0, size = 10];
 
-// Getting an element from an array 
-let xiv = xiii[8];
+    // Getting an element from an array
+    let xiv = xiii[8];
 
-// Assigning a new value to an array element
-mutable xv = new Double[10];
-set xv w/= 5 <- 1;
+    // Assigning a new value to an array element
+    mutable xv = [0.0, size = 10];
+    set xv w/= 5 <- 1.0;
+}
 
 
 /////////////////////////////////////
 // 3. Control flow
 
-// If structures work a little different than most languages
-if (a == 1) {
-    // ...
-} elif (a == 2) {
-    // ... 
-} else {
-    // ...
-}
+operation ControlFlow() : Unit {
+    let a = 1;
+    // If expressions support a true branch, elif, and else.
+    if (a == 1) {
+        // ...
+    } elif (a == 2) {
+        // ...
+    } else {
+        // ...
+    }
+    use qubits = Qubit[2];
 
-// Foreach loops can be used to iterate over an array
-for (qubit in qubits) {
-    X(qubit);
-}
+    // For loops can be used to iterate over an array
+    for qubit in qubits {
+        X(qubit);
+    }
 
-// Regular for loops can be used to iterate over a range of numbers
-for (index in 0 .. Length(qubits) - 1) {
-    X(qubits[index]);
-}
+    // Regular for loops can be used to iterate over a range of numbers
+    for index in 0..Length(qubits) - 1 {
+        X(qubits[index]);
+    }
 
-// While loops are restricted for use in classical context only
-mutable index = 0;
-while (index < 10) {
-    set index += 1;
-}
+    // While loops are restricted for use in classical context only
+    mutable index = 0;
+    while (index < 10) {
+        set index += 1;
+    }
 
-// Quantum equivalent of a while loop is a repeat-until-success loop.
-// Because of the probabilistic nature of quantum computing sometimes
-// you want to repeat a certain sequence of operations 
-// until a specific condition is achieved; you can use this loop to express this.
-repeat {
-    // Your operation here
+    let success_criteria = true;
+    // Quantum equivalent of a while loop is a repeat-until-success loop.
+    // Because of the probabilistic nature of quantum computing sometimes
+    // you want to repeat a certain sequence of operations
+    // until a specific condition is achieved; you can use this loop to express this.
+    repeat {
+        // Your operation here
+    } until (success_criteria) // This could be a measurement to check if the state is reached
+    fixup {
+        // Resetting to the initial conditions, if required
+    }
 }
-until (success criteria) // This could be a measurement to check if the state is reached
-fixup {
-    // Resetting to the initial conditions, if required
-}
-
 
 /////////////////////////////////////
 // 4. Putting it all together
@@ -157,11 +164,11 @@ operation ApplyXGate(source : Qubit) : Unit {
     X(source);
 }
 
-// If the operation implements a unitary transformation, you can define 
-// adjoint and controlled variants of it. 
-// The easiest way to do that is to add "is Adj + Ctl" after Unit. 
+// If the operation implements a unitary transformation, you can define
+// adjoint and controlled variants of it.
+// The easiest way to do that is to add "is Adj + Ctl" after Unit.
 // This will tell the compiler to generate the variants automatically.
-operation ApplyXGateCA (source : Qubit) : Unit is Adj + Ctl {
+operation ApplyXGateCA(source : Qubit) : Unit is Adj + Ctl {
     X(source);
 }
 
@@ -169,20 +176,21 @@ operation ApplyXGateCA (source : Qubit) : Unit is Adj + Ctl {
 
 
 // To run Q# code, you can put @EntryPoint() before the operation you want to run first
-@EntryPoint()
 operation XGateDemo() : Unit {
-    using (q = Qubit()) {
-        ApplyXGate(q);
-    }
+    use q = Qubit();
+    ApplyXGate(q);
 }
 
-// Here is a simple example: a quantum random number generator. 
+// Here is a simple example: a quantum random number generator.
 // We will generate a classical array of random bits using quantum code.
-@EntryPoint()
-operation QRNGDemo() : Unit {
-    mutable bits = new Int[5];                // Array we'll use to store bits
-    using (q = Qubit()) {                     // Allocate a qubit
-        for (i in 0 .. 4) {                   // Generate each bit independently
+// Callables (functions or operations) named `Main` are used as entry points.
+operation Main() : Unit {
+    mutable bits = [0, size = 5];                // Array we'll use to store bits
+    use q  = Qubit();
+    {
+        // Allocate a qubit
+        for i in 0..4 {
+            // Generate each bit independently
             H(q);                             // Hadamard gate sets equal superposition
             let result = M(q);                // Measure qubit gets 0|1 with 50/50 prob
             let bit = result == Zero ? 0 | 1; // Convert measurement result to integer
@@ -196,9 +204,6 @@ operation QRNGDemo() : Unit {
 
 ## Further Reading
 
-The [Quantum Katas][1] offer great self-paced tutorials and programming exercises to learn quantum computing and Q#. 
+The Quantum Katas ([repo](https://github.com/microsoft/qsharp/tree/main/katas) [hosted tutorials](https://quantum.microsoft.com/en-us/tools/quantum-katas) offer great self-paced tutorials and programming exercises to learn quantum computing and Q#. 
 
-[Q# Documentation][2] is official Q# documentation, including language reference and user guides.
-
-[1]: https://github.com/microsoft/QuantumKatas
-[2]: https://docs.microsoft.com/quantum/
+[Q# Documentation](https://docs.microsoft.com/quantum/) is official Q# documentation, including language reference and user guides.

ro-ro/bf-ro.html.markdown

@@ -5,7 +5,7 @@ contributors:
     - ["Mathias Bynens", "http://mathiasbynens.be/"]
 translators:
     - ["Petru Dimitriu", "http://petru-dimitriu.github.io"]
-filename: bf-ro.html
+filename: bf-ro.bf
 lang: ro-ro
 ---
 

ro-ro/haskell-ro.html.markdown

@@ -5,7 +5,7 @@ contributors:
 translators:
     - ["Petru Dimitriu", "http://petru-dimitriu.github.io"]
 lang: ro-ro
-filename: haskell-ro.html
+filename: haskell-ro.hs
 ---
 
 Haskell este un limbaj de programare practic, pur funcțional.

ru-ru/dart-ru.html.markdown

@@ -0,0 +1,721 @@
+---
+language: dart
+filename: learndart-ru.dart
+contributors:
+  - ["Joao Pedrosa", "https://github.com/jpedrosa/"]
+  - ["Vince Ramces Oliveros", "https://github.com/ram231"]
+translators:
+    - ["nikaose", "https://github.com/nikaose"]
+lang: ru-ru
+---
+
+**Dart** это однопоточный язык программирования общего назначения.
+Он многое заимствует из других основных языков.
+Он поддерживает потоки, фьючерсы (известные как промисы в JavaScript), дженерики, первоклассные функции (замыкания) и проверку статического типа.
+Dart может работать на любой платформе, включая веб-интерфейс, интерфейс командной строки, десктопные, мобильные устройства и устройства IoT.
+
+```dart
+import "dart:collection";
+import "dart:math" as math;
+
+/// Добро пожаловать в «Изучите Dart за 15 минут». http://dart.dev/
+/// Это исполняемый учебник. Вы можете запустить его с помощью Dart или
+/// Попробуйте Dart! если вы скопируете/вставите его сюда: http://dartpad.dev/
+/// Вы также можете запустить Flutter в DartPad, щелкнув `< > New Pad ` и выбрав Flutter.
+
+
+/// В Dart все является объектом.
+/// Каждое объявление объекта является экземпляром Null и
+/// Null также является объектом.
+
+
+/// 3 типа комментариев в Dart
+// Однострочный комментарий
+/**
+* Многострочный комментарий
+* Можно прокомментировать несколько строк
+*/
+/// Комментарий к документации кода
+/// Он использует синтаксис markdown для создания документации кода при создании API.
+/// Комментарий к документации кода — рекомендуемый выбор при документировании API, классов и методов.
+
+/// 4 типа объявления переменных.
+/// Константы — это переменные, которые являются неизменяемыми и не могут быть изменены.
+/// `const` в Dart должен использовать объявление имени SCREAMING_SNAKE_CASE.
+const CONSTANT_VALUE = "Я НЕ МОГУ ПОМЕНЯТЬ";
+CONSTANT_VALUE = "Я сделал?"; // Ошибка
+/// Final — это еще одно объявление переменной, которое нельзя изменить после создания экземпляра. Обычно используется в классах и функциях.
+/// `final` может быть объявлен в pascalCase.
+final finalValue = "значение не может быть изменено после создания экземпляра";
+finalValue = "Кажется, нет"; // Ошибка
+
+/// `var` — это еще одно объявление переменной, которая является изменяемой и может изменять свое значение. Dart выведет типы и не изменит тип данных.
+var mutableValue = "Переменная строка";
+mutableValue = "Так работает";
+mutableValue = false; // Ошибка.
+
+/// `dynamic` — это еще одно объявление переменной, в котором тип не оценивается при проверке статического типа Dart.
+/// Он может изменить свое значение и тип данных.
+/// Некоторые дартисты используют динамический подход с осторожностью, поскольку он не может отслеживать тип данных. так что используйте его на свой страх и риск
+dynamic dynamicValue = "Я строка";
+dynamicValue = false; // false
+
+
+/// Функции могут быть объявлены в глобальном пространстве.
+/// Объявление функции и объявление метода выглядят одинаково.
+/// Объявления функции могут быть вложенными.
+/// Декларация имеет форму name() {} или name() => singleLineExpression;
+/// Объявление функции большой стрелкой может быть неявным или явным возвратом результата выражения.
+/// Dart выполнит функцию `main()` в любом месте проекта dart.
+///
+example1() {
+  nested1() {
+    nested2() => print("Example1 nested 1 nested 2");
+    nested2();
+  }
+
+  nested1();
+}
+
+/// Анонимные функции не включают имя
+example2() {
+  //// Явный тип возвращаемого значения.
+  nested1(void Function() fn) {
+    fn();
+  }
+  nested1(() => print("Example2 nested 1"));
+}
+
+/// Когда объявлен параметр функции, объявление может включать количество параметров,
+/// которые принимает функция, путем явного указания имен принимаемых ею параметров.
+example3() {
+  planA(fn(String informSomething)) {
+    fn("Example3 plan A");
+  }
+  planB(fn) {
+    // Или не объявляйте количество параметров.
+    fn("Example3 plan B");
+  }
+
+  planA((s) => print(s));
+  planB((s) => print(s));
+}
+
+/// Функции имеют замыкающий доступ к внешним переменным.
+/// Dart выводит типы, когда переменная имеет какое-либо значение.
+/// В этом примере Dart знает, что эта переменная является строкой.
+var example4Something = "Example4 nested 1";
+example4() {
+  nested1(fn(informSomething)) {
+    fn(example4Something);
+  }
+
+  nested1((s) => print(s));
+}
+
+/// Объявление класса с методом sayIt, который также имеет закрывающий доступ
+/// к внешней переменной, как если бы это была функция, как было показано ранее.
+var example5method = "Example5 sayIt";
+
+class Example5Class {
+  sayIt() {
+    print(example5method);
+  }
+}
+
+example5() {
+  /// Создайте анонимный экземпляр класса Example5Class и вызовите для него метод sayIt
+  /// Ключевое слово `new` в Dart не является обязательным..
+  new Example5Class().sayIt();
+}
+
+/// Объявление класса принимает форму имени класса. { [classBody] }.
+/// Где classBody может включать методы и переменные экземпляра, 
+/// а также методы и переменные класса.
+class Example6Class {
+  var instanceVariable = "Example6 переменная экземпляра";
+  sayIt() {
+    print(instanceVariable);
+  }
+}
+
+example6() {
+   Example6Class().sayIt();
+}
+
+/// Методы и переменные класса объявляются с помощью «статических» терминов.
+class Example7Class {
+  static var classVariable = "Example7 переменная класса";
+  static sayItFromClass() {
+    print(classVariable);
+  }
+
+  sayItFromInstance() {
+    print(classVariable);
+  }
+}
+
+example7() {
+  Example7Class.sayItFromClass();
+  new Example7Class().sayItFromInstance();
+}
+
+/// Dart поддерживает дженерики.
+/// Дженерики относятся к технике написания кода для класса.
+/// без указания типов данных, с которыми работает класс.
+/// Источник: https://stackoverflow.com/questions/4560890/what-are-generics-in-c
+
+/// Тип `T` относится к любому типу, экземпляр которого был создан.
+/// вы можете вызывать все, что захотите.
+/// Программисты используют это соглашение в следующих случаях:
+/// T - Тип (используется для типов классов и примитивов)
+/// E - Элемент (используется для списка, набора или итерации)
+/// K,V - Ключевое значение (используется для Map)
+class GenericExample<T>{
+  void printType(){
+    print("$T")
+  }
+  // методы также могут иметь дженерики
+  genericMethod<M>(){
+    print("class:$T, method: $M");
+  }
+}
+
+
+/// Список похож на массивы, но список является дочерним элементом Iterable<E>.
+/// Поэтому Maps, List, LinkedList являются дочерними элементами Iterable<E>, 
+/// чтобы иметь возможность зацикливаться с использованием ключевого слова `for`
+/// Важные вещи, которые следует помнить:
+/// () - Iterable<E>
+/// [] - List<E>
+/// {} - Map<K,V>
+
+
+/// Список — это здорово, но есть ограничение на то, каким может быть список.
+/// outside of function/method bodies. List on the outer scope of class
+/// вне тела функции/метода. Список во внешней области класса или
+/// вне класса должен быть постоянным. Строки и числа используются по умолчанию.
+/// А вот массивы и карты — нет. Их можно сделать постоянными,
+/// объявив их "const". Что-то похожее на Object.freeze() в Javascript.
+const example8List = ["Example8 const array"];
+const  example8Map = {"someKey": "Example8 const map"};
+/// Объявите List или Map как объекты.
+ List<String> explicitList = new List<String>();
+ Map<String,dynamic> explicitMaps = new Map<String,dynamic>();
+
+ explicitList.add("НекоторыйМассив");
+example8() {
+  print(example8Map["какой-тоКлюч"]);
+  print(explicitList[0]);
+}
+
+/// Присвоение списка одной переменной другой не будет тем же результатом.
+/// Потому что dart передает ссылку по значению.
+/// Поэтому, когда вы назначаете существующий список новой переменной.
+/// Вместо списка он становится итерируемым
+var iterableExplicitList = explicitList;
+print(iterableExplicitList) // ("НекоторыйМассив"); "[]" становится "()"
+var newExplicitLists = explicitList.toList() // Преобразует Iterable<E> в List<E>
+
+/// Циклы в Dart имеют форму стандартных циклов for () {} или while () {},
+/// немного более современный for (.. in ..) {} или функциональные обратные вызовы 
+/// со многими поддерживаемыми функциями, начиная с forEach,map иwhere.
+var example9Array = const ["a", "b"];
+example9() {
+  for (int i = 0; i < example9Array.length; i++) {
+    print("Example9 цикл цикл '${example9Array[i]}'");
+  }
+  var i = 0;
+  while (i < example9Array.length) {
+    print("Example9 цикл while '${example9Array[i]}'");
+    i++;
+  }
+  for (final e in example9Array) {
+    print("Example9 цикл for-in '${e}'");
+  }
+
+  example9Array.forEach((e) => print("Example9 цикл forEach '${e}'"));
+
+}
+
+/// Чтобы перебрать символы строки или извлечь подстроку.
+var example10String = "ab";
+example10() {
+  for (var i = 0; i < example10String.length; i++) {
+    print("Example10 цикл строковых символов '${example10String[i]}'");
+  }
+  for (var i = 0; i < example10String.length; i++) {
+    print("Example10 цикл извлечения '${example10String.substring(i, i + 1)}'");
+  }
+}
+
+/// `int`, `double` и `num` — три поддерживаемых числовых формата.
+/// `num` может быть либо `int`, либо `double`.
+/// `int` и `double` являются дочерними элементами типа `num`
+example11() {
+  var i = 1 + 320, d = 3.2 + 0.01;
+  final num myFinalNumDouble = 2.2;
+  final num myFinalNumInt = 2;
+  final int myFinalInt = 1;
+  final double myFinalDouble = 0.1;
+  num myNumDouble = 2.2;
+  num myNumInt = 2;
+  int myInt = 1;
+  double myDouble = 0; // Dart добавит десятичный префикс и станет 0.0;
+  myNumDouble = myFinalInt; // действительный
+  myNumDouble = myFinalDouble; // действительный
+  myNumDouble = myFinalNumInt; // действительный
+
+  myNumInt = myFinalInt; // действительный
+  myNumInt = myFinalDouble; // действительный
+  myNumInt = myFinalNumDouble; // действительный
+
+  myInt = myNumDouble; // ошибка
+  myInt = myFinalDouble; // ошибка
+  myInt = myFinalNumInt; // действительный
+
+  myDouble = myFinalInt; // ошибка
+  myDouble = myFinalNumInt; // ошибка
+  myDouble = myFinalNumDouble; // действительный
+
+  print("Example11 int ${i}");
+  print("Example11 double ${d}");
+
+}
+
+/// DateTime обеспечивает арифметику даты и времени.
+example12() {
+  var now = new DateTime.now();
+  print("Example12 сейчас '${now}'");
+  now = now.add(new Duration(days: 1));
+  print("Example12 завтра '${now}'");
+}
+
+/// Поддерживаются регулярные выражения.
+example13() {
+  var s1 = "some string", s2 = "some", re = new RegExp("^s.+?g\$");
+  match(s) {
+    if (re.hasMatch(s)) {
+      print("Example13 совпадения с регулярными выражениями '${s}'");
+    } else {
+      print("Example13 регулярное выражение не соответствует '${s}'");
+    }
+  }
+
+  match(s1);
+  match(s2);
+}
+
+/// Логические выражения поддерживают неявные преобразования и динамический тип.
+example14() {
+  var a = true;
+  if (a) {
+    print("true, a равно $a");
+  }
+  a = false;
+  if (a) {
+    print("true, a равно $a"); 
+  } else {
+    print("false, a равно $a"); /// сработает здесь
+  }
+
+  /// динамический типизированный null не может быть преобразован в bool
+  var b; /// b — динамический тип
+  b = "abc";
+  try {
+    if (b) {
+      print("true, b равно $b");
+    } else {
+      print("false, b равно $b");
+    }
+  } catch (e) {
+    print("error, b равно $b"); /// это можно было запустить, но возникает ошибка
+  }
+  b = null; 
+  if (b) { /// Неудачное утверждение: логическое выражение не должно быть нулевым)
+    print("true, b равно $b");
+  } else {
+    print("false, b равно $b"); 
+  }
+
+  /// статически типизированный null не может быть преобразован в bool
+  var c = "abc";
+  c = null;
+  /// компиляция не удалась
+  /// if (c) {
+  ///   print("true, c равно $c");
+  /// } else {
+  ///   print("false, c равно $c");
+  /// }
+}
+
+/// try/catch/finally и throw используются для обработки исключений.
+/// throw принимает любой объект в качестве параметра;
+example15() {
+  try {
+    try {
+      throw "Какая-то неожиданная ошибка.";
+    } catch (e) {
+      print("Example15 исключение: '${e}'");
+      throw e; /// Re-throw
+    }
+  } catch (e) {
+    print("Example15 catch exception being re-thrown: '${e}'");
+  } finally {
+    print("Example15 Still run finally");
+  }
+}
+
+/// Чтобы быть эффективным при динамическом создании длинной строки, 
+/// используйте StringBuffer. Или вы можете присоединиться к массиву строк.
+example16() {
+  var sb = new StringBuffer(), a = ["a", "b", "c", "d"], e;
+  for (e in a) {
+    sb.write(e);
+  }
+  print("Example16 динамическая строка, созданная с помощью "
+      "StringBuffer '${sb.toString()}'");
+  print("Example16 объединить массив строк '${a.join()}'");
+}
+
+/// Строки можно объединить, просто разместив список строк рядом друг с другом
+/// без необходимости использования дополнительных операторов.
+
+example17() {
+  print("Example17 "
+      "concatenate "
+      "strings "
+      "just like that");
+}
+
+/// Строки имеют одинарные или двойные кавычки для разделителей, 
+/// между которыми нет фактической разницы. Данная гибкость может быть полезной,
+/// чтобы избежать необходимости экранировать содержимое, соответствующее используемому разделителю.
+/// Например, двойные кавычки атрибутов HTML, если строка содержит содержимое HTML.
+example18() {
+  print('Example18 <a href="etc">'
+      "Don't can't I'm Etc"
+      '</a>');
+}
+
+/// Строки с тройными одинарными или тройными двойными кавычками занимают несколько строк
+/// и включают разделители строк.
+example19() {
+  print('''Example19 <a href="etc">
+Example19 Don't can't I'm Etc
+Example19 </a>''');
+}
+
+/// Строки имеют удобную функцию интерполяции с помощью символа $.
+/// При использовании $ {[expression] } возврат выражения интерполируется.
+/// $ за которым следует имя переменной, интерполирует содержимое этой переменной.
+/// $ можно экранировать следующим образом: \$, чтобы вместо этого просто добавить его в строку.
+example20() {
+  var s1 = "'\${s}'", s2 = "'\$s'";
+  print("Example20 \$ интерполяция ${s1} или $s2 работает.");
+}
+
+/// Необязательные типы позволяют аннотировать API и приходят на помощь IDE,
+/// чтобы IDE могли лучше выполнять рефакторинг, автозаполнение и проверку на наличие ошибок.
+/// До сих пор мы не объявляли никаких типов, и программы работали нормально.
+/// Фактически, типы игнорируются во время выполнения. Типы могут даже быть неправильными,
+/// но программа все равно будет иметь преимущество сомнения и будет работать так,
+/// как будто типы не имеют значения.
+/// Существует параметр времени выполнения, который проверяет наличие ошибок типа.
+/// Это проверенный режим, который считается полезным во время разработки,
+/// но который также медленнее из-за дополнительной проверки и, 
+/// следовательно, его избегают во время выполнения развертывания.
+class Example21 {
+  List<String> _names;
+  Example21() {
+    _names = ["a", "b"];
+  }
+  List<String> get names => _names;
+  set names(List<String> list) {
+    _names = list;
+  }
+
+  int get length => _names.length;
+  void add(String name) {
+    _names.add(name);
+  }
+}
+
+void example21() {
+  Example21 o = new Example21();
+  o.add("c");
+  print("Example21 имена '${o.names}' и длина '${o.length}'");
+  o.names = ["d", "e"];
+  print("Example21 имена '${o.names}' и длина '${o.length}'");
+}
+
+/// Наследование классов принимает форму имени класса расширяет AnotherClassName {}.
+class Example22A {
+  var _name = "Some Name!";
+  get name => _name;
+}
+
+class Example22B extends Example22A {}
+
+example22() {
+  var o = new Example22B();
+  print("Example22 наследование класса '${o.name}'");
+}
+
+/// Миксин классов также доступен и принимает форму имени класса,
+/// расширяющего SomeClass с AnotherClassName {}. 
+/// Необходимо расширить какой-то класс, чтобы можно было добавить другой.
+/// Класс шаблона миксина на данный момент не может иметь конструктор.
+/// Миксин в основном используется для совместного использования методов с удаленными классами,
+/// поэтому единое наследование не мешает повторному использованию кода.
+/// Миксины следуют за оператором «with» во время объявления класса.
+class Example23A {}
+
+class Example23Utils {
+  addTwo(n1, n2) {
+    return n1 + n2;
+  }
+}
+
+class Example23B extends Example23A with Example23Utils {
+  addThree(n1, n2, n3) {
+    return addTwo(n1, n2) + n3;
+  }
+}
+
+example23() {
+  var o = new Example23B(), r1 = o.addThree(1, 2, 3), r2 = o.addTwo(1, 2);
+  print("Example23 addThree(1, 2, 3) приводит к результату '${r1}'");
+  print("Example23 addTwo(1, 2) приводит к результату '${r2}'");
+}
+
+/// Метод конструктора класса использует то же имя класса и
+/// принимает форму SomeClass() : super() {}, где часть ": super()" является необязательной и
+/// используется для делегирования константных параметров суперуправлению-родительский конструктор.
+class Example24A {
+  var _value;
+  Example24A({value: "некотороеЗначение"}) {
+    _value = value;
+  }
+  get value => _value;
+}
+
+class Example24B extends Example24A {
+  Example24B({value: "некотороеДругоеЗначение"}) : super(value: value);
+}
+
+example24() {
+  var o1 = new Example24B(), o2 = new Example24B(value: "evenMore");
+  print("Example24 вызов super во время конструктора '${o1.value}'");
+  print("Example24 вызов super во время конструктора '${o2.value}'");
+}
+
+/// Существует ярлык для установки параметров конструктора в случае более простых классов.
+/// Просто используйте префикс this.parameterName, и он установит параметр в переменную экземпляра с тем же именем.
+class Example25 {
+  var value, anotherValue;
+  Example25({this.value, this.anotherValue});
+}
+
+example25() {
+  var o = new Example25(value: "a", anotherValue: "b");
+  print("Example25 ярлык для конструктора '${o.value}' и "
+      "'${o.anotherValue}'");
+}
+
+/// Именованные параметры доступны, если они объявлены между {}.
+/// Порядок параметров может быть необязательным, если они объявлены между {}.
+/// Параметры можно сделать необязательными, если они объявлены между [].
+example26() {
+  var _name, _surname, _email;
+  setConfig1({name, surname}) {
+    _name = name;
+    _surname = surname;
+  }
+
+  setConfig2(name, [surname, email]) {
+    _name = name;
+    _surname = surname;
+    _email = email;
+  }
+
+  setConfig1(surname: "Doe", name: "John");
+  print("Example26 имя '${_name}', фамилия '${_surname}', "
+      "email '${_email}'");
+  setConfig2("Mary", "Jane");
+  print("Example26 имя '${_name}', фамилия '${_surname}', "
+      "email '${_email}'");
+}
+
+/// Переменные, объявленные с помощью Final, можно установить только один раз.
+/// В случае классов конечные переменные экземпляра могут быть установлены через постоянный параметр конструктора.
+class Example27 {
+  final color1, color2;
+  /// Немного гибкости для установки конечных переменных экземпляра с синтаксисом,
+  /// следующим за:
+  Example27({this.color1, color2}) : color2 = color2;
+}
+
+example27() {
+  final color = "оранжевый", o = new Example27(color1: "сиреневый", color2: "белый");
+  print("Example27 цвет '${color}'");
+  print("Example27 цвет '${o.color1}' и '${o.color2}'");
+}
+
+/// Чтобы импортировать библиотеку, используйте import "libraryPath" или,
+/// если это основная библиотека, импортируйте "dart:libraryName".
+/// Существует также управление пакетами «pub» со своим собственным соглашением
+/// об импорте «package:packageName». См. импорт «dart:collection»; в начале.
+/// Импорт должен предшествовать другим объявлениям кода. IterableBase происходит из dart:collection.
+class Example28 extends IterableBase {
+  var names;
+  Example28() {
+    names = ["a", "b"];
+  }
+  get iterator => names.iterator;
+}
+
+example28() {
+  var o = new Example28();
+  o.forEach((name) => print("Example28 '${name}'"));
+}
+
+/// Для потока управления у нас есть:
+/// * стандартный переключатель с операторами must Break
+/// * if-else if-else и тернарный оператор ..?..:..
+/// * замыкания и анонимные функции
+/// * операторы break, continue и return
+example29() {
+  var v = true ? 30 : 60;
+  switch (v) {
+    case 30:
+      print("Example29 оператор switch");
+      break;
+  }
+  if (v < 30) {
+  } else if (v > 30) {
+  } else {
+    print("Example29 оператор if-else");
+  }
+  callItForMe(fn()) {
+    return fn();
+  }
+
+  rand() {
+    v = new DM.Random().nextInt(50);
+    return v;
+  }
+
+  while (true) {
+    print("Example29 callItForMe(rand) '${callItForMe(rand)}'");
+    if (v != 30) {
+      break;
+    } else {
+      continue;
+    }
+    /// Никогда сюда не попадет.
+  }
+}
+
+/// Парсим int, преобразуем double в int или просто сохраняем целое число при
+/// делении чисел с помощью операции ~/. Давайте тоже поиграем в угадайку.
+example30() {
+  var gn,
+      tooHigh = false,
+      n,
+      n2 = (2.0).toInt(),
+      top = int.parse("123") ~/ n2,
+      bottom = 0;
+  top = top ~/ 6;
+  gn = new DM.Random().nextInt(top + 1); /// +1, потому что nextInt top является эксклюзивным
+  print("Example30 Угадайте число от 0 до ${top}");
+  guessNumber(i) {
+    if (n == gn) {
+      print("Example30 Угадал! Число ${gn}");
+    } else {
+      tooHigh = n > gn;
+      print("Example30 Число ${n} слишком "
+          "${tooHigh ? 'большое' : 'маленькое'}. Попробуйте еще раз");
+    }
+    return n == gn;
+  }
+
+  n = (top - bottom) ~/ 2;
+  while (!guessNumber(n)) {
+    if (tooHigh) {
+      top = n - 1;
+    } else {
+      bottom = n + 1;
+    }
+    n = bottom + ((top - bottom) ~/ 2);
+  }
+}
+
+/// Необязательный позиционный параметр:
+/// параметр будет указан в квадратных скобках [ ] & параметр в квадратных скобках является необязательным.
+example31() {
+    findVolume31(int length, int breath, [int height]) {
+      print('length = $length, breath = $breath, height = $height');
+    }
+
+    findVolume31(10,20,30); //действительный
+    findVolume31(10,20); //также действителен
+}
+
+/// Необязательный именованный параметр: 
+/// параметр будет указан в фигурных скобках { } 
+/// Параметр в фигурных скобках не является обязательным. 
+/// необходимо использовать имя параметра, чтобы присвоить значение, 
+/// которое разделено двоеточием: в фигурных скобках порядок параметров не имеет значения,
+/// эти параметры типа помогают нам избежать путаницы при передаче значения для функции,
+/// которая имеет много параметров.
+example32() {
+    findVolume32(int length, int breath, {int height}) {
+    print('length = $length, breath = $breath, height = $height');
+    }
+
+    findVolume32(10,20,height:30);//действительно, и мы видим, что здесь упоминается имя параметра.
+    findVolume32(10,20);//также действителен
+}
+
+/// Необязательный параметр по умолчанию: 
+/// то же, что и необязательный именованный параметр, кроме того,
+/// мы можем назначить этому параметру значение по умолчанию. 
+/// это означает, что значение не передается, будет принято значение по умолчанию.
+example33() {
+    findVolume33(int length, int breath, {int height=10}) {
+     print('length = $length, breath = $breath, height = $height');
+    }
+
+    findVolume33(10,20,height:30);//действительный
+    findVolume33(10,20);//действительный
+}
+
+/// В Dart также добавлена ​​такая функция, как операторы, поддерживающие Null.
+var isBool = true;
+var hasString = isBool ?? "default String";
+
+/// Программы имеют только одну точку входа в главную функцию.
+/// Ожидается, что во внешней области ничего не будет выполнено до того,
+/// как программа начнет работать с тем, что находится в ее основной функции.
+/// Это помогает ускорить загрузку и даже ленивую загрузку именно того, с чем программа должна запускаться.
+main() {
+  print("Изучите Dart за 15 минут!");
+  [
+    example1, example2, example3, example4, example5,
+    example6, example7, example8, example9, example10,
+    example11, example12, example13, example14, example15,
+    example16, example17, example18, example19, example20,
+    example21, example22, example23, example24, example25,
+    example26, example27, example28, example29,
+    example30 // Добавление этого комментария не позволяет средству форматирования dart помещать все элементы на новую строку.
+  ].forEach((ef) => ef());
+}
+```
+
+## Дальнейшее чтение
+
+У Dart есть обширный веб-сайт. Он охватывает справочник по API, учебные пособия, статьи и многое другое, включая
+полезный DartPad (облачная площадка для программирования Dart).
+[https://dart.dev/](https://dart.dev)
+[https://dartpad.dev/](https://dartpad.dev)

ru-ru/forth-ru.html.markdown

@@ -8,18 +8,21 @@ filename: learnforth-ru.fs
 lang: ru-ru
 ---
 
-Форт создан Чарлзом Муром в 70-е годы. Это императивный, стековый язык программирования и среда исполнения программ. Использовался в таких проектах как Open Firmware. Продолжает применятся в проектах. Применяется в НАСА.
+Форт создан Чарлзом Муром в 70-е годы. Это императивный, стековый язык
+программирования и среда исполнения программ. Использовался в таких проектах
+как Open Firmware. Продолжает применяться в проектах. Применяется в НАСА.
 
-Внимание: этот материал использует реализацию Форта - Gforth, но большая часть написанного будет работать в других средах.
+Внимание: этот материал использует реализацию Форта - Gforth, но большая часть
+написанного будет работать в других средах.
 
 
 ```forth
 \ Это комментарий
-( Это тоже комментарий, но используется для предоределённых слов )
+( Это тоже комментарий, но используется для предопределённых слов )
 
 \ --------------------------------- Прекурсор --------------------------------
 
-\ Всё программирование на Форте заключается в манипулировании 
+\ Всё программирование на Форте заключается в манипулировании
 \ параметрами на стеке.
 5 2 3 56 76 23 65    \ ok
 
@@ -31,7 +34,7 @@ lang: ru-ru
 
 \ ---------------------------- Базовая арифметика ----------------------------
 
-\ Арифметика (фактически все ключевые слова требуют данных) - это манипуляция 
+\ Арифметика (фактически все ключевые слова требуют данных) - это манипуляция
 \ данными на стеке.
 5 4 +    \ ok
 
@@ -51,10 +54,10 @@ lang: ru-ru
 
 \ --------------------------- Манипуляции со стеком ---------------------------
 
-\ Естественно, когда мы работаем со стеком, то используем 
+\ Естественно, когда мы работаем со стеком, то используем
 \ больше полезных методов:
 
-3 dup -          \ дублировать верхний элемент в стеке 
+3 dup -          \ дублировать верхний элемент в стеке
                  \ (1-й становится эквивалентным 2-му): 3 - 3
 2 5 swap /       \ поменять местами верхний элемент со 2-м элементом: 5 / 2
 6 4 5 rot .s     \ сменять по очереди 3-и верхних элемента: 4 5 6
@@ -63,20 +66,20 @@ lang: ru-ru
 
 \ ------------------ Более продвинутые манипуляции со стеком ------------------
 
-1 2 3 4 tuck   \ дублировать верхний елемент стека во вторую позицию: 
+1 2 3 4 tuck   \ дублировать верхний элемент стека во вторую позицию:
                \ 1 2 4 3 4 ok
-1 2 3 4 over   \ диблировать второй елемент наверх стека: 
+1 2 3 4 over   \ дублировать второй элемент наверх стека:
                \ 1 2 3 4 3 ok
 1 2 3 4 2 roll \ *переместить* элемент в заданной позиции наверх стека:
                \ 1 3 4 2 ok
-1 2 3 4 2 pick \ *дублировать* элемент в заданной позиции наверх: 
+1 2 3 4 2 pick \ *дублировать* элемент в заданной позиции наверх:
                \ 1 2 3 4 2 ok
 
 \ Внимание! Обращения к стеку индексируются с нуля.
 
 \ --------------------------- Создание новых слов -----------------------------
 
-\ Определение новых слов через уже известные. Двоеточие `:` переводит Форт 
+\ Определение новых слов через уже известные. Двоеточие `:` переводит Форт
 \ в режим компиляции выражения, которое заканчивается точкой с запятой `;`.
 : square ( n -- n ) dup * ;    \ ok
 5 square .                     \ 25 ok
@@ -86,15 +89,15 @@ see square     \ : square dup * ; ok
 
 \ -------------------------------- Зависимости --------------------------------
 
-\ -1 == true, 0 == false. Однако, некоторые ненулевые значения 
+\ -1 == true, 0 == false. Однако, некоторые ненулевые значения
 \ обрабатываются как true:
 42 42 =    \ -1 ok
 12 53 =    \ 0 ok
 
 \ `if` это компилируемое слово. `if` <stuff to do> `then` <rest of program>.
-: ?>64 ( n -- n ) dup 64 > if ." Больше чем 64!" then ;   
+: ?>64 ( n -- n ) dup 64 > if ." Больше чем 64!" then ;
 \ ok
-100 ?>64                                                  
+100 ?>64
 \ Больше чем 64! ok
 
 \ Else:
@@ -119,7 +122,7 @@ myloop
 : one-to-12 ( -- ) 12 0 do i . loop ;     \ ok
 one-to-12                                 \ 0 1 2 3 4 5 6 7 8 9 10 11 12 ok
 
-\ `?do` работает подобным образом, за исключением пропуска начального 
+\ `?do` работает подобным образом, за исключением пропуска начального
 \ и конечного значения индекса цикла.
 : squares ( n -- ) 0 ?do i square . loop ;   \ ok
 10 squares                                   \ 0 1 4 9 16 25 36 49 64 81 ok
@@ -139,13 +142,13 @@ variable age    \ ok
 \ Затем мы запишем число 21 в переменную 'age' (возраст) словом `!`.
 21 age !    \ ok
 
-\ В заключении мы можем напечатать значение переменной прочитав его словом `@`, 
-\ которое добавит значение на стек или использовать слово `?`, 
+\ В заключении мы можем напечатать значение переменной прочитав его словом `@`,
+\ которое добавит значение на стек или использовать слово `?`,
 \ что бы прочитать и распечатать в одно действие.
 age @ .    \ 21 ok
 age ?      \ 21 ok
 
-\ Константы объявляются аналогично, за исключем того, что мы не должны 
+\ Константы объявляются аналогично, за исключем того, что мы не должны
 \ беспокоиться о выделении адреса в памяти:
 100 constant WATER-BOILING-POINT    \ ok
 WATER-BOILING-POINT .               \ 100 ok
@@ -155,7 +158,7 @@ WATER-BOILING-POINT .               \ 100 ok
 \ Создание массива похоже на объявление переменной, но нам нужно выделить
 \ больше памяти.
 
-\ Вы можете использовать слова `2 cells allot` для создания массива 
+\ Вы можете использовать слова `2 cells allot` для создания массива
 \ размером 3 элемента:
 variable mynumbers 2 cells allot    \ ok
 
@@ -165,7 +168,7 @@ mynumbers 3 cells erase    \ ok
 \ В качестве альтернативы мы можем использовать `fill`:
 mynumbers 3 cells 0 fill
 
-\ или мы можем пропустить все слова выше и инициализировать массив 
+\ или мы можем пропустить все слова выше и инициализировать массив
 \ нужными значениями:
 create mynumbers 64 , 9001 , 1337 , \ ok (the last `,` is important!)
 
@@ -205,7 +208,7 @@ mynumbers 1 of-arr ?       \ 20 ok
 
 \ ---------------- Операции над числами с плавающей точкой --------------------
 
-\ Многие фортовцы стараются избегать использование слов с вещественными числами.
+\ Многие фортовцы стараются избегать использования слов с вещественными числами.
 8.3e 0.8e f+ f.    \ 9.1 ok
 
 \ Обычно мы просто используем слово 'f', когда обращаемся к вещественным числам:
@@ -215,7 +218,7 @@ myfloatingvar f@ f.       \ 4.4 ok
 
 \ ---------- В завершение несколько полезных замечаний и слов -----------------
 
-\ Указание несуществующего слова очистит стек. Тем не менее, есть специальное 
+\ Указание несуществующего слова очистит стек. Тем не менее, есть специальное
 \ слово для этого:
 clearstack
 

ru-ru/html-ru.html.markdown

@@ -1,6 +1,6 @@
 ---
 language: HTML
-filename: learnhtml-ru.html
+filename: learnhtml-ru.txt
 contributors:
     - ["Christophe THOMAS", "https://github.com/WinChris"]
 translators:

ruby.html.markdown

@@ -91,7 +91,7 @@ false.class #=> FalseClass
 2 <= 2 #=> true
 2 >= 2 #=> true
 
-# Combined comparison operator (returns `1` when the first argument is greater, 
+# Combined comparison operator (returns `1` when the first argument is greater,
 # `-1` when the second argument is greater, and `0` otherwise)
 1 <=> 10 #=> -1 (1 < 10)
 10 <=> 1 #=> 1 (10 > 1)
@@ -259,8 +259,8 @@ else
   'else, also optional'
 end
 
-# If a condition controls invocation of a single statement rather than a block of code
-# you can use postfix-if notation
+# If a condition controls invocation of a single statement rather than a block
+# of code you can use postfix-if notation
 warnings = ['Patronimic is missing', 'Address too short']
 puts("Some warnings occurred:\n" + warnings.join("\n"))  if !warnings.empty?
 
@@ -268,7 +268,7 @@ puts("Some warnings occurred:\n" + warnings.join("\n"))  if !warnings.empty?
 puts("Some warnings occurred:\n" + warnings.join("\n"))  unless warnings.empty?
 
 # Loops
-# In Ruby, traditional `for` loops aren't very common. Instead, these 
+# In Ruby, traditional `for` loops aren't very common. Instead, these
 # basic loops are implemented using enumerable, which hinges on `each`.
 (1..5).each do |counter|
   puts "iteration #{counter}"
@@ -279,9 +279,10 @@ for counter in 1..5
   puts "iteration #{counter}"
 end
 
-# The `do |variable| ... end` construct above is called a 'block'. Blocks are similar
-# to lambdas, anonymous functions or closures in other programming languages. They can
-# be passed around as objects, called, or attached as methods.
+# The `do |variable| ... end` construct above is called a 'block'. Blocks are
+# similar to lambdas, anonymous functions or closures in other programming
+# languages. They can be passed around as objects, called, or attached as
+# methods.
 #
 # The 'each' method of a range runs the block once for each element of the range.
 # The block is passed a counter as a parameter.
@@ -415,19 +416,20 @@ surround { puts 'hello world' }
 #=> hello world
 #=> }
 
-# Blocks can be converted into a 'proc' object, which wraps the block 
-# and allows it to be passed to another method, bound to a different scope,
-# or manipulated otherwise. This is most common in method parameter lists,
-# where you frequently see a trailing '&block' parameter that will accept 
-# the block, if one is given, and convert it to a 'Proc'. The naming here is
-# convention; it would work just as well with '&pineapple'.
+# Blocks can be converted into a 'proc' object, which wraps the block and allows
+# it to be passed to another method, bound to a different scope, or manipulated
+# otherwise. This is most common in method parameter lists, where you frequently
+# see a trailing '&block' parameter that will accept the block, if one is given,
+# and convert it to a 'Proc'. The naming here is convention; it would work just
+# as well with '&pineapple'.
 def guests(&block)
   block.class #=> Proc
   block.call(4)
 end
 
-# The 'call' method on the Proc is similar to calling 'yield' when a block is 
-# present. The arguments passed to 'call' will be forwarded to the block as arguments.
+# The 'call' method on the Proc is similar to calling 'yield' when a block is
+# present. The arguments passed to 'call' will be forwarded to the block as
+# arguments.
 
 guests { |n| "You have #{n} guests." }
 # => "You have 4 guests."
@@ -443,7 +445,7 @@ end
 upcased = ['Watch', 'these', 'words', 'get', 'upcased'].map(&:upcase)
 puts upcased
 #=> ["WATCH", "THESE", "WORDS", "GET", "UPCASED"]
- 
+
 sum = [1, 2, 3, 4, 5].reduce(&:+)
 puts sum
 #=> 15
@@ -472,7 +474,7 @@ def best(first, second, third, *others)
   puts "There were #{others.count} other participants."
 end
 
-best *ranked_competitors 
+best *ranked_competitors
 #=> Winners are John, Sally, and Dingus.
 #=> There were 2 other participants.
 
@@ -480,9 +482,9 @@ best *ranked_competitors
 5.even? #=> false
 5.odd? #=> true
 
-# By convention, if a method name ends with an exclamation mark, it does something destructive
-# like mutate the receiver. Many methods have a ! version to make a change, and
-# a non-! version to just return a new changed version.
+# By convention, if a method name ends with an exclamation mark, it does
+# something destructive like mutate the receiver. Many methods have a ! version
+# to make a change, and a non-! version to just return a new changed version.
 company_name = "Dunder Mifflin"
 company_name.upcase #=> "DUNDER MIFFLIN"
 company_name #=> "Dunder Mifflin"
@@ -516,7 +518,8 @@ class Human
     @name
   end
 
-  # The above functionality can be encapsulated using the attr_accessor method as follows.
+  # The above functionality can be encapsulated using the attr_accessor method
+  # as follows.
   attr_accessor :name
 
   # Getter/setter methods can also be created individually like this.

shutit.html.markdown

@@ -3,7 +3,7 @@ category: framework
 framework: ShutIt
 contributors:
     - ["Ian Miell", "http://ian.meirionconsulting.tk"]
-filename: learnshutit.html
+filename: learnshutit.py
 ---
 
 ## ShutIt

vi-vn/html-vi.html.markdown

@@ -1,6 +1,6 @@
 ---
 language: HTML
-filename: learnhtml-vi.html
+filename: learnhtml-vi.txt
 contributors:
     - ["Christophe THOMAS", "https://github.com/WinChris"]
 translators:

wikitext.html.markdown

@@ -58,6 +58,7 @@ The syntax for tables is [very complicated](https://en.wikipedia.org/wiki/Help:T
 ```
 
 which renders to
+
 | **column title A** | **column title B** |
 |---|---|
 | cell A1 | cell B1 |
@@ -120,6 +121,7 @@ If a word is interrupted by a link, it is "blended" into the link. For example,
 To suppress this behavior, use `<nowiki>`. For example, `[[micro-]]<nowiki />second` renders to [micro-](https://en.wikipedia.org/wiki/micro-)second.
 
 There are three kinds of external linking. The third kind is preferred:
+
 | wikitext | renders to |
 |----|----|
 | `https://www.wikipedia.org` | [https://www.wikipedia.org](https://www.wikipedia.org) |

zh-cn/angularjs-cn.html.markdown

@@ -3,7 +3,7 @@ category: framework
 framework: AngularJS
 contributors:
     - ["Walter Cordero", "http://waltercordero.com"]
-filename: learnangular-cn.html
+filename: learnangular-cn.txt
 translators:
    - ["Jiang Haiyun", "http://www.atjiang.com"]
 lang: zh-cn

zh-cn/html-cn.html.markdown

@@ -1,6 +1,6 @@
 ---
 language: HTML
-filename: learnhtml-cn.html
+filename: learnhtml-cn.txt
 contributors:
     - ["Christophe THOMAS", "https://github.com/WinChris"]
 translators:

zh-cn/standard-ml-cn.html.markdown

@@ -5,7 +5,7 @@ contributors:
     - ["David Pedersen", "http://lonelyproton.com/"]
     - ["James Baker", "http://www.jbaker.io/"]
     - ["Leo Zovic", "http://langnostic.inaimathi.ca/"]
-filename: standard-ml-cn.html
+filename: standard-ml-cn.sml
 translators:
    - ["Buqian Zheng", "https://github.com/zhengbuqian"]
 lang: zh-cn