diff --git a/manual/conversion.rst b/manual/conversion.rst index 01423155b6..5dc65f913d 100644 --- a/manual/conversion.rst +++ b/manual/conversion.rst @@ -696,7 +696,7 @@ TXT input supports a number of options to differentiate how paragraphs are detec allows for basic formatting to be added to TXT documents, such as bold, italics, section headings, tables, lists, a Table of Contents, etc. Marking chapter headings with a leading # and setting the chapter XPath detection expression to "//h:h1" is the easiest way to have a proper table of contents generated from a TXT document. - You can learn more about the markdown syntax at `daringfireball `_. + You can learn more about the markdown syntax at `daringfireball `_. :guilabel:`Formatting Style: None` Applies no special formatting to the text, the document is converted to html with no other changes. @@ -755,10 +755,10 @@ calibre will automatically convert this .cbc file into a ebook with a Table of C EPUB advanced formatting demo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Various advanced formatting for EPUB files is demonstrated in this `demo file `_. +Various advanced formatting for EPUB files is demonstrated in this `demo file `_. The file was created from hand coded HTML using calibre and is meant to be used as a template for your own EPUB creation efforts. -The source HTML it was created from is available `demo.zip `_. The settings used to create the +The source HTML it was created from is available `demo.zip `_. The settings used to create the EPUB from the ZIP file are:: ebook-convert demo.zip .epub -vv --authors "Kovid Goyal" --language en --level1-toc '//*[@class="title"]' --disable-font-rescaling --page-breaks-before / --no-default-epub-cover diff --git a/manual/creating_plugins.rst b/manual/creating_plugins.rst index 53909192b0..22f63eaf2b 100644 --- a/manual/creating_plugins.rst +++ b/manual/creating_plugins.rst @@ -262,7 +262,7 @@ visible strings as translatable, by surrounding them in _(). For example:: Then use some program to generate .po files from your plugin source code. There should be one .po file for every language you want to translate into. For example: de.po for German, fr.po for French and so on. You can use the -`poedit `_ program for this. +`poedit `_ program for this. Send these .po files to your translators. Once you get them back, compile them into .mo files. You can again use poedit for that, or just do:: diff --git a/manual/develop.rst b/manual/develop.rst index e37d86e596..61086b3641 100644 --- a/manual/develop.rst +++ b/manual/develop.rst @@ -77,7 +77,7 @@ Getting the code You can get the calibre source code in two ways, using a version control system or directly downloading a `tarball `_. -calibre uses `Git `_, a distributed version control +calibre uses `Git `_, a distributed version control system. Git is available on all the platforms calibre supports. After installing Git, you can get the calibre source code with the command:: diff --git a/manual/edit.rst b/manual/edit.rst index 20822e1cd7..463f47c46c 100644 --- a/manual/edit.rst +++ b/manual/edit.rst @@ -444,7 +444,7 @@ beautify. Accessed via :guilabel:`Tools->Beautify all files`. beautified. This can sometimes mean that a particular file will not be affected by beautify as it has no suitable block level tags. In such cases you can try different beautification tools, that are less careful, - for example: `HTML Tidy `_. + for example: `HTML Tidy `_. Inserting an inline Table of Contents @@ -664,7 +664,7 @@ Spanish languages. You can install your own dictionaries via :guilabel:`Preferences->Editor->Manage spelling dictionaries`. The spell checker can use dictionaries from the LibreOffice program (in the .oxt format). You can download these dictionaries from -`The LibreOffice Extensions repository `_. +`The LibreOffice Extensions repository `_. Inserting special characters diff --git a/manual/faq.rst b/manual/faq.rst index bf82e73548..7189808848 100644 --- a/manual/faq.rst +++ b/manual/faq.rst @@ -301,7 +301,7 @@ With recent reader iterations, SONY, in all its wisdom has decided to try to for use their software. If you install it, it auto-launches whenever you connect the reader. If you don't want to uninstall it altogether, there are a couple of tricks you can use. The simplest is to simply re-name the executable file that launches the library program. More detail -`in the forums `_. +`in the forums `_. How do I use calibre with my iPad/iPhone/iPod touch? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -382,7 +382,7 @@ iBooks. With the USB cable + iTunes ^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Use the 'Connect to iTunes' method in the 'Getting started' instructions in `Calibre + Apple iDevices: Start here `_. +Use the 'Connect to iTunes' method in the 'Getting started' instructions in `Calibre + Apple iDevices: Start here `_. This method only works on Windows Vista and higher, and OS X up to 10.8. Linux is not supported (iTunes is not available in linux) and OS X newer than 10.8 is @@ -610,7 +610,7 @@ How does calibre manage author names and sorting? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Author names are complex, especially across cultures, see `this note -`_ +`_ for some of the complexities. calibre has a very flexible strategy for managing author names. The first thing to understand is that books and authors are separate entities in calibre. A book can have more than one author, and an @@ -811,7 +811,7 @@ I want calibre to download news from my favorite news website. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you are reasonably proficient with computers, you can teach calibre to download news from any website of your choosing. To learn how to do this see :ref:`news`. -Otherwise, you can request a particular news site by posting in the `calibre Recipes forum `_. +Otherwise, you can request a particular news site by posting in the `calibre Recipes forum `_. Why the name calibre? @@ -865,7 +865,7 @@ If it still wont launch, start a command prompt (press the windows key and R; th calibre-debug -g -Post any output you see in a help message on the `Forum `_. +Post any output you see in a help message on the `Forum `_. calibre freezes/crashes occasionally? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -1083,11 +1083,11 @@ For many reasons: updating trivial. Instructions are :ref:`available here `. * There are third party automatic updaters for calibre made by calibre users - in the `calibre forum `_. + in the `calibre forum `_. How is calibre licensed? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -calibre is licensed under the GNU General Public License v3 (an open source license). This means that you are free to redistribute calibre as long as you make the source code available. So if you want to put calibre on a CD with your product, you must also put the calibre source code on the CD. The source code is available `for download `_. You are free to use the results of conversions from calibre however you want. You cannot use either code or libraries from calibre in your software without making your software open source. For details, see `The GNU GPL v3 `_. +calibre is licensed under the GNU General Public License v3 (an open source license). This means that you are free to redistribute calibre as long as you make the source code available. So if you want to put calibre on a CD with your product, you must also put the calibre source code on the CD. The source code is available `for download `_. You are free to use the results of conversions from calibre however you want. You cannot use either code or libraries from calibre in your software without making your software open source. For details, see `The GNU GPL v3 `_. How do I run calibre from my USB stick? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/manual/gui.rst b/manual/gui.rst index 11b9f9167d..c3c31f9874 100644 --- a/manual/gui.rst +++ b/manual/gui.rst @@ -94,7 +94,7 @@ Convert books :class: float-right-img |cei| Ebooks can be converted from a number of formats into whatever format your ebook reader prefers. -Many ebooks available for purchase will be protected by `Digital Rights Management `_ *(DRM)* technology. +Many ebooks available for purchase will be protected by `Digital Rights Management `_ *(DRM)* technology. calibre will not convert these ebooks. It is easy to remove the DRM from many formats, but as this may be illegal, you will have to find tools to liberate your books yourself and then use calibre to convert them. @@ -338,7 +338,7 @@ are available in the LRF format. Some more examples:: format:epub publisher:feedbooks.com Searches are by default 'contains'. An item matches if the search string appears anywhere in the indicated metadata. -Two other kinds of searches are available: equality search and search using `regular expressions `_. +Two other kinds of searches are available: equality search and search using `regular expressions `_. Equality searches are indicated by prefixing the search string with an equals sign (=). For example, the query ``tag:"=science"`` will match "science", but not "science fiction" or "hard science". Regular expression searches are diff --git a/manual/news.rst b/manual/news.rst index 10cddf8b02..1f9b07603b 100644 --- a/manual/news.rst +++ b/manual/news.rst @@ -29,7 +29,7 @@ The calibre blog is a blog of posts that describe many useful calibre features in a simple and accessible way for new calibre users. In order to download this blog into an ebook, we rely on the :term:`RSS` feed of the blog:: - http://blog.calibre-ebook.com/feeds/posts/default + https://blog.calibre-ebook.com/feeds/posts/default I got the RSS URL by looking under "Subscribe to" at the bottom of the blog page and choosing :guilabel:`Posts->Atom`. To make calibre download the feeds and convert @@ -267,7 +267,7 @@ to go to http://www.nytimes.com/pages/todayspaper/index.html and fetch the list of articles that appear in *todays* paper. While more complex than simply using :term:`RSS`, the recipe creates an ebook that corresponds very closely to the days paper. ``parse_index`` makes heavy use of `BeautifulSoup -`_ to parse +`_ to parse the daily paper webpage. You can also use other, more modern parsers if you dislike BeatifulSoup. calibre comes with `lxml `_ and `html5lib `_, which are the diff --git a/manual/server.rst b/manual/server.rst index 58c5d09a1b..5c401ade3b 100644 --- a/manual/server.rst +++ b/manual/server.rst @@ -112,5 +112,5 @@ Change the path to :file:`calibre-wsgi-adapter.py` to wherever you saved it prev That's all, you will now be able to access the calibre Content Server under the /calibre URL in your apache server. -.. note:: For more help with using mod_wsgi in Apache, see `mod_wsgi `_. +.. note:: For more help with using mod_wsgi in Apache, see `mod_wsgi `_. diff --git a/manual/snippets.rst b/manual/snippets.rst index c32ddfac61..65a1080787 100644 --- a/manual/snippets.rst +++ b/manual/snippets.rst @@ -40,7 +40,7 @@ Inserting filler text [Lorem] The first built-in snippet, and the simplest is used to insert filler text into a document. The filler text is taken from `De finibus bonorum et malorum -`_ a philosophical +`_ a philosophical work by Cicero (translated to English). To use it simply type ``Lorem`` in an HTML file and press |ct|. It will be replaced by a couple of paragraphs of filler. diff --git a/manual/typesetting_math.rst b/manual/typesetting_math.rst index 30e24ea8b2..fbe442b3bd 100644 --- a/manual/typesetting_math.rst +++ b/manual/typesetting_math.rst @@ -61,5 +61,5 @@ More information Since the calibre viewer uses the MathJax library to render mathematics, the best place to find out more about math in ebooks and get help is the `MathJax -website `_. +website `_. diff --git a/src/calibre/web/feeds/news.py b/src/calibre/web/feeds/news.py index 54e8f9966d..a29383df82 100644 --- a/src/calibre/web/feeds/news.py +++ b/src/calibre/web/feeds/news.py @@ -226,7 +226,7 @@ class BasicNewsRecipe(Recipe): #: } #: #: All keys are optional. For a full explanation of the search criteria, see - #: `Beautiful Soup `_ + #: `Beautiful Soup `_ #: A common example:: #: #: remove_tags = [dict(name='div', attrs={'class':'advert'})] @@ -320,7 +320,7 @@ class BasicNewsRecipe(Recipe): #: are expressed as a percentage of the downloaded cover. #: cover_margins = (10, 15, '#ffffff') pads the cover with a white margin #: 10px on the left and right, 15px on the top and bottom. - #: Color names defined at http://www.imagemagick.org/script/color.php + #: Color names defined at https://www.imagemagick.org/script/color.php #: Note that for some reason, white does not always work on windows. Use #: #ffffff instead cover_margins = (0, 0, '#ffffff') @@ -471,7 +471,7 @@ class BasicNewsRecipe(Recipe): def get_browser(self, *args, **kwargs): ''' Return a browser instance used to fetch documents from the web. By default - it returns a `mechanize `_ + it returns a `mechanize `_ browser instance that supports cookies, ignores robots.txt, handles refreshes and has a mozilla firefox user agent. @@ -482,7 +482,7 @@ class BasicNewsRecipe(Recipe): def get_browser(self): br = BasicNewsRecipe.get_browser(self) if self.username is not None and self.password is not None: - br.open('http://www.nytimes.com/auth/login') + br.open('https://www.nytimes.com/auth/login') br.select_form(name='login') br['USERID'] = self.username br['PASSWORD'] = self.password @@ -535,7 +535,7 @@ class BasicNewsRecipe(Recipe): for key in article.keys(): if key.endswith('_origlink'): url = article[key] - if url and url.startswith('http://'): + if url and (url.startswith('http://') or url.startswith('https://')): return url ans = article.get('link', None) if not ans and getattr(article, 'links', None): @@ -554,7 +554,7 @@ class BasicNewsRecipe(Recipe): an ad page, return the HTML of the real page. Otherwise return None. - `soup`: A `BeautifulSoup `_ + `soup`: A `BeautifulSoup `_ instance containing the downloaded :term:`HTML`. ''' return None @@ -596,7 +596,7 @@ class BasicNewsRecipe(Recipe): It can be used to do arbitrarily powerful pre-processing on the :term:`HTML`. It should return `soup` after processing it. - `soup`: A `BeautifulSoup `_ + `soup`: A `BeautifulSoup `_ instance containing the downloaded :term:`HTML`. ''' return soup @@ -608,7 +608,7 @@ class BasicNewsRecipe(Recipe): It can be used to do arbitrarily powerful post-processing on the :term:`HTML`. It should return `soup` after processing it. - :param soup: A `BeautifulSoup `_ instance containing the downloaded :term:`HTML`. + :param soup: A `BeautifulSoup `_ instance containing the downloaded :term:`HTML`. :param first_fetch: True if this is the first page of an article. ''' @@ -643,7 +643,7 @@ class BasicNewsRecipe(Recipe): def index_to_soup(self, url_or_raw, raw=False, as_tree=False): ''' Convenience method that takes an URL to the index page and returns - a `BeautifulSoup `_ + a `BeautifulSoup `_ of it. `url_or_raw`: Either a URL or the downloaded index page as a string @@ -1627,14 +1627,14 @@ class BasicNewsRecipe(Recipe): def tag_to_string(self, tag, use_alt=True, normalize_whitespace=True): ''' Convenience method to take a - `BeautifulSoup `_ + `BeautifulSoup `_ `Tag` and extract the text from it recursively, including any CDATA sections and alt tag attributes. Return a possibly empty unicode string. `use_alt`: If `True` try to use the alt attribute for tags that don't have any textual content - `tag`: `BeautifulSoup `_ + `tag`: `BeautifulSoup `_ `Tag` ''' if tag is None: @@ -1755,7 +1755,7 @@ class CalibrePeriodical(BasicNewsRecipe): #: Set this to the slug for the calibre periodical calibre_periodicals_slug = None - LOG_IN = 'http://news.calibre-ebook.com/accounts/login' + LOG_IN = 'https://news.calibre-ebook.com/accounts/login' needs_subscription = True __author__ = 'calibre Periodicals' @@ -1777,7 +1777,7 @@ class CalibrePeriodical(BasicNewsRecipe): self.log('Fetching downloaded recipe') try: raw = self.browser.open_novisit( - 'http://news.calibre-ebook.com/subscribed_files/%s/0/temp.downloaded_recipe' + 'https://news.calibre-ebook.com/subscribed_files/%s/0/temp.downloaded_recipe' % self.calibre_periodicals_slug ).read() except Exception as e: