docs update, fix 404 errors [ci skip]

Author: monim67

images/date-picker.png renamed to .github/assets/readme_images/date-picker.png

@@ -42,6 +42,38 @@ You forgot to add bootstrap JavaScript file to your template, make sure you have
 and CSS files to your included in your template. Checkout our `configuration instructions <configuration_page_>`_
 to see various options to do it.
 
+
+Fix 404 (Not Found) errors
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. error:: GET ``http://.../datepicker-widget.js`` net::ERR_ABORTED 404 (Not Found)
+
+.. error:: GET ``http://.../datepicker-widget.css`` net::ERR_ABORTED 404 (Not Found)
+
+In some production environment you need to collect static JS/CSS resources from all packages to a single
+location specified as STATIC_ROOT in ``settings.py`` file. Check your hosting provider manual to see how
+to do it correctly.
+
+Otherwise if your hosting interface provides access to console, log in to your server console and run the
+following command and then reload the server from your hosting interface.
+
+::
+
+    python3 manage.py collectstatic
+
+.. error:: You're using the staticfiles app without having set the STATIC_ROOT setting to a filesystem path
+
+If you encounter above error then you don't have ``STATIC_ROOT`` directory set. Check your hosting provider
+instruction manual to identify the directory it serves static files from, generally it's the ``static``
+directory in your prject root. If so add the following line at the bottom of your ``settings.py`` file.
+
+.. code-block:: python
+
+    STATIC_ROOT = os.path.join(BASE_DIR, "static")
+
+Now you can execute ``collectstatic`` command and reload the server from your hosting interface.
+
+
 No errors anywhere, but the calendar does not show up!
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 You forgot to add ``{{ form.media }}`` to your template. Checkout our `configuration instructions <configuration_page_>`_

images/datetime-picker.png renamed to .github/assets/readme_images/datetime-picker.png

@@ -5,7 +5,8 @@ Usage
 Usage in Generic View
 ^^^^^^^^^^^^^^^^^^^^^^
 
-.. code:: python
+.. code-block:: python
+   :emphasize-lines: 2,11
 
     # File: views.py
     from bootstrap_datepicker_plus import DateTimePickerInput
@@ -24,7 +25,8 @@ Usage in Generic View
 Custom Form usage
 ^^^^^^^^^^^^^^^^^
 
-.. code:: python
+.. code-block:: python
+   :emphasize-lines: 2,11
 
     # File: forms.py
     from bootstrap_datepicker_plus import DatePickerInput
@@ -43,7 +45,8 @@ Custom Form usage
 Model Form usage
 ^^^^^^^^^^^^^^^^
 
-.. code:: python
+.. code-block:: python
+   :emphasize-lines: 2,11-12
 
     # File: forms.py
     from bootstrap_datepicker_plus import DatePickerInput
@@ -65,7 +68,8 @@ Types of DatePickers
 
 The widget contains all types of date-picker you may ever need.
 
-.. code:: python
+.. code-block:: python
+   :emphasize-lines: 2,11-15
 
     # File: forms.py
     from bootstrap_datepicker_plus import DatePickerInput, TimePickerInput, DateTimePickerInput, MonthPickerInput, YearPickerInput
@@ -90,7 +94,8 @@ Implement date-range-picker
 
 DatePickers can be linked to select a date-range or time-range.
 
-.. code:: python
+.. code-block:: python
+   :emphasize-lines: 2,11-12
 
     # File: forms.py
     from bootstrap_datepicker_plus import DatePickerInput, TimePickerInput
@@ -116,7 +121,8 @@ The DatePicker can be customized by passing options to it.
 The ``options`` will be passed to the JavaScript datepicker instance, and are documented and demonstrated in 
 `Bootstrap Datepicker Options Reference <http://eonasdan.github.io/bootstrap-datetimepicker/Options/>`__.
 
-.. code:: python
+.. code-block:: python
+   :emphasize-lines: 14-17
 
     # File: forms.py
     from bootstrap_datepicker_plus import DatePickerInput
@@ -153,7 +159,8 @@ Customize the Language
 The DatePicker language can be customized by passing a ``locale`` option to datepicker input.
 See `moment.js locales <https://github.com/moment/moment/tree/develop/locale>`__ for valid locales.
 
-.. code:: python
+.. code-block:: python
+   :emphasize-lines: 14
 
     # File: forms.py
     from bootstrap_datepicker_plus import DatePickerInput

images/time-picker.png renamed to .github/assets/readme_images/time-picker.png

@@ -25,9 +25,10 @@ Install following packages:
 
 Add these packages to the list of INSTALLED_APPS as you did here on `Tutorial 02 <django_tutorial_activating_model_>`_.
 
-.. code:: python
+.. code-block:: python
+   :emphasize-lines: 10,11
 
-    # FIle: mysite/settings.py
+    # file: mysite/settings.py
     INSTALLED_APPS = [
         'polls.apps.PollsConfig',
         'django.contrib.admin',
@@ -46,9 +47,10 @@ CreateView for Question model
 
 Add a CreateView for Question model. The ``get_form`` method is used to specify widgets on the form fields.
 
-.. code:: python
+.. code-block:: python
+   :emphasize-lines: 7,12-18
 
-    # FIle: polls/views.py
+    # file: polls/views.py
     from django.http import HttpResponseRedirect
     from django.shortcuts import get_object_or_404, render
     from django.urls import reverse
@@ -73,9 +75,9 @@ Add a CreateView for Question model. The ``get_form`` method is used to specify
 Create a template named question_form.html in your app to render the form. If you use a different name you have to
 set template_name property of CreateView class in your views.py file above.
 
-.. code:: html
+.. code-block:: html
 
-    <!-- File: polls/templates/polls/question_form.html -->
+    <!-- file: polls/templates/polls/question_form.html -->
     {% load bootstrap4 %}
     {% bootstrap_css %}
     {% bootstrap_javascript jquery='full' %}
@@ -88,9 +90,10 @@ set template_name property of CreateView class in your views.py file above.
 
 Add a ``get_absolute_url`` method to your Question model.
 
-.. code:: python
+.. code-block:: python
+   :emphasize-lines: 19-20
 
-    # FIle: polls/models.py
+    # file: polls/models.py
     import datetime
 
     from django.db import models
@@ -114,9 +117,10 @@ Add a ``get_absolute_url`` method to your Question model.
 
 Add an urlpattern for creating new poll question.
 
-.. code:: python
+.. code-block:: python
+   :emphasize-lines: 9
 
-    # FIle: polls/urls.py
+    # file: polls/urls.py
     from django.urls import path
 
     from . import views
@@ -134,8 +138,10 @@ Add an urlpattern for creating new poll question.
 Now run the developement server and visit http://localhost:8000/polls/create, if everything works fine
 you can wrap up your template in proper HTML.
 
-.. code:: html
+.. code-block:: html
+   :emphasize-lines: 8-11,17
 
+    <!-- file: polls/templates/polls/question_form.html -->
     <!DOCTYPE html>
     <html lang="en">
     <head>
@@ -168,9 +174,9 @@ UpdateView for Question model
 
 We can now add a page to update a poll question. First we add an UpdateView to our views.
 
-.. code:: python
+.. code-block:: python
 
-    # FIle: add these to polls/views.py
+    # file: add these to polls/views.py
     class UpdateView(generic.edit.UpdateView):
         model = Question
         fields = ['question_text', 'pub_date']
@@ -181,9 +187,10 @@ We can now add a page to update a poll question. First we add an UpdateView to o
 
 Then add a urlpattern to access the question update page.
 
-.. code:: python
+.. code-block:: python
+   :emphasize-lines: 11
 
-    # FIle: polls/urls.py
+    # file: polls/urls.py
     from django.urls import path
 
     from . import views

docs/Troubleshooting.rst

@@ -13,10 +13,10 @@
     "test": "python runtests.py",
     "coverage": "coverage run --source=bootstrap_datepicker_plus runtests.py && coverage report",
     "travis-test": "coverage run --source=bootstrap_datepicker_plus runtests.py",
-    "build": "python setup.py sdist bdist_wheel",
     "docs": "start docs/_build/index.html",
-    "build-docs": "sphinx-build docs docs\\_build",
-    "pydoc.io": "sphinx-build docs\\pydoc.io docs\\_build",
+    "build": "python setup.py sdist bdist_wheel",
+    "build:docs": "sphinx-build docs docs\\_build",
+    "build:pydoc": "sphinx-build docs\\pydoc.io docs\\_build",
     "upload": "twine upload dist/*",
     "test-upload": "twine upload --repository testpypi dist/*"
   },