FAQ - Technical

If you have a question that you couldn't find an answer to easily, don't hesitate to open an issue on GitHub, it will help me make this section more complete!

Styling

Can you style footnote text?

Reference: issue 243, more on this: styling.

For reference basically, a footnote is inserted as

<sup id="fnref:1"><a href="/menu1/#fndef:1" class="fnref">[1]</a></sup>

So you can style that with the class .franklin-content sup a.fnref.

For definitions, it's inserted as a table like:

<table class="fndef" id="fndef:blah">
    <tr>
        <td class="fndef-backref"><a href="/menu1/#fnref:blah">[2]</a></td>
        <td class="fndef-content">this is another footnote</td>
    </tr>
</table>

so you can style the back-reference via the .franklin-content fndef td.fndef-backref and the text of the definition via .franklin-content fndef td.fndef-content; for instance, consider the following base styling:

.franklin-content table.fndef  {
    margin: 0;
    margin-bottom: 10px;}
.franklin-content .fndef tr, td {
    padding: 0;
    border: 0;
    text-align: left;}
.franklin-content .fndef tr {
    border-left: 2px solid lightgray;
    }
.franklin-content .fndef td.fndef-backref {
    vertical-align: top;
    font-size: 70%;
    padding-left: 5px;}
.franklin-content .fndef td.fndef-content {
    font-size: 80%;
    padding-left: 10px;}

How to disable the numbering of math in display mode?

Use the environment equation*, align*, aligned* or eqnarray*. Alternatively, use \nonumber{...your equation...}.

You will have to make sure that your CSS sheet contains the following rule:

.nonumber .katex-display::after {
  counter-increment: nothing;
  content: "";
}

So for instance using \begin{align*}...\end{align*}:

Or using \nonumber{$$ ... $$}:

Recall that numbered equations can be referred to via \eqref:

like this: (1).

Code

How to use loops for templating?

Reference: issue 251, more on this: code tricks.

Since you can show the output of any Julia code block (and interpret that output as Franklin markdown), you can use this to help with templating. For instance:

```julia:./ex
#hideall
for name in ("Shinzo", "Donald", "Angela", "Christine")
    println("""
    @@card
    ### $name
    ![]("$(lowercase(name)).jpg")
    @@
    """)
end
```
\textoutput{./ex}

Generates

<div class="card"><h3 id="shinzo"><a href="/index.html#shinzo">Shinzo</a></h3>  <img src="shinzo.jpg" alt="" /></div>
<div class="card"><h3 id="donald"><a href="/index.html#donald">Donald</a></h3>  <img src="donald.jpg" alt="" /></div>
<div class="card"><h3 id="angela"><a href="/index.html#angela">Angela</a></h3>  <img src="angela.jpg" alt="" /></div>
<div class="card"><h3 id="christine"><a href="/index.html#christine">Christine</a></h3>  <img src="christine.jpg" alt="" /></div>

How to insert Plotly plots?

Reference: issue 322.

See this tutorial for a way to do this.