PSML(1)

NAME
PSML - manual page for LMFS PSML Compiler

SYNOPSIS
psml <files...> [targets...]

DESCRIPTION
This is LMFS-PSML Compiler. It has a built-in staging server and can compile one psml file into many usable HTML pages. It can reduce some of the development steps for you, so that you can complete the front-end development faster. It is free(libre) software, open source under the GPL v2.0 license.

OPTIONS

--  With this option, all options that follow are treated as file names

-Werror-*
    Use this parameter to have PSML, when outputting the corresponding warning, convert it to a "Force ERROR" output and end the compilation with an error

-no-*
    Use this option to make PSML output an "Ignored" (-quiet mode will not output) when PSML encounters a command or element related to the '*' section when compiling the page. Example psml -no-server #Using this, PSML will ignore all server related parts

-keeponly=*
    After compiling a PSML page, with this option, the PSML compiler decides which pages to keep (all if '*' is 'all')

-script=*
    Set the content of the language attribute when the script element appears, which is javascript by default

-style=*
    Sets the format used by the page style. The default is 'text/css'

-print=*
    This option is used to print out the specified compilation result (print all when '*' is' all ', and return dict when not used)

-D*=*
    After using this options, a variable with the name of the first * and the content of the second * will be automatically defined, and the type is const

-c -compile
    Preprocess only, and then output the preprocessed content. The effect is equivalent to -mode=3

-q -quiet
    With this parameter, the PSML compiler will not output any 'NOTE'

-o -output *
    After compiling, the PSML compiler will output the compiled content to the bottom folder given by the '*' section (if it does not exist, it will be created automatically) (if the compilation mode is 3, it will output <reserved page branch name> + .compiled.psml to the '*' folder)

-mode=1|2|3|4
    Adjust the compile mode at compile times (Please refer to 'COMPILE MODE' paragraph for explanation of compilation mode)

-install
    When you run it in the PSML source directory, PSML will invoke the bash run install.sh to install it (which requires you to install bash)

-uninstall
    When you use it, PSML will run pip3 to uninstall the psmlc package (this action needs to be confirmed by the user)

-online
    Used to start PSML editing, preview page, preview compiled code functions and all-in-one web server

-u -upgrade
    Automatically detects the PSML compiler version and automatically updates to the latest version if a new version exists

-cv -check-version
    Detect whether a new release of PSML is available

-man
    Show this manual page

-h -help
    Display PSML Compiler Help

-v -version
    Displays the current PSML compiler version

COMPILE MODE
1 In the normal compilation mode, the standard output is performed, and the compilation process is as follows: preprocessing > syntax analysis > internal element analysis > page generation > page saving

2   Webpage embedded compilation mode, which does not output any NOTE, WARNING (except the Werror part) and IGNORED, outputs the error as HTML page code format, and also carries out the complete compilation process

3   Pre-processing mode, in which only the pre-processing runs, and the compiler will exit and output the pre-processed content after the processing is completed

4   This mode will only run the processor after the original preprocessor runs, and then the standard output (if your code is not preprocessed and does not meet the strict syntax requirements of the standard PSML, do not use this mode at your own risk)