Browse Source

[doc] fix some typos in documentation (#154)

pull/156/head
Vaverka 4 years ago committed by GitHub
parent
commit
82e27580c9
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
  1. 2
      docs/src/customprocessing.md
  2. 4
      docs/src/fileformat.md
  3. 4
      docs/src/index.md
  4. 6
      docs/src/outputformats.md
  5. 2
      docs/src/tips.md
  6. 2
      examples/example.jl

2
docs/src/customprocessing.md

@ -10,7 +10,7 @@ is done by letting the user supply custom pre- and post-processing functions @@ -10,7 +10,7 @@ is done by letting the user supply custom pre- and post-processing functions
that may do transformation of the content.
All of the generators ([`Literate.markdown`](@ref), [`Literate.notebook`](@ref)
and [`Literate.script`](@ref)) accepts `preprocess` and `postprocess` keyword
and [`Literate.script`](@ref)) accept `preprocess` and `postprocess` keyword
arguments. The default "transformation" is the `identity` function. The input
to the transformation functions is a `String`, and the output should be the
transformed `String`.

4
docs/src/fileformat.md

@ -12,7 +12,7 @@ The basic syntax is simple: @@ -12,7 +12,7 @@ The basic syntax is simple:
- all other lines are treated as julia code.
Leading whitespace is allowed before `#`, but it will be removed when generating the
output. Since `#`-lines is treated as markdown we can not use that for regular julia
output. Since `#`-lines are treated as markdown we can not use that for regular julia
comments, for this you can instead use `## `, which will render as `# ` in the output.
Lets look at a simple example:
@ -113,7 +113,7 @@ is a case where we can prepend `#md` to those lines: @@ -113,7 +113,7 @@ is a case where we can prepend `#md` to those lines:
#md # ```
````
The lines in the example above would be filtered out in the preprocessing step, unless we are
generating a markdown file. When generating a markdown file we would simple remove
generating a markdown file. When generating a markdown file we would simply remove
the leading `#md ` from the lines. Beware that the space after the tag is also removed.
The `#src` token can also be placed at the *end* of a line. This is to make it possible

4
docs/src/index.md

@ -29,8 +29,8 @@ Examples are (probably) the best way to showcase your awesome package, and examp @@ -29,8 +29,8 @@ Examples are (probably) the best way to showcase your awesome package, and examp
are often the best way for a new user to learn how to use it. It is therefore important
that the documentation of your package contains examples for users to read and study.
However, people are different, and we all prefer different ways of trying out a new
package. Some people wants to RTFM, others want to explore the package interactively in,
for example, a notebook, and some people wants to study the source code. The aim of
package. Some people want to RTFM, others want to explore the package interactively in,
for example, a notebook, and some people want to study the source code. The aim of
Literate is to make it easy to give the user all of these options, while still
keeping maintenance to a minimum.

6
docs/src/outputformats.md

@ -1,6 +1,6 @@ @@ -1,6 +1,6 @@
# [**4.** Output Formats](@id Output-Formats)
When the source is parsed, and have been processed it is time to render the output.
When the source is parsed, and has been processed it is time to render the output.
We will consider the following source snippet:
```@eval
@ -143,10 +143,10 @@ keyword arguments. @@ -143,10 +143,10 @@ keyword arguments.
Passing configuration as a dictionary requires at least Literate version 2.2.
!!! note "Configuration precedence"
Individual keyword arguments takes precedence over the `config` dictionary, so for e.g.
Individual keyword arguments take precedence over the `config` dictionary, so for e.g.
`Literate.markdown(...; config = Dict("name" => "hello"), name = "world")` the
resulting configuration for `name` will be `"world"`. Both individual keyword arguments
and the `config` dictionary takes precedence over the default.
and the `config` dictionary take precedence over the default.
Available configurations with description and default values are given in the reference for
[`Literate.DEFAULT_CONFIGURATION`](@ref) just below.

2
docs/src/tips.md

@ -19,7 +19,7 @@ the generated notebook can become large. @@ -19,7 +19,7 @@ the generated notebook can become large.
In order to remedy this you can use the clever Julia package
[`DisplayAs`](https://github.com/tkf/DisplayAs.jl) to limit the output capabilities of
and object. For example, to "force" an image to be captures as `image/png` only,
an object. For example, to "force" an image to be captures as `image/png` only,
you can use
```julia

2
examples/example.jl

@ -8,7 +8,7 @@ @@ -8,7 +8,7 @@
# This is an example generated with Literate based on this
# source file: [`example.jl`](@__REPO_ROOT_URL__/examples/example.jl).
# You are seeing the
#md # HTML-output which Documenter have generated based on a markdown
#md # HTML-output which Documenter has generated based on a markdown
#md # file generated with Literate. The corresponding notebook
#md # can be viewed in [nbviewer](http://nbviewer.jupyter.org/) here:
#md # [`example.ipynb`](@__NBVIEWER_ROOT_URL__/generated/example.ipynb),

Loading…
Cancel
Save