development/Win32/packaging/installer/Readme.txt

   1 Building the installer
   2 ======================
   3
   4 To build the installer do the following:
   5
   6 - install the latest version 3.x of NSIS (https://nsis.sourceforge.io/Download)
   7 - install the NSIS Large Strings build (https://nsis.sourceforge.io/Special_Builds)
   8   (extract the extension ZIP file in your NSIS installation folder and this way overwrite some files)
   9 - download the plugin Inetc (https://nsis.sourceforge.io/Inetc_plug-in)
  10   extract the content into the NSIS's installation folder
  11 - download the plugin NSISList (https://nsis.sourceforge.io/NSISList_plug-in), download both .zip archives,
  12   extract Include\NSISList.nsh from the first archive to the folder Include of NSIS's installation folder and
  13   extract NSISList-Unicode\NSISList.dll from the second archive to the folder \Plugins\x86-unicode of NSIS's installation folder
  14 - download the plugin ShellLink (https://nsis.sourceforge.io/ShellLink_plug-in)
  15   extract Unicode\Plugins\ShellLink.dll from the archive to the folder \Plugins\x86-unicode of NSIS's installation folder
  16 - download the plugin ShellExecAsUser (https://nsis.sourceforge.io/ShellExecAsUser_plug-in), choose Unicode version
  17   extract unicode\ShellExecAsUser.dll from the archive to the folder \Plugins\x86-unicode of NSIS's installation folder
  18 - Go to the Qt-kit directory, which you have specified as CMAKE_PREFIX_PATH before compiling in CMake Gui, enter the bin folder,
  19   copy these files:
  20    Qt5Concurrent.dll"
  21    Qt5Network.dll"
  22    Qt5OpenGL.dll"
  23    Qt5PrintSupport.dll"
  24   to %%lyxbuild%%\LYX_INSTALLED\bin
  25 - open the file settings.nsh with a text editor and adapt the settings for your need. A good text editor
  26   for NSIS development is e.g. Visual Studio Code with the NSIS extension.
  27 - right-click on the file lyx-standard.nsi and choose "Compile NSIS script"
  28
  29
  30 Updating dependencies
  31 =====================
  32
  33 - Imagemagick:
  34   download the portable version of imagemagick for windows from https://imagemagick.org/script/download.php (32 or 64 bit),
  35   current version is 7.0.10-0
  36   extract the zip archive,
  37   run imagemagickConvert.bat in %%repo%%\development\Win32\packaging\dependencies, browse to the extracted imagemagick archive,
  38   after the script finishes check for anything suspicious.
  39   if there is anything suspicious or it didn't work (in case imagemagic devs changed something), read the following description,
  40   it describes how it was done for 7.0.10-0, repair the bat file and update the description
  41   In the fresh extracted archive will be many executable files which are the exact same size as "magick.exe". magick.exe is
  42   the only executable LyX needs, delete the other redundant executables. Also delete ffmpeg.exe and IMDisplay.exe.
  43   The resulting folder size should be around 15-16 MB
  44
  45 - Ghostscript
  46   download ghostscript for windows from https://www.ghostscript.com/download/gsdnld.html (32 or 64 bit), current version is 9.50
  47   install to your computer or open the installer executable with 7zip, extract the folders "bin" and "lib" from the installdir/archive
  48   to %%dependencies%%\ghostscript.
  49
  50 - Python
  51   download the latest Python 2 release for windows from https://www.python.org/downloads/windows/ (32 or 64 bit),
  52   current version is 2.7.17
  53   Install it or extract with a tool named lessmsi. If you install it, you will have to find python27.dll in the
  54   Windows\System32 folder. 64-bit dlls on a 64-bit windows are stored in Windows\System32 folder, 32-bit dlls on a 64-bit windows
  55   are stored in Windows\SysWOW64. Copy this python27.dll to %%dependencies%%\Python, from the python installation folder copy
  56   all files and "DLLs", "Lib" and "libs" subfolders to %%dependencies%%\Python. You can uninstall python afterwards.
  57   If you extracted with lessmsi, you will also get visual studio runtime dlls and some executables, which are used during installation,
  58   these are not needed. Copy the 2 python executables, the python dll, the 3 textfiles (license, news and readme) and the "DLLs",
  59   "Lib" and "libs" subfolders to %%dependencies%%\Python.
  60
  61 - Visual Studio runtime
  62   Download the latest Visual C++ Redistributable (if you still haven't), the version should match with your VS C++ compiler
  63   (Buildtools) though. Find these files in Windows/System32 folder:
  64    concrt140.dll
  65    msvcp140.dll
  66    vcamp140.dll
  67    vccorlib140.dll
  68    vcomp140.dll
  69    vcruntime140.dll
  70   For 64 bit you will additionally need
  71    vcruntime140_1.dll
  72   See the Python description above for explanation of different store locations of 64 and 32 bit dlls. Copy these dlls to
  73   %%dependencies%%\bin.
  74
  75 - NetPbm
  76   download the latest binaries zip file from http://gnuwin32.sourceforge.net/packages/netpbm.htm,
  77   current version is 10.27, last updated on 12 May 2005
  78   extract the files
  79    libnetpbm10.dll
  80    pnmcrop.exe
  81   to %%dependencies%%\bin.
  82
  83 - DTL
  84   Using TeX Live Manager install package dtl.win32,
  85   From C:\texlive\2019\bin\win32 copy these files
  86    dt2dv.exe
  87    dv2dt.exe
  88   to %%dependencies%%\bin. You can uninstall the package afterwards.
  89   Info: Version 0.6.1 does not work with MikTex (math preview triggers error complaining about missing kpathsea631.dll),
  90   therefore this method is not usable.
  91   Update: as of report 11325 DTL tools are included in lyxgit and get compiled alongside lyx.
  92
  93 - rsvg-convert
  94   dowload the 7zip archve from https://opensourcepack.blogspot.com/2012/06/rsvg-convert-svg-image-conversion-tool.html,
  95   current version is 2.40.20
  96   Extract rsvg-convert.exe ti %%dependencies%%\bin.
  97
  98 - unoconv
  99   download the latest source code (zip) from https://github.com/unoconv/unoconv/releases
 100   current version is 0.8.2
 101   extract unoconv (no file extension) to %%dependencies%%\bin and add the extension ".py"
 102
 103 - pdfview.exe
 104   this is a NSIS script, which calls users standard pdf viewer to display pdf files you compile with
 105   LaTeX using LyX, its source is available in %%lyxgit%%\development\Win32\pdfview
 106
 107 Note: if you update any dependencies, please add a note to ChangeLog.txt