<para>Here is a simple example:</para>
<mediaobject>
<imageobject>
-<imagedata fileref='lyxpreviewAJskuj1.png' />
+<imagedata fileref='lyx_waUJAzFwGUKDEN7MJCcs6gYNMbJuYBkgsRTDTpIvs.png' />
</imageobject>
<textobject>
<programlisting language='latex' role='forest'>[VP [DP[John]] [V' [V[sent]] [DP[Mary]] [DP[D[a]][NP[letter]]] ] ]</programlisting>
<para>expands to a real structure tree. To view the result within the work area, you can simply embed the Structure Tree inset into a Preview inset. If instant preview is correctly installed and activated, you should see the tree immediately (just click on the image in order to edit):</para>
<para><mediaobject>
<imageobject>
-<imagedata fileref='lyxpreviewWZhpAx1.png' />
+<imagedata fileref='lyx_Neo86S96tfZZQHjpBg7ADIb30ZP0DTrDTR1DEIL6dM.png' />
</imageobject>
<textobject>
<programlisting language='latex' role='forest'>[VP [DP[Mary]] [V' [V[sent]] [DP[John]] [DP[D[a]][NP[response]]] ] ]</programlisting>
<para>Roofs can be easily generated by means of the <code>roof</code> option (note that the comma has special meaning, as it marks options):</para>
<mediaobject>
<imageobject>
-<imagedata fileref='lyxpreviewQJTcYJ1.png' />
+<imagedata fileref='lyx_Evmv0h17wY4EoBIBFZjUQJMv0cyWz6KodzrzPiY1tQ.png' />
</imageobject>
<textobject>
<programlisting language='latex' role='forest'>[VP [DP[John]] [V' [V[sent]] [DP[Mary]] [DP[another letter, roof]] ] ]</programlisting>
<para>In order to align nodes of the tree more elegantly, use the “tier” option. All nodes which have the same <code>tier</code> allocated get aligned. Here is an example:</para>
<mediaobject>
<imageobject>
-<imagedata fileref='lyxpreviewBkSuoA1.png' />
+<imagedata fileref='lyx_EafAhhREpvwrFIFUHprlnoS9qCdR7kk23QfWTsObCjg.png' />
</imageobject>
<textobject>
<programlisting language='latex' role='forest'>[VP [DP[John,tier=word]] [V' [V[sent,tier=word]] [DP[Mary,tier=word]] [DP[D[a,tier=word]][NP[letter,tier=word]]] ] ]</programlisting>
#include <algorithm>
#include <stack>
+#include <QCryptographicHash>
+
using namespace std;
using namespace lyx::support;
LASSERT(img != nullptr, return);
support::FileName const & filename = img->filename();
+ // Use a file name that is only determined by the LaTeX code: the name of
+ // the snippet is more or less random (i.e., if the user generates the file
+ // several times, they will have a clutter of preview files).
+ // Hence: use a cryptographic hash of the snippet. If the snippet changes,
+ // the file name will change a lot; two snippets are unlikely to have the
+ // same hash (by design of cryptographic hash functions). Computing a hash
+ // is typically slow, but extremely fast compared to compilation of the
+ // preview and image rendering.
+ QString snippetQ = QString(snippet.c_str());
+#if QT_VERSION >= 0x050000
+ QByteArray hash = QCryptographicHash::hash(snippetQ.toLocal8Bit(), QCryptographicHash::Sha256);
+#else
+ QByteArray hash = QCryptographicHash::hash(snippetQ.toLocal8Bit(), QCryptographicHash::Sha1);
+#endif
+ auto newFileBase = QString(hash.toBase64())
+ .replace("/", "")
+ .replace("+", "")
+ .replace("=", "");
+ std::string newFileName = "lyx_" + newFileBase.toStdString() + "." + filename.extension();
+
// Copy the image into the right folder.
- rp.exportdata->addExternalFile("docbook5", filename, filename.onlyFileName());
+ rp.exportdata->addExternalFile("docbook5", filename, newFileName);
// TODO: deal with opts. What exactly is the WriterOuterTag here, for instance?
// Start writing the DocBook code for the image.
// Output the rendered inset.
xs << xml::StartTag("imageobject")
<< xml::CR()
- << xml::CompTag("imagedata", std::string("fileref='") + filename.onlyFileName() + "'")
+ << xml::CompTag("imagedata", std::string("fileref='") + newFileName + "'")
<< xml::CR()
<< xml::EndTag("imageobject")
<< xml::CR();