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 FindProcDLL, choose the release for unicode (https://nsis.sourceforge.io/FindProcDLL_plug-in),
  10   extract from it the file FindProc.dll to the folder \Plugins\x86-unicode of NSIS's installation folder
  11 - download the plugin Inetc (https://nsis.sourceforge.io/Inetc_plug-in)
  12   extract the content into the NSIS's installation folder
  13 - open the file settings.nsh with a text editor and adapt the settings for your need. A good text editor
  14   for NSIS development is e.g. Visual Studio Code with the NSIS extension.
  15 - right-click on the file lyx-standard.nsi and choose "Compile NSIS script"
  16
  17
  18 Updating dependencies
  19 =====================
  20
  21 - Imagemagick:
  22   download the portable version of imagemagick for windows from https://imagemagick.org/script/download.php (32 or 64 bit),
  23   current version is 7.0.10-0
  24   extract the zip archive, there will be many executable files which are the exact same size as "magick.exe" which is
  25   the only executable LyX needs, delete these redundant executables. Also delete ffmpeg.exe and IMDisplay.exe.
  26   The resulting folder size should be around 15-16 MB
  27
  28 - Ghostscript
  29   download ghostscript for windows from https://www.ghostscript.com/download/gsdnld.html (32 or 64 bit), current version is 9.50
  30   install to your computer or open the installer executable with 7zip, extract the folders "bin" and "lib" from the installdir/archive
  31   to %%dependencies%%\ghostscript.
  32
  33 - Python
  34   download the latest Python 2 release for windows from https://www.python.org/downloads/windows/ (32 or 64 bit),
  35   current version is 2.7.17
  36   Install it or extract with a tool named lessmsi. If you install it, you will have to find python27.dll in the
  37   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
  38   are stored in Windows\SysWOW64. Copy this python27.dll to %%dependencies%%\Python, from the python installation folder copy
  39   all files and "DLLs", "Lib" and "libs" subfolders to %%dependencies%%\Python. You can uninstall python afterwards.
  40   If you extracted with lessmsi, you will also get visual studio runtime dlls and some executables, which are used during installation,
  41   these are not needed. Copy the 2 python executables, the python dll, the 3 textfiles (license, news and readme) and the "DLLs",
  42   "Lib" and "libs" subfolders to %%dependencies%%\Python.
  43
  44 - Visual Studio runtime
  45   Download the latest Visual C++ Redistributable (if you still haven't), the version should match with your VS C++ compiler
  46   (Buildtools) though. Find these files in Windows/System32 folder:
  47    concrt140.dll
  48    msvcp140.dll
  49    vcamp140.dll
  50    vccorlib140.dll
  51    vcomp140.dll
  52    vcruntime140.dll
  53   For 64 bit you will additionally need
  54    vcruntime140_1.dll
  55   See the Python description above for explanation of different store locations of 64 and 32 bit dlls. Copy these dlls to
  56   %%dependencies%%\bin.
  57
  58 - NetPbm
  59   download the latest binaries zip file from http://gnuwin32.sourceforge.net/packages/netpbm.htm,
  60   current version is 10.27, last updated on 12 May 2005
  61   extract the files
  62    libnetpbm10.dll
  63    pnmcrop.exe
  64   to %%dependencies%%\bin.
  65
  66 - DTL
  67   Using TeX Live Manager install package dtl.win32, current version is 0.6.1.
  68   From C:\texlive\2019\bin\win32 copy these files
  69    dt2dv.exe
  70    dv2dt.exe
  71   to %%dependencies%%\bin. You can uninstall the package afterwards.
  72
  73 - rsvg-convert
  74   dowload the 7zip archve from https://opensourcepack.blogspot.com/2012/06/rsvg-convert-svg-image-conversion-tool.html,
  75   current version is 2.40.20
  76   Extract rsvg-convert.exe ti %%dependencies%%\bin.
  77
  78 - unoconv
  79   download the latest source code (zip) from https://github.com/unoconv/unoconv/releases
  80   current version is 0.8.2
  81   extract unoconv (no file extension) to %%dependencies%%\bin and add the extension ".py"
  82
  83 - pdfview.exe
  84   this is a NSIS script, which calls users standard pdf viewer to display pdf files you compile with
  85   LaTeX using LyX, its source is available in %%lyxgit%%\development\Win32\pdfview,
  86   it uses System.dll and Console.dll