:orphan:

|rss_image| :ref:`<== <ap-main-2>`  **blog page - 4/6** :ref:`==> <ap-main-4>` :ref:`Blog <ap-main-0>` :ref:`notebook (8) <ap-cat-notebook-0>` :ref:`sphinx (13) <ap-cat-sphinx-0>`

.. |rss_image| image:: feed-icon-16x16.png
    :target: ../_downloads/rss.xml
    :alt: RSS

----


.. _ap-main-3:

blog page - 4/6
+++++++++++++++

.. blogpostagg::
    :title: Issue with package_data (setup.py)
    :date: 2016-09-07
    :keywords: setup.py,package_data
    :categories: setup
    :rawfile: 2016/2016-09-07_setup.rst

    File ``setup.py`` usually defines something like:
    

    ...




.. blogpostagg::
    :title: Major changes
    :date: 2016-09-03
    :keywords: Jenkins,documentation
    :categories: automation
    :rawfile: 2016/2016-09-03_major_changes.rst

    I now use YAML to define a build script.
    See `.local.jenkins.win.yml <https://github.com/sdpython/pyquickhelper/blob/master/.local.jenkins.win.yml>`_.
    I did not expect that to be so long but it did not scale anymore.
    So the process is basically to run a script which interprets the
    file `.local.jenkins.win.yml <https://github.com/sdpython/pyquickhelper/blob/master/.local.jenkins.win.yml>`_
    as a series of `Jenkins <https://jenkins.io/>`_ jobs.
    Unfortunately, I discovered many issues for some modules
    refusing to work from a virtual environment on Windows.
    It starts by running function
    :func:`setup_jenkins_server_yml <pyquickhelper.jenkinshelper.jenkins_helper.setup_jenkins_server_yml>`.
    The rest is pressing buttons.




.. blogpostagg::
    :title: Generate the documentation on Anaconda
    :date: 2016-08-27
    :keywords: documentation,Anaconda
    :categories: documentation
    :rawfile: 2016/2016-08-27_conda_and_documentation.rst

    On Anaconda, the documentation generation fails for
    two reasons. The first one is the current version of *Sphinx* *(1.4.1)*
    and *pyquickhelper* requires *>= 1.4.5*. After fixing it
    with *pip*, the following exception happens (only on Anaconda)
    on a virtual environment:
    

    ...




.. blogpostagg::
    :title: Make a reference to a blog post
    :date: 2016-06-11
    :keywords: reference
    :categories: documentation,example
    :rawfile: 2016/2016-06-11_blogpost_with_label.rst

    Make a reference to the label ``label-to-this-blogpost``
    to reference this blog post. Look at the source of this page
    to see how this id was specified.




.. blogpostagg::
    :title: Sphinx extensions in pyquickhelper
    :date: 2016-04-04
    :keywords: sharenet,custom role,role,custom directive,directive,bigger,runpython,blog post
    :categories: sphinx
    :rawfile: 2016/2016-04-04_sphinx_extension.rst

    Sphinx extensions implemented were move to a dedicated subfolder *sphinxext*:
    

    ...




.. blogpostagg::
    :title: Share buttons on a page from the documenation.
    :date: 2016-02-14
    :keywords: sharenet,custom role,role,custom directive,directive
    :categories: sphinx
    :rawfile: 2016/2016-02-14_sharenet.rst

    pyquickhelper now includes a directive and a role to share
    a page from the documentation on networks.
    See :class:`ShareNetDirective <pyquickhelper.sphinxext.sphinx_sharenet_extension.ShareNetDirective>`
    and :func:`sharenet_role <pyquickhelper.sphinxext.sphinx_sharenet_extension.sharenet_role>`.
    The syntax is the following::
    

    ...




.. blogpostagg::
    :title: Bigger text in the documentation
    :date: 2016-02-14
    :keywords: bigger,custom role,role
    :categories: sphinx
    :rawfile: 2016/2016-02-14_bigger.rst

    pyquickhelper now includes a role *bigger* which
    make a text :bigger:`bigger` ::
    

    ...




.. blogpostagg::
    :title: read_csv and zip files
    :date: 2016-02-06
    :keywords: pandas,read_csv,zip
    :categories: pandas
    :rawfile: 2016/2016-02-06_read_csv.rst

    `read_csv <http://pandas.pydata.org/pandas-docs/stable/generated/pandas.read_csv.html>`_
    is no longer able to extract a dataframe from a zip file.
    The parameter *format* changed for *compression* but
    the zip format disappeared from the list. I assume
    the reason is that zip files can contains many files.
    

    ...




.. blogpostagg::
    :title: Badge for coverage
    :date: 2016-01-01
    :keywords: codecov,coveralls
    :categories: coverage
    :rawfile: 2016/2016-01-01_codecov.rst

    *pyquickhelper* is using :epkg:`coverage`
    to measure the coverage of the unit tests.
    `coveralls <https://coveralls.io/>`_ cannot ingest these reports
    when :epkg:`codecov` does with a simple command line such as::
    

    ...




.. blogpostagg::
    :title: Sphinx extensions
    :date: 2015-12-12
    :keywords: sphinx,extensions
    :categories: sphinx
    :rawfile: 2015/2015-12-12_sphinx_extensions.rst

    The following repository
    `birkenfeld/sphinx-contrib/ <https://github.com/sphinx-contrib/legacy>`_
    contains many useful extensions
    to improve the rendering of
    `Sphinx <http://sphinx-doc.org/>`_ documentation:
    

    ...





----

|rss_image| :ref:`<== <ap-main-2>`  **blog page - 4/6** :ref:`==> <ap-main-4>` :ref:`2020-08 (2) <ap-month-2020-08-0>` :ref:`2020-09 (1) <ap-month-2020-09-0>` :ref:`2021-01 (1) <ap-month-2021-01-0>` :ref:`2022-03 (1) <ap-month-2022-03-0>` :ref:`2023-05 (1) <ap-month-2023-05-0>`