:orphan:

|rss_image|  **2017-08 - 1/1** :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

----


.. index:: 2017-08


.. _ap-month-2017-08-0:

2017-08 - 1/1
+++++++++++++

.. blogpostagg::
    :title: Issues with sphinx-gallery
    :date: 2017-08-25
    :keywords: documentation,sphinx,sphinx-gallery
    :categories: documentation
    :rawfile: 2017/2017-08-25_sphinxgallery.rst

    Taking another dependency always means a potential
    conflicts between version. Is it fact enough updated
    when it breaks? I realized I was not the only to face an
    issue with `sphinx-gallery <https://github.com/sphinx-gallery/sphinx-gallery>`_.
    There is a discussion about it on
    `scikit-learn/9189 <https://github.com/scikit-learn/scikit-learn/issues/9189>`_
    and the package is now included in the
    `sources <https://scikit-learn.org/stable/auto_examples/index.html>`_.
    It is not really bothering for a small package like this.
    But still, it is extra work.
    I realize open source holds on some kind of magic
    sometimes. Some are fun but keeping them alive
    takes some energy.




.. blogpostagg::
    :title: Pandoc on ubuntu and WSL
    :date: 2017-08-20
    :keywords: documentation,sphinx,pandoc
    :categories: documentation
    :rawfile: 2017/2017-08-20_pandoc.rst

    I was using the `Windows Subsystem for Linux <https://msdn.microsoft.com/en-us/commandline/wsl/about>`_
    to test a module with Linux. I could not make it work
    due to an old version of :epkg:`pandoc`.
    Surprisingly, the default ``apt-get install pandoc`` installed
    a very old version (1.12). I could not convert any notebook
    with `nbconvert <https://github.com/jupyter/nbconvert>`_ into latex.
    I finally installed the latest version (1.19) and it worked perfectly.
    You can see the installation step in file
    `.circleci/config.yml <https://github.com/sdpython/pyquickhelper/blob/master/.circleci/config.yml>`_.
    That was not the last issue because
    *pandoc* seems to be very slow on WSL.
    About that, you can read:
    `massive delay to call pandoc using the Windows Subsystem for Linux (WSL) or Bash for Windows <https://github.com/jgm/pandoc/issues/3448>`_,
    `stack ghc painfully slow <https://github.com/Microsoft/BashOnWindows/issues/1671>`_.




.. blogpostagg::
    :title: Build on CircleCI
    :date: 2017-08-20
    :keywords: CircleCI
    :categories: continuous integration
    :rawfile: 2017/2017-08-20_circleci.rst

    *pyquickhelper* now builds on
    `CircleCI <https://circleci.com/gh/sdpython/pyquickhelper>`_.
    The list of unit tests enabled on that platform is bigger than on
    *travis* or *appveyor*. It also builds the wheel and the documentation.
    It pushed them into the artifacts section where they can be downloaded.
    You can see the installation step in file
    `.circleci/config.yml <https://github.com/sdpython/pyquickhelper/blob/master/.circleci/config.yml>`_.





----

|rss_image|  **2017-08 - 1/1** :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>`