Расширение Bokeh Sphinx - как включить данные из файла CSV?

Question

Я создаю некоторую документацию, используя Sphinx, и я хочу использовать bokeh.sphinxext для включения графиков Bokeh в документацию.Это кажется легким делом, учитывая этот пример .Однако данные, которые я хочу использовать для создания графика, хранятся в файле CSV.Я попытался поместить свой CSV-файл в тот же каталог и использовать .. include:: data.csv в том же документе RST, но это не сработало.

Как можно ссылаться на внешний файл при создании графиков Bokeh с использованием Sphinx?

.. include:: data.csv

.. bokeh-plot::

    import pandas as pd
    from bokeh.plotting import figure, output_file, show

    output_file("example.html")

    df = pd.read_csv('data.csv')

    p = figure(title="example", plot_width=300, plot_height=300)
    p.line(df['x'], df['y'], line_width=2)

    show(p)

Answer 1

Только из-за того, как работает расширение, текущий рабочий каталог при выполнении кода (т. Е. То, что возвращает функция os.getcwd()) является верхним уровнем вашего проекта Sphinx.На этом основании вам нужно будет создать путь к файлу данных.Например, если ваш файл находится в каталоге source / docs вашего проекта Sphinx, это может быть:

df = pd.read_csv(os.join('source', 'docs', 'data.csv')