aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorShim Myeongseob <zzangsim231@gmail.com>2019-05-02 09:09:36 +0900
committerJohn MacFarlane <jgm@berkeley.edu>2019-05-01 20:09:36 -0400
commit73efef589a14616972cf4e3b96b3b1dc366b80f1 (patch)
tree165a73dc724d6d5a4acf7bd22a50af08496b1bbf
parenta20323033ee0a718fc18ec2db00c913369944e29 (diff)
downloadpandoc-73efef589a14616972cf4e3b96b3b1dc366b80f1.tar.gz
Fix broken links in documents (#5473)
Fix broken links in doc/epub.md, doc/getting-started.md, doc/customizing-pandoc.md, doc/using-the-pandoc-api.md. Also, use absolute links to pandoc.org when possible, so that the links can be followed by people viewing these documents on GitHub.
-rw-r--r--doc/customizing-pandoc.md26
-rw-r--r--doc/epub.md18
-rw-r--r--doc/filters.md12
-rw-r--r--doc/getting-started.md18
-rw-r--r--doc/lua-filters.md4
-rw-r--r--doc/using-the-pandoc-api.md2
6 files changed, 40 insertions, 40 deletions
diff --git a/doc/customizing-pandoc.md b/doc/customizing-pandoc.md
index 62094e5ce..cba38b2c6 100644
--- a/doc/customizing-pandoc.md
+++ b/doc/customizing-pandoc.md
@@ -46,14 +46,14 @@ There are several ways to set template variables:
| accessible by filters: | no | yes | yes |
-[`--variable`]: http://pandoc.org/MANUAL.html#option--variable
-[`--metadata`]: http://pandoc.org/MANUAL.html#option--metadata
-[YAML metadata]: http://pandoc.org/MANUAL.html#extension-yaml_metadata_block
-[`--metadata-file`]: http://pandoc.org/MANUAL.html#option--metadata-file
+[`--variable`]: https://pandoc.org/MANUAL.html#option--variable
+[`--metadata`]: https://pandoc.org/MANUAL.html#option--metadata
+[YAML metadata]: https://pandoc.org/MANUAL.html#extension-yaml_metadata_block
+[`--metadata-file`]: https://pandoc.org/MANUAL.html#option--metadata-file
-For more information, see [Templates](/MANUAL.html#templates) in
+For more information, see [Templates](https://pandoc.org/MANUAL.html#templates) in
the pandoc manual.
### Example: adding structured author data to HTML
@@ -73,7 +73,7 @@ For `docx`, `pptx` or `odt` documents, things are a bit more
complicated. Instead of a single template file, you need to
provide a customized `reference.docx/pptx/odt`.
See the manual for the
-[`--reference-doc`](/MANUAL.html#option--reference-doc) option.
+[`--reference-doc`](https://pandoc.org/MANUAL.html#option--reference-doc) option.
### Example: changing the font and line spacing in a Word docx
@@ -111,9 +111,9 @@ use an interface built directly into pandoc, and must be written
in the Lua language). If you are writing your own filters, it
is best to use Lua filters, which are more portable (they
require only pandoc itself) and more efficient. See [Lua
-filters](lua-filters.html) for documentation and examples. If
+filters](https://pandoc.org/lua-filters.html) for documentation and examples. If
you would prefer to write your filter in another language, see
-[Filters](filters.html) for a gentle introduction to JSON
+[Filters](https://pandoc.org/filters.html) for a gentle introduction to JSON
filters.
There's a repository of lua filters at
@@ -136,7 +136,7 @@ TODO
## Generic Divs and Spans
TODO
-[Divs and Spans](/MANUAL.html#divs-and-spans): generic blocks
+[Divs and Spans](https://pandoc.org/MANUAL.html#divs-and-spans): generic blocks
that can be transformed with filters
### Example: colored text
@@ -144,23 +144,23 @@ that can be transformed with filters
### Example: custom styles in docx
-[Custom Styles in Docx](/MANUAL.html#custom-styles-in-docx)
+[Custom Styles in Docx](https://pandoc.org/MANUAL.html#custom-styles-in-docx)
## Raw attributes
TODO
-[Generic raw attributes](/MANUAL.html#generic-raw-attribute):
+[Generic raw attributes](https://pandoc.org/MANUAL.html#generic-raw-attribute):
to include raw snippets
## Custom writers
TODO
-[Custom writers](/MANUAL.html#custom-writers)
+[Custom writers](https://pandoc.org/MANUAL.html#custom-writers)
## Custom syntax highlighting
TODO
-[Custom syntax highlighting](/MANUAL.html#syntax-highlighting),
+[Custom syntax highlighting](https://pandoc.org/MANUAL.html#syntax-highlighting),
provided by the [skylighting
library](https://github.com/jgm/skylighting)
diff --git a/doc/epub.md b/doc/epub.md
index 0a8131c60..82c26dcef 100644
--- a/doc/epub.md
+++ b/doc/epub.md
@@ -53,7 +53,7 @@ please consider [buying a copy] to help support his excellent work.)
You can find the markdown source for the book on its
[github site]. Let's get a copy of the whole repository:[^1]
- git clone http://github.com/progit/progit.git
+ git clone https://github.com/progit/progit.git
[^1]: If you don't have [git], you can browse to the [github site] and
click "Download Source" to get the same files in a zip or tar archive.
@@ -105,7 +105,7 @@ language: en-US
...
```
-See the [User's Guide](MANUAL.html#epub-metadata) for more information
+See the [User's Guide](https://pandoc.org/MANUAL.html#epub-metadata) for more information
above these fields.
Now run pandoc to make the ebook, using our title page and modified
@@ -144,13 +144,13 @@ Of course, this isn't much help if you want EPUB2 output (`pandoc -t epub2`)
or target readers that don't support MathML. Then you should try using the
`--webtex` option, which will use a web service to convert the TeX to an image.
-[KindleGen]: http://www.amazon.com/gp/feature.html?ie=UTF8&docId=1000234621
-[EPUB]: http://en.wikipedia.org/wiki/EPUB
+[KindleGen]: https://www.amazon.com/gp/feature.html?ie=UTF8&docId=1000765211
+[EPUB]: https://en.wikipedia.org/wiki/EPUB
[Pro Git]: https://git-scm.com/book/en/v2
-[Creative Commons]: http://creativecommons.org/
+[Creative Commons]: https://creativecommons.org/
[buying a copy]: https://git-scm.com/book/en/v2
-[github site]: http://github.com/progit/progit
-[git]: http://git-scm.com
-[Dublin Core metadata elements]: http://dublincore.org/documents/dces/
-[User's Guide]: MANUAL.html
+[github site]: https://github.com/progit/progit
+[git]: https://git-scm.com
+[Dublin Core metadata elements]: https://dublincore.org/documents/dces/
+[User's Guide]: https://pandoc.org/MANUAL.html
diff --git a/doc/filters.md b/doc/filters.md
index c3edd0e46..0b48c8002 100644
--- a/doc/filters.md
+++ b/doc/filters.md
@@ -104,7 +104,7 @@ metadata like title, authors, and date) and a list of `Block`
Each has as its content a list of `Inline` elements. For more details on
the pandoc AST, see the [haddock documentation for `Text.Pandoc.Definition`].
-[haddock documentation for `Text.Pandoc.Definition`]: http://hackage.haskell.org/package/pandoc-types
+[haddock documentation for `Text.Pandoc.Definition`]: https://hackage.haskell.org/package/pandoc-types
Here's a short Haskell script that reads markdown, changes level
2+ headers to regular paragraphs, and writes the result as markdown.
@@ -141,7 +141,7 @@ our `behead` function (a function from `Block` to `Block`) to
a transformation on whole `Pandoc` documents.
(See the [haddock documentation for `Text.Pandoc.Walk`].)
-[haddock documentation for `Text.Pandoc.Walk`]: http://hackage.haskell.org/package/pandoc-types
+[haddock documentation for `Text.Pandoc.Walk`]: https://hackage.haskell.org/package/pandoc-types
# Queries: listing URLs
@@ -307,10 +307,10 @@ Note that, although these parameters are not used in this example,
the document's metadata.
There are many examples of python filters in [the pandocfilters
-repository](http://github.com/jgm/pandocfilters).
+repository](https://github.com/jgm/pandocfilters).
For a more Pythonic alternative to pandocfilters, see
-the [panflute](http://scorreia.com/software/panflute/) library.
+the [panflute](https://pypi.org/project/panflute) library.
Don't like Python? There are also ports of pandocfilters in
[PHP](https://github.com/vinai/pandocfilters-php),
[perl](https://metacpan.org/pod/Pandoc::Filter),
@@ -322,7 +322,7 @@ Starting with pandoc 2.0, pandoc includes built-in support for
writing filters in lua. The lua interpreter is built in to
pandoc, so a lua filter does not require any additional software
to run. See the [documentation on lua
-filters](lua-filters.html).
+filters](https://pandoc.org/lua-filters.html).
# Include files
@@ -382,7 +382,7 @@ from an `Inline` element to a list of `Inline` elements.
# A filter for ruby text
Finally, here's a nice real-world example, developed on the
-[pandoc-discuss](http://groups.google.com/group/pandoc-discuss/browse_thread/thread/7baea325565878c8) list. Qubyte wrote:
+[pandoc-discuss](https://groups.google.com/group/pandoc-discuss/browse_thread/thread/7baea325565878c8) list. Qubyte wrote:
> I'm interested in using pandoc to turn my markdown notes on Japanese
> into nicely set HTML and (Xe)LaTeX. With HTML5, ruby (typically used to
diff --git a/doc/getting-started.md b/doc/getting-started.md
index 14d0fa046..e82e7368a 100644
--- a/doc/getting-started.md
+++ b/doc/getting-started.md
@@ -5,12 +5,12 @@ author: John MacFarlane
This document is for people who are unfamiliar with command line
tools. Command-line experts can go straight to the [User's
-Guide](README.html) or the pandoc man page.
+Guide](https://pandoc.org/MANUAL.html) or the pandoc man page.
# Step 1: Install pandoc
First, install pandoc, following the [instructions for
-your platform](installing.html).
+your platform](https://pandoc.org/installing.html).
# Step 2: Open a terminal
@@ -212,9 +212,9 @@ Now save your file as `test1.md` in the directory
Note: If you use plain text a lot, you'll want a better editor than
`Notepad` or `TextEdit`. You might want to look at
-[Sublime Text](http://www.sublimetext.com/) or (if you're willing
+[Sublime Text](https://www.sublimetext.com/) or (if you're willing
to put in some time learning an unfamiliar interface)
-[Vim](http://www.vim.org) or [Emacs](http://www.gnu.org/software/emacs).
+[Vim](https://www.vim.org) or [Emacs](https://www.gnu.org/software/emacs).
# Step 6: Converting a file
@@ -271,8 +271,8 @@ Pandoc knows you're trying to create a LaTeX document, because of the
Now try creating a Word document (with extension `docx`).
If you want to create a PDF, you'll need to have LaTeX installed.
-(See [MacTeX](http://tug.org/mactex/) on OS X,
-[MiKTeX](http://miktex.org) on Windows, or install the texlive
+(See [MacTeX](https://tug.org/mactex/) on OS X,
+[MiKTeX](https://miktex.org) on Windows, or install the texlive
package in linux.) Then do
pandoc test1.md -s -o test1.pdf
@@ -281,7 +281,7 @@ package in linux.) Then do
You now know the basics. Pandoc has a lot of options. At this point
you can start to learn more about them by reading the
-[User's Guide](README.html).
+[User's Guide](https://pandoc.org/MANUAL.html).
Here's an example. The `--mathml` option causes pandoc to
convert TeX math into MathML. Type
@@ -311,8 +311,8 @@ to get the pandoc manual page. All of this information is also
in the User's Guide.
If you get stuck, you can always ask questions on the
-[pandoc-discuss](http://groups.google.com/group/pandoc-discuss)
-mailing list. But be sure to check the [FAQs](faqs.html) first,
+[pandoc-discuss](https://groups.google.com/group/pandoc-discuss)
+mailing list. But be sure to check the [FAQs](https://pandoc.org/faqs.html) first,
and search through the mailing list to see if your question has
been answered before.
diff --git a/doc/lua-filters.md b/doc/lua-filters.md
index 4bc8bcb54..433233ea1 100644
--- a/doc/lua-filters.md
+++ b/doc/lua-filters.md
@@ -11,7 +11,7 @@ title: Pandoc Lua Filters
Pandoc has long supported filters, which allow the pandoc
abstract syntax tree (AST) to be manipulated between the parsing
and the writing phase. [Traditional pandoc
-filters](filters.html) accept a JSON representation of the
+filters](https://pandoc.org/filters.html) accept a JSON representation of the
pandoc AST and produce an altered JSON representation of the
AST. They may be written in any programming language, and
invoked from pandoc using the `--filter` option.
@@ -508,7 +508,7 @@ end
This filter replaces code blocks with class `abc` with images
created by running their contents through `abcm2ps` and
ImageMagick's `convert`. (For more on ABC notation, see
-<http://abcnotation.com>.)
+<https://abcnotation.com>.)
Images are added to the mediabag. For output to binary formats,
pandoc will use images in the mediabag. For textual formats, use
diff --git a/doc/using-the-pandoc-api.md b/doc/using-the-pandoc-api.md
index 550b38c65..25c384789 100644
--- a/doc/using-the-pandoc-api.md
+++ b/doc/using-the-pandoc-api.md
@@ -459,4 +459,4 @@ structure and calling this function.
[Text.Pandoc.Logging]: https://hackage.haskell.org/package/pandoc/docs/Text-Pandoc-Logging.html
[Text.Pandoc.App]: https://hackage.haskell.org/package/pandoc/docs/Text-Pandoc-App.html
[Text.Pandoc.Error]: https://hackage.haskell.org/package/pandoc/docs/Text-Pandoc-Error.html
-[Text.Pandoc.Writers.Shared]: https://hackage.haskell.org/package/pandoc/docs/Text-Pandoc-Writers.Shared.html
+[Text.Pandoc.Writers.Shared]: https://hackage.haskell.org/package/pandoc/docs/Text-Pandoc-Writers-Shared.html