Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix the disable comments for the markdown formatter #1493

Merged
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion concepts/docs/about.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ If you have Elixir installed on your computer, you can use it in [the interactiv

In `iex`, you can type [`h`][iex-h], followed by a space and a module name or a function name, to read its documentation.

[]: # (elixir-formatter-disable-next-block)
[//]: # (elixir-formatter-disable-next-block)

```elixir
iex()> h String.upcase/1
Expand Down
4 changes: 2 additions & 2 deletions concepts/keyword-lists/about.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Keyword.keyword?([{"month", "April"}])

If you want to use characters other than letters, numbers, and `_` in the key, you need to wrap it in quotes. However, that does not make it a string - it is still an atom.

[]: # (elixir-formatter-disable-next-block)
[//]: # (elixir-formatter-disable-next-block)

```elixir
Keyword.keyword?(["day of week": "Monday"])
Expand Down Expand Up @@ -61,7 +61,7 @@ if age >= 16, do: "beer", else: "no beer"

This may look like `if` accepts two arguments, but the `do:` and `else:` pair is actually a single argument - a keyword list. The same code could be written as:

[]: # (elixir-formatter-disable-next-block)
[//]: # (elixir-formatter-disable-next-block)

```elixir
if age >= 16, [do: "beer", else: "no beer"]
Expand Down
2 changes: 1 addition & 1 deletion concepts/list-comprehensions/about.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

[Comprehension][for] provide a facility for transforming _Enumerables_ easily and declaratively. They are _syntactic sugar_ for iterating through enumerables in Elixir.

[]: # (elixir-formatter-disable-next-block)
[//]: # (elixir-formatter-disable-next-block)

```elixir
for s <- ["a", "b", "hello", "c"], # 1. generator
Expand Down
2 changes: 1 addition & 1 deletion concepts/nil/about.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ favorite_color = nil

`nil` is an atom, but it is usually written as `nil`, not `:nil`. The boolean values `true` and `false` are atoms too.

[]: # (elixir-formatter-disable-next-block)
[//]: # (elixir-formatter-disable-next-block)

```elixir
nil === :nil
Expand Down
10 changes: 4 additions & 6 deletions concepts/try-rescue/about.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,19 +4,17 @@

For example:

[]: # (elixir-formatter-disable-next-block)

```elixir
try do #1
raise RuntimeError, "error" #2
try do
raise RuntimeError, "error"
rescue
e in RuntimeError -> :error #3
e in RuntimeError -> :error
end
```

- **Line 1**, the block is declared with `try`.
- **Line 2**, the function call which may generate an error is placed here, in this case we are calling `raise/1`.
- **Line 3**, in the `rescue` section, we pattern match on the _Module_ name of the error raised
- **Line 4**, in the `rescue` section, we pattern match on the _Module_ name of the error raised
- on the left side of `->`:
- `e` is matched to the error struct.
- `in` is a keyword.
Expand Down
10 changes: 4 additions & 6 deletions concepts/try-rescue/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,21 +2,19 @@

Elixir provides a construct for rescuing from errors using `try .. rescue`

[]: # (elixir-formatter-disable-next-block)

```elixir
try do #1
raise RuntimeError, "error" #2
try do
raise RuntimeError, "error"
rescue
e in RuntimeError -> :error #3
e in RuntimeError -> :error
end
```

Let's examine this construct:

- **Line 1**, the block is declared with `try`.
- **Line 2**, the function call which may error is placed here, in this case we are calling `raise/2`.
- **Line 3**, in the `rescue` section, we pattern match on the _Module_ name of the error raised
- **Line 4**, in the `rescue` section, we pattern match on the _Module_ name of the error raised
- on the left side of `->`:
- `e` is matched to the error struct.
- `in` is a keyword.
Expand Down
2 changes: 1 addition & 1 deletion docs/REPRESENTER_NORMALIZATIONS.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ Types are written without.

### Before

[]: # (elixir-formatter-disable-next-block)
[//]: # (elixir-formatter-disable-next-block)

```elixir
defmodule Fake do
Expand Down
2 changes: 1 addition & 1 deletion docs/TESTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ Multiple tests may be executed by giving multiple line numbers separated by `:`.

For example, given a file with the following content with line numbers:

[]: # (elixir-formatter-disable-next-block)
[//]: # (elixir-formatter-disable-next-block)

```elixir
test "Test 1" do # 1
Expand Down
10 changes: 4 additions & 6 deletions exercises/concept/rpn-calculator/.docs/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,21 +15,19 @@ Map.fetch!(%{a: 1}, :b)

Elixir provides a construct for rescuing from errors using `try .. rescue`

[]: # (elixir-formatter-disable-next-block)

```elixir
try do #1
raise RuntimeError, "error" #2
try do
raise RuntimeError, "error"
rescue
e in RuntimeError -> :error #3
e in RuntimeError -> :error
end
```

Let's examine this construct:

- **Line 1**, the block is declared with `try`.
- **Line 2**, the function call which may error is placed here, in this case we are calling `raise/2`.
- **Line 3**, in the `rescue` section, we pattern match on the _Module_ name of the error raised
- **Line 4**, in the `rescue` section, we pattern match on the _Module_ name of the error raised
- on the left side of `->`:
- `e` is matched to the error struct.
- `in` is a keyword.
Expand Down
4 changes: 2 additions & 2 deletions exercises/practice/leap/.approaches/clauses/content.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ While in the [operators approach][operators-approach], it was possible to reorde

In our case, the three guards in the function clauses are as follows:

[]: # (elixir-formatter-disable-next-block)
[//]: # (elixir-formatter-disable-next-block)

```elixir
when rem(year, 400) == 0
Expand All @@ -28,7 +28,7 @@ when rem(year, 4) == 0

But because of the order they are evaluated in, they are equivalent to:

[]: # (elixir-formatter-disable-next-block)
[//]: # (elixir-formatter-disable-next-block)

```elixir
when rem(year, 400) == 0
Expand Down
2 changes: 1 addition & 1 deletion exercises/practice/leap/.approaches/operators/content.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ However, if `left` is *false*, `right` has to be evaluated to determine the outc

## Precedence of operators

[]: # (elixir-formatter-disable-next-block)
[//]: # (elixir-formatter-disable-next-block)

Another thing to consider when using Boolean operators is their precedence.
```elixir
Expand Down
Loading