'.. only:: html' is used in

./stationary_densities.rst:.. only:: html
./index_dynamic_programming.rst:.. only:: html
./index_time_series_models_grad.rst:.. only:: html
./index_undergrad.rst:.. only:: html
./index_undergrad.rst:.. only:: html
./index_dynamic_programming_squared.rst:.. only:: html
./linear_algebra.rst:.. only:: html
./index_tools_and_techniques_grad.rst:.. only:: html
./index_tools_and_techniques.rst:.. only:: html
./arma.rst:.. only:: html
./pandas.rst:.. only:: html
./pandas.rst:.. only:: html
./pandas.rst:.. only:: html
./zreferences.rst:.. only:: html
./mle.rst:.. only:: html
./linear_models.rst:.. only:: html
./index_advanced_python_programming.rst:.. only:: html
./index_multi_agent_models.rst:.. only:: html
./index_tools_and_techniques_undergrad.rst:.. only:: html
./index_learning_python.rst:.. only:: html
./index_postgrad.rst:.. only:: html
./index_postgrad.rst:.. only:: html
./optgrowth.rst:.. only:: html
./index_multi_agent_models_undergrad.rst:.. only:: html
./index_time_series_models.rst:.. only:: html
./ifp.rst:.. only:: html
./ifp.rst:.. only:: html
./ifp.rst:.. only:: html
./ifp.rst:.. only:: html
./index_dynamic_programming_grad.rst:.. only:: html
./index.rst:.. only:: html
./index.rst:.. only:: html
./index_multi_agent_models_grad.rst:.. only:: html
./index_python_scientific_libraries.rst:.. only:: html
./lqramsey.rst:.. only:: html
./lqramsey.rst:.. only:: html
./lqramsey.rst:.. only:: html
./pandas_panel.rst:.. only:: html
./pandas_panel.rst:.. only:: html
./pandas_panel.rst:.. only:: html
./index_data_and_empirics.rst:.. only:: html
./aiyagari.rst:.. only:: html
./index_dynamic_programming_undergrad.rst:.. only:: html

I checked randomly and realised Jupinx is not able to support '.. only:: html' blocks

check lists which had problem ( Issue #4 )

• amss
• amss2
• amss3
• arellano
• calvo
• career
• chang_credible
• discrete_dp
• dyn_stack
• getting_started
• jv
• kalman
• linear_models
• lqcontrol
• lqramsey
• lu_tricks
• lucas_model
• markov_perf
• multiplicative_functionals
• opt_tax_recur
• optgrowth
• orth_proj
• pandas
• perm_income
• perm_income_cons
• python_advanced_features
• python_by_example
• python_essentials
• python_oop
• rational_expectations
• rob_markov_perf
• robustness
• scipy
• smoothing
• stationary_densities

It would be great to add the QuantEcon banner at the top of every download notebook. @DrDrij can you advise on this.

I am thinking of building a download set of notebooks that would include a header cell with

<link rel="stylesheet" href="_static/css/qe-menubar.css">

<div class="qe-menubar">
        
<p class="qe-menubar-logo"><a href="https://quantecon.org/" title="quantecon.org"><img src="_static/img/qe-menubar-logo.png" alt="QuantEcon logo"> Quant<span>Econ</span></a></p>
        
<ul class="qe-menubar-nav">
                <li><a href="https://lectures.quantecon.org/" title="Lectures"><span>Lectures</span></a></li>
                <li><a href="https://quantecon.org/python_index.html" title="QuantEcon.py"><span>QuantEcon.py</span></a></li>
                <li><a href="https://quantecon.org/julia_index.html" title="QuantEcon.jl"><span>QuantEcon.jl</span></a></li>
                <li><a href="http://notebooks.quantecon.org/" title="Notebooks"><span>Notebooks</span></a></li>
                <li><a href="http://cheatsheets.quantecon.org/" title="Cheatsheets"><span>Cheatsheets</span></a></li>
                <li><a href="http://blog.quantecon.org/" title="Blog"><span>Blog</span></a></li>
                <li><a href="http://discourse.quantecon.org/" title="Forum"><span>Forum</span></a></li>
                <li><a href="https://github.com/QuantEcon/" title="Repository"><span class="show-for-sr">Repository</span></a></li>
                <li><a href="https://twitter.com/quantecon" title="Twitter"><span class="show-for-sr">Twitter</span></a></li>
            </ul>
</div>

but it doesn't seem to work.

It looks like

perhaps I don't have all the assets in the right spot. Could you experiment and let me know what would be required?

python_essentials

• add language synonyms to allow individual highlighting of code-blocks and include as executable blocks in the output

@DrDrij is this a theme issue or do I need to dig into jupinx?

@DrDrij Are we able to alter the placement of In and Out text for the code-blocks to mimic more closely what we had on the website? It would be neat if we could have them in the margin and in our QuantEcon orange text :)

Need to see if :class: collapse will passthrough nbconvert for @DrDrij to latch on to in the theme.

Currently code-block:: none get's included in the markdown but it is not very clean once it is converted to html. It is fine in the ipynb stage. The example is taken from pandas.html

the html

<div class="{} cell border-box-sizing text_cell rendered"><div class="prompt input_prompt">
</div><div class="inner_cell">
<div class="text_cell_render border-box-sizing rendered_html">

<pre><code>"country","country isocode","year","POP","XRAT","tcgdp","cc","cg"
"Argentina","ARG","2000","37335.653","0.9995","295072.21869","75.716805379","5.5788042896"
"Australia","AUS","2000","19053.186","1.72483","541804.6521","67.759025993","6.7200975332"
"India","IND","2000","1006300.297","44.9416","1728144.3748","64.575551328","14.072205773"
"Israel","ISR","2000","6114.57","4.07733","129253.89423","64.436450847","10.266688415"
"Malawi","MWI","2000","11801.505","59.543808333","5026.2217836","74.707624181","11.658954494"
"South Africa","ZAF","2000","45064.098","6.93983","227242.36949","72.718710427","5.7265463933"
"United States","USA","2000","282171.957","1","9898700","72.347054303","6.0324539789"
"Uruguay","URY","2000","3219.793","12.099591667","25255.961693","78.978740282","5.108067988"</code></pre>

</div>
</div>
</div>

@DrDrij is there a way we could address this in the styling?

'.. code-block:: none' is used in these files:

./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/python_advanced_features.rst:.. code-block:: none
./rst_files/schelling.rst:.. code-block:: none
./rst_files/schelling.rst:.. code-block:: none
./rst_files/python_essentials.rst:.. code-block:: none
./rst_files/python_essentials.rst:.. code-block:: none
./rst_files/python_essentials.rst:.. code-block:: none
./rst_files/pandas.rst:.. code-block:: none
./rst_files/pandas.rst:.. code-block:: none
./rst_files/debugging.rst:.. code-block:: none
./rst_files/debugging.rst:.. code-block:: none
./rst_files/debugging.rst:.. code-block:: none
./rst_files/finite_markov.rst:.. code-block:: none
./rst_files/python_by_example.rst:.. code-block:: none
./rst_files/oop_intro.rst:.. code-block:: none

I checked them randomly and realised it's incomplete in Jupinx, For example: finite_markov:

.. code-block:: none

    d -> h;

(finite_markov)

also the address is:
The data for this graph is in the ``web_graph_data.txt`` file --- you can also view it here https://github.com/QuantEcon/QuantEcon.lectures.code/blob/master/finite_markov/web_graph_data.txt__

which I checked and realised the text file is in this adresse as well:

https://github.com/QuantEcon/lecture-source-py/tree/master/rst_files/_static/code/finite_markov/web_graph_data.txt

shall we change it in finite_markov.rst?

- [ ] QuantEcon/sphinxcontrib-jupyter#107
- [x] fixed by QuantEcon/sphinxcontrib-jupyter#110
passthrough to the notebook as an executable cell is fixed but nbconvert is not running the cells properly that contain cell magics
ipython/ipython#3707

Here is a list of sphinx warnings that should be resolved.

It looks like support for nested lists is incomplete in sphinxcontrib-jupyter

this example is from py/getting_started.rst

We need a way to label cells that produce errors, without having the errors count towards coverage (https://lectures.quantecon.org/status.html). Possible we could introduce a skip-test label.

(chang_credible)

A government strategy :math:`\sigma` and an allocation rule
:math:`\alpha` are said to constitute a *sustainable plan* (SP) if

i.   :math:`\sigma` is admissible

ii.  Given :math:`\sigma`, :math:`\alpha` is competitive

iii. After any history :math:`\vec h^{t-1}`, the continuation of :math:`\sigma` 
     is optimal for the government; i.e., the sequence :math:`\vec h_t` induced 
     by :math:`\sigma` after :math:`\vec h^{t-1}` maximizes over :math:`CE_\pi` 
     given :math:`\alpha`

i.   A period :math:`0` action :math:`\hat h \in \Pi` that the public
     expects the government to take, together with subsequent within-period
     consequences :math:`m(\hat h), x(\hat h)` when the government acts as
     expected

ii.  For any first period action :math:`h \neq \hat h` with
     :math:`h \in CE_\pi^0`, a pair of within-period consequences
     :math:`m(h), x(h)` when the government does not act as the public had
     expected

iii. For every :math:`h \in \Pi`, a pair
     :math:`(w'(h), \theta'(h))\in S` to carry into next period

**Proposition:**

i.  If :math:`Z \subset \tilde D(Z)`, then :math:`\tilde D(Z) \subset S` (‘self-generation’)

ii. :math:`S = \tilde D(S)` (‘factorization’)


**Proposition:**

i.  Monotonicity of :math:`\tilde D`: :math:`Z \subset Z'` implies :math:`\tilde D(Z) \subset \tilde D(Z')`

ii. :math:`Z` compact implies that :math:`\tilde D(Z)` is compact

in this picture you can see ** bold ** is working everywhere expect ** par value **

amss2.html

Figures with the scale of 100% is too big and it seems a little bit unusual, shall we change the size?

(for example: career)

We will need to focus on PDF support.

It would be nice if PDF could be supported for individual lectures (in addition to the whole site).

• use current RST to PDF route and hope recent changes haven't broken the LaTeX compilation

• write a custom LaTeXWriter for sphinx to build individual lectures - and a global pdf file.

I think Jupinx is not able to support comment with .. .

As you can see in classical_filtering

and in arellano

I think the text after .. is a comment and I just delete them in #18 and #22.

It seems for ".. only:: latex" blocks, Jupinx has some problem and it wouldn't able to generate them correctly

.

For switching to code mode we are using double ' ( ' ' ) which Jupinx can't support them like :

R needs to be a matrix where R[s, a] is the reward at state s under action a

multiplicative_functionals:


.. literalinclude:: /_static/code/multiplicative_functionals/amflss_scalar.py
but I've already replaced literal-include with the actual code in a code-block::python3 in this PR: #3 I think It should be fixed, so I add a check-fix label to this Issue.

.. code-block:: bash is only used in one file:
./rst_files/getting_started.rst: .. code-block:: bash

code:

.. note:: 
    
    The `QuantEcon.py <http://quantecon.org/python_index.html>`__ package can also be installed using conda by:

    .. code-block:: bash

        conda config --add channels conda-forge 
        conda install quantecon

With a setting of 1200s timeout the following lectures have code execution problems

2018-11-19 12:02:48,809[ERROR]execute_nb.py(524): amss
2018-11-19 12:02:48,809[ERROR]execute_nb.py(524): chang_credible
2018-11-19 12:02:48,809[ERROR]execute_nb.py(524): chang_ramsey

(amss.html)
It seems most of the lectures have this problem.

amss3.html

• the execution testing badges aren't being rendered
• jupyter download box is not being rendered
• the How to read this lecture collapse cell is missing

• sphinxcontrib-jupyter includes Contents title and duplicate title of the lecture (see issue #45)

• breadcrumbs are not working correctly in notebook compilation path

In (finite_markov), the code is fine and there is no problem with tags, but I don't know why there is an extra word (None) in Generated version!

The code is:

There are :math:`n` such equations, one for each :math:`y \in S`

If we think of :math:`\psi_{t+1}` and :math:`\psi_t` as *row vectors* (as is traditional in this literature), these :math:`n` equations are summarized by the matrix expression

(PR #40) Fixed

Is it possible to toggle the length of output blocks to be scrollable in html output. Similar to left margin click in the notebook?

python_advanced_features is a good test case

math.__dict__.items()

to remove .items()

• Need to add download notebooks in the pre-executed form to _static/_downloads/ipynb/py etc.

• This will need to be made more independent from global _static to local _static for each language.

A post-processing issue:

We will need to parse all ipynb notebook links as html links.

@DrDrij is there a way to do this in the template?

amss.html

In the short term I will add copying of dependent files to the build scripts but in the future this needs to be handled better using jupinx (see QuantEcon/sphinxcontrib-jupyter#107)

The files that need to be manually copied are:

• us_cities.txt in python_advanced_features

Given this file is generated by another lecture we will need to think about execution ordering. This is another avenue to execute lectures in order of index and then figure out where nbconvert puts generated files as they don't seem to be in the local working folder where the notebooks are executed from.

amss3.html

A list of lectures on dynamic programming and closely related topics we would like to jit in a similar way

• Job Search I: The McCall Search Model (previously jitted in a simple style, probably OK as is)
• Job Search II: Search and Separation (previously jitted but needs to be put in same style as others)
• A Problem that Stumped Milton Friedman
• Job Search III: Search with Learning
• Job Search IV: Modeling Career Choice
• Job Search V: On-the-Job Search
• Optimal Growth I: The Stochastic Optimal Growth Model
• Optimal Growth II: Time Iteration
• Optimal Growth III: The Endogenous Grid Method
• LQ Dynamic Programming Problems
• Optimal Savings I: The Permanent Income Model
• Optimal Savings II: LQ Techniques
• Consumption and Tax Smoothing with Complete and Incomplete Markets
• Optimal Savings III: Occasionally Binding Constraints
• Robustness
• Asset Pricing II: The Lucas Asset Pricing Model

Somewhat different structure but we still want to jit

• The Aiyagari Model (substantial changes required --- use code from occasionally binding constraints lect)
• Continuous State Markov Chains
• Default Risk and Income Fluctuations (jitted but needs to be put in the same style as others)

Update lecture to specify using pip only as conda-forge is confusing users

Check the following lectures with @natashawatkins

• #99 (python_advanced_features)
• #100 (python_by_example)
• #111 (oop_intro)
• debugging

When viewing the status page (https://lectures.quantecon.org/status.html) on mobile, status buttons aren't visible

It would be nice for the extension to build the whole site (including all the index pages) via IPYNB.

The index pages should just be a simple notebook with a single markdown cell.

It seems footnotes are failed in Jupinx.
For example dyn_stack:

code:
Define the government's one-period loss function [#f1]_

.. rubric:: Footnotes

.. [#f1] The problem assumes that there are no cross products between states and controls in the return function.  A simple transformation  converts a problem whose return function has cross products into an equivalent problem that has no cross products. For example, see :cite:`HansenSargent2008` (chapter 4, pp. 72-73).

.. [#f2] The government would make different choices were it to choose sequentially, that is,  were it to select its time :math:`t` action at time :math:`t`. See the lecture on :doc:`history dependent policies <hist_dep_policies>`

.. [#f8] :cite:`HansenSargent2008` (chapter 16), uses this model as a laboratory to illustrate an equilibrium concept featuring robustness in which at least one of the agents has doubts about the stochastic specification of the demand shock process.

.. [#f9] They used this method to compute a rational expectations competitive equilibrium.  Their key step was to eliminate price and output by substituting from the inverse demand curve and the production function into the firm's first-order conditions to get a difference equation in capital.

.. [#f10] These calculations were performed by functions located in `dyn_stack/oligopoly.py <https://github.com/QuantEcon/QuantEcon.lectures.code/blob/master/dyn_stack/oligopoly.py>`_.

.. [#f12] For another application of the techniques in this lecture and how they related to the method recommended by :cite:`KydlandPrescott1980`, please see :doc:`this lecture <hist_dep_policies>` .

in (linear_algebra) some references to figures are failed.

To see why, recall the :ref:figure above <la_3dvec>, where :math:k=2 and :math:n=3

To illustrate the idea, recall :ref:the figure <la_3dvec> that showed the span of vectors :math:\{a_1, a_2\} in :math:\mathbb R ^3 as a plane through the origin

.. note:: has conflict with other tags in Jupinx.
(linear_algebra):


(perm_income):

amss:

linear_model:

robustness:

This needs to be done in the quantecon.build.lectures repo:

• integrate _static files to _build_website target directories
• provide execution json report to _static folder
• integrate Julia compilation chain
• assemble complete site and update make preview
• add all necessary theme elements and static objects to support the theme to themes/qe/
• add #85 logic for code checker

Future

• add cache to compilation chain for notebooks
• add execution and error reporting to Jupinx
• add containerised execution control

This needs to be done in ``QuantEcon.admin` repo:

• add interface with s3 bucket for uploading updates (current solution relies on aws cli)

.. epigraph:: is used only in these lectures:

./rst_files/numpy.rst:.. epigraph::
./rst_files/rational_expectations.rst:.. epigraph::
./rst_files/markov_asset.rst:.. epigraph::
./rst_files/markov_asset.rst:.. epigraph::
./rst_files/mccall_model.rst:.. epigraph::
./rst_files/debugging.rst:.. epigraph::
./rst_files/linear_models.rst:.. epigraph::

which seems Jupinx is not able to support this markdown very well.
debugging:

numpy:

rational_expectations:

markov_asset:

mccall_model:

linear_models:

quantecon.build.lectures

Add %matplotlib inline to lectures so that downloaded notebooks have them included.

• remove from preamble in the quantecon.build.lectures repo.