Fix documentation generation

dadoonet · Oct 17, 2023 · dbd8f50 · dbd8f50
1 parent 13599ba
commit dbd8f50
Show file tree

Hide file tree

Showing 8 changed files with 11 additions and 21 deletions.
diff --git a/docs/source/admin/fs/elasticsearch.rst b/docs/source/admin/fs/elasticsearch.rst
@@ -510,7 +510,7 @@ Path prefix
 ^^^^^^^^^^^
 
 .. versionadded:: 2.7 If your elasticsearch is running behind a proxy with url rewriting,
-you might have to specify a path prefix. This can be done with ``path_prefix`` setting:
+    you might have to specify a path prefix. This can be done with ``path_prefix`` setting:
 
 .. code:: yaml
 

diff --git a/docs/source/admin/fs/local-fs.rst b/docs/source/admin/fs/local-fs.rst
@@ -237,7 +237,7 @@ to the index, set option `Add as Inner Object`_
 which stores additional metadata and the XML contents under field
 ``object``.
 
-.. code:: json
+.. code:: yaml
 
    name: "test"
    fs:

diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -43,7 +43,7 @@
 
 # development versions always have the suffix '-SNAPSHOT'
 def read_version(full_version=True):
-    raw_version = config.get('FsCrawler', 'Version');
+    raw_version = config.get('FsCrawler', 'Version')
     return raw_version if full_version else raw_version.replace("-SNAPSHOT", "")
 
 version = read_version(full_version=False)
@@ -89,7 +89,7 @@ def read_version(full_version=True):
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+#language = None
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -207,16 +207,6 @@ def read_version(full_version=True):
 epub_exclude_files = ['search.html']
 
 
-# -- Extension configuration -------------------------------------------------
-
-from recommonmark.parser import CommonMarkParser
-
-source_parsers = {
-    '.md': CommonMarkParser,
-}
-
-source_suffix = ['.rst', '.md']
-
 # -- Options for todo extension ----------------------------------------------
 
 # If true, `todo` and `todoList` produce output, else they produce nothing.

diff --git a/docs/source/dev/doc.rst b/docs/source/dev/doc.rst
@@ -8,7 +8,7 @@ to have Python3 installed.
 
 Assuming you have `Python3 <https://www.python.org/>`_ already, install `Sphinx <http://www.sphinx-doc.org/>`_::
 
-    $ pip install sphinx sphinx-autobuild sphinx_rtd_theme recommonmark
+    $ pip install -r docs/requirements.txt
 
 Go to the ``docs`` directory and build the html documentation::
 

diff --git a/docs/source/user/getting_started.rst b/docs/source/user/getting_started.rst
@@ -68,7 +68,7 @@ something! ;-)
 
 .. code:: json
 
-   GET docs/doc/_search
+   // GET docs/doc/_search
    {
      "query" : {
        "query_string": {

diff --git a/docs/source/user/ocr.rst b/docs/source/user/ocr.rst
@@ -159,4 +159,4 @@ Supported strategies are:
 * ``ocr_and_text``: OCR and text extraction is performed.
 
 .. note:: When omitted, ``ocr_and_text`` value is used. If you have performance issues, it's worth using the ``auto`` option
-instead as only documents with barely no text will go through the OCR process.
+    instead as only documents with barely no text will go through the OCR process.
diff --git a/docs/source/user/tips.rst b/docs/source/user/tips.rst
@@ -53,7 +53,7 @@ Using docker with FSCrawler REST
 
 To use the REST service available from 2.2 you can add the ``--rest`` flag to the FSCrawler docker container ``command:``. Note that you must expose the same ports that the REST service opens on in the docker container. For example, if your REST service starts on ``127.0.0.1:8080`` then expose the same ports in your FSCrawler docker-compose image:
 
-.. code:: yml
+.. code:: yaml
 
     fscrawler:
       context: ${PWD}
@@ -67,7 +67,7 @@ To use the REST service available from 2.2 you can add the ``--rest`` flag to th
 
 Then expose the docker container you've created by changing the IP of the REST URL in your ``settings.yaml`` to the docker-compose container name:
 
-.. code:: yml
+.. code:: yaml
 
     rest :
       url: "http://fscrawler:8080"

diff --git a/docs/source/user/tutorial.rst b/docs/source/user/tutorial.rst
@@ -16,7 +16,7 @@ Install Elastic stack
 ^^^^^^^^^^^^^^^^^^^^^
 
 * Download `Elasticsearch <https://www.elastic.co/downloads/elasticsearch>`_
-* Download `Kibana <https://www.elastic.co/downloads/kibana>`_
+* Download `Kibana <https://www.elastic.co/downloads/kibana>`__
 * Start Elasticsearch server
 * Start Kibana server
 * Check that Kibana is running by opening http://localhost:5601
@@ -86,7 +86,7 @@ FSCrawler should index all the documents inside your directory.
 Create Index pattern
 ^^^^^^^^^^^^^^^^^^^^
 
-* Open `Kibana <http://localhost:5601>`_
+* Open `Kibana <http://localhost:5601>`__
 * Go to the `Management <http://0.0.0.0:5601/app/kibana#/management/>`_ page
 * Open the `Index Patterns <http://0.0.0.0:5601/app/kibana#/management/kibana/index_patterns?_g=()>`_ page
   under Kibana settings.