search

RunestoneInteractive / rs

A New Monorepo structure for Runestone
Other
40 stars 68 forks source link

build error on new textbook #87

Open cpainterwakefield opened 4 years ago

cpainterwakefield commented 4 years ago

Received the following error in a brand new textbook build:

<path to my book>/_sources/index.rst:89: WARNING: Error in "code" directive:
maximum 1 argument(s) allowed, 5 supplied.

.. code::
    html_static_path =  runestone_static_dirs() + ['_static']

Building on linux mint 20 with python 3.8.2.

It looks like this is relatively unimportant - it is in section 4 - Theme - and seems to be related to an attempt to put in a URL to a static web page in the sources, but I thought I should report it.

bnmnetp commented 4 years ago

You are just missing a blank line after your .. code:: directive. The line(s) immediately following the directive are for options to that directive. Followed by a blank line and then the body of the directive.

restructuredText is pythonic in the sense that white space is important, both for indentation purposes and cases like this where a blank line is significant.