calibredb, calibre-server, ebook-convert: add pages

[85pando]

Calibre is a program to manage your ebook library. It has several usefull command-line tools.

[lord63]

Don't forget to update the index.json

[igorshubovych]

@rprieto,

I noticed there are 2 different ways of listing multiple related arguments.

In this and some other pages several arguments are listed in one token:
calibredb add {{file1, file2, …}}
zip -r {{compressed.zip}} {{/path/to/dir1 /path/to/dir2 /path/to/file}}

On other pages arguments are listed one by one,
diff {{file1}} {{file2}}
zpool create {{poolname}} mirror {{disk1}} {{disk2}}

What is the preferred way?

[85pando]

Given this comment from rprieto i think it is clear it should be one command per example.

[igorshubovych]

This commit has one command per example as it is mentioned in Contributing guidelines.

My question was regarding the way tokens are listed in a single example.

command {{file1, file2}}

vs

command {{file1}} {{file2}}

[85pando]

Sorry, too early (-;

User-provided values should use the {{token}} syntax, to allow clients to highlight them. For example: tar cf {{file}}

So in my understanding, the token is just needed for highlighting values. For the diff example at least that is a different case, as both values are needed. In calibredb add you need one file but more files are possible.

[rprieto]

Just a missing backtick here

[igorshubovych]

@rprieto,

Can we automate checking missing backticks?