LyX wiki | Devel / WindowsInstallerPages

Categories: Development, Windows installer

<< | Page list | >>

About the "pages" in the Windows installer. The "pages" are what is shown in a sequence during the installation process. This page also lists the 'sections'

The purpose of this page is initially a part of documenting the structure of U's and J's codes. Later on we could use this wiki page to decide/select/determine a new structure for the installer pages.

Table of contents (hide)

1. Misc
2. Pages in U-small
3. Sections in U-small
4. Pages in U-bundle
5. Sections in U-bundle
6. Pages in J-small and J-bundle?
7. Sections in J

1. Misc

C searched for page statements using something like

cd LyXWinInstaller;
grep -ir --include="*.ns?" '\(^[ ]*page\)\|MUI_PAGE\|MUI_UNPAGE' .

After that it was manual inspection.

2. Pages in U-small

LyX-Installer-Small.nsi

!insertmacro MUI_PAGE_WELCOME
!insertmacro MUI_PAGE_LICENSE "${PRODUCT_LICENSE_FILE}"
!insertmacro MUI_PAGE_DIRECTORY
Page custom SelectMenuLanguage SelectMenuLanguage_LeaveFunction
!insertmacro MUI_PAGE_COMPONENTS
!insertmacro MUI_PAGE_STARTMENU ${PRODUCT_NAME} $StartmenuFolder
Page custom LatexFolder LatexFolder_LeaveFunction
Page custom MissingProgramsPage MissingProgramsPage_LeaveFunction
!insertmacro MUI_PAGE_INSTFILES
!insertmacro MUI_PAGE_FINISH
!insertmacro MUI_UNPAGE_COMPONENTS
!insertmacro MUI_UNPAGE_INSTFILES

3. Sections in U-small

LyX-Installer-Small.nsi

Section "!${PRODUCT_NAME}" SecCore
Section "$(SecAllUsersTitle)" SecAllUsers
Section "$(SecFileAssocTitle)" SecFileAssoc
Section "$(SecDesktopTitle)" SecDesktop

Uninstall.nsh

Section "un.LyX" un.SecUnProgramFiles
Section "un.$(UnLyXPreferencesTitle)" un.SecUnPreferences
Section "un.Aspell" un.SecUnAspell
Section "un.MiKTeX" un.SecUnMiKTeX
Section "un.JabRef" un.SecUnJabRef

InstallActions-small.nsh

Section "-Installation actions" SecInstallation

4. Pages in U-bundle

LyX-Installer-Complete.nsi

!insertmacro MUI_PAGE_WELCOME
!insertmacro MUI_PAGE_LICENSE "${PRODUCT_LICENSE_FILE}"
!insertmacro MUI_PAGE_DIRECTORY
Page custom SelectMenuLanguage SelectMenuLanguage_LeaveFunction
!insertmacro MUI_PAGE_COMPONENTS
!insertmacro MUI_PAGE_STARTMENU ${PRODUCT_NAME} $StartmenuFolder
Page custom MissingProgramsPage MissingProgramsPage_LeaveFunction
!insertmacro MUI_PAGE_INSTFILES
!insertmacro MUI_PAGE_FINISH
!insertmacro MUI_UNPAGE_COMPONENTS
!insertmacro MUI_UNPAGE_INSTFILES

5. Sections in U-bundle

LyX-Installer-complete.nsi

Section "-Installation actions" SecInstallation

Uninstall.nsh

Section "un.LyX" un.SecUnProgramFiles
Section "un.$(UnLyXPreferencesTitle)" un.SecUnPreferences
Section "un.Aspell" un.SecUnAspell
Section "un.MiKTeX" un.SecUnMiKTeX
Section "un.JabRef" un.SecUnJabRef

LyX-Installer-Complete.nsi

Section "!${PRODUCT_NAME}" SecCore
Section "$(SecAllUsersTitle)" SecAllUsers
Section "$(SecFileAssocTitle)" SecFileAssoc
Section "$(SecDesktopTitle)" SecDesktop
Section /o "$(SecInstGSviewTitle)" SecInstGSview
Section /o "$(SecInstJabRefTitle)" SecInstJabRef

6. Pages in J-small and J-bundle?

Are the pages really the same?

include/gui.nsh

!insertmacro MUI_PAGE_WELCOME
!insertmacro MUI_PAGE_LICENSE "${FILES_LICENSE}"
Page custom PageUser PageUserValidate
Page custom PageReinstall PageReinstallValidate
Page custom PageExternalLaTeX PageExternalLaTeXValidate
Page custom PageExternalImageMagick PageExternalImageMagickValidate
Page custom PageExternalGhostscript PageExternalGhostscriptValidate
Page custom PageViewer PageViewerValidate
Page custom PageLanguage PageLanguageValidate
!define MUI_PAGE_HEADER_TEXT $(TEXT_DICT_TITLE)
!define MUI_PAGE_HEADER_SUBTEXT $(TEXT_DICT_SUBTITLE)
!insertmacro MUI_PAGE_COMPONENTS ;For spell checker dictionaries
!insertmacro MUI_PAGE_DIRECTORY
!insertmacro MUI_PAGE_INSTFILES
!define MUI_PAGE_CUSTOMFUNCTION_PRE CheckDesktopShortcut
!insertmacro MUI_PAGE_FINISH
!insertmacro MUI_UNPAGE_WELCOME
!insertmacro MUI_UNPAGE_CONFIRM
!insertmacro MUI_UNPAGE_COMPONENTS
!insertmacro MUI_UNPAGE_INSTFILES
!insertmacro MUI_UNPAGE_FINISH

../../launcher/launcher.nsi

!insertmacro MUI_PAGE_INSTFILES

7. Sections in J

components/uninstall.nsh

Section "un.Program Files" un.SecProgramFiles
Section "un.User Preferences and Custom Files" un.SecUserFiles

components/external.nsh

Section -LaTeX ExternalLaTeX
Section -ImageMagick ExternalImageMagick
Section -Ghostscript ExternalGhostscript

components/core.nsh

Section -Core SecCore

components/configure.nsh

Section -FileAssociations
Section -InstallData
Section -LaTeX
Section -Configure

components/dicts.nsh

   Section /o "${LANGNAME}"
Section -AspellDicts

components/viewer.nsh

Section -Viewer ExternalViewer

../../pdfview/pdfview.nsi

Section "View PDF file"

../../launcher/launcher.nsi

Section -Prepare
Section -Launch
Section -Debug

Category: Development, Windows installer