diff --git a/config/en/imports/develop.nss b/config/en/imports/develop.nss index a108f42..f857abe 100644 --- a/config/en/imports/develop.nss +++ b/config/en/imports/develop.nss @@ -1,4 +1,4 @@ -menu(mode="multiple" title='&Develop' sep=sep.bottom image=\uE26E) +menu(mode="multiple" title='&Develop' vis=key.shift() sep=sep.bottom image=\uE26E) { menu(mode="single" title='editors' image=\uE17A) { @@ -18,8 +18,8 @@ menu(mode="multiple" sep="both" title='publish' image=\ue11f) { - var { publish='dotnet publish -r win-x64 -c release --output "@sel.parent\publish" /p:CopyOutputSymbolsToPublishDirectory=false' } - item(title='publish single file' sep="after" cmd-line='/K @publish -p:PublishSingleFile=true --self-contained false') + $publish='dotnet publish -r win-x64 -c release --output publish /*/p:CopyOutputSymbolsToPublishDirectory=false*/' + item(title='publish sinale file' sep="after" cmd-line='/K @publish --no-self-contained /p:PublishSingleFile=true') item(title='framework-dependent deployment' cmd-line='/K @publish') item(title='framework-dependent executable' cmd-line='/K @publish --self-contained false') item(title='self-contained deployment' cmd-line='/K @publish --self-contained true') diff --git a/config/en/imports/file-manage.nss b/config/en/imports/file-manage.nss index 8956e96..a176351 100644 --- a/config/en/imports/file-manage.nss +++ b/config/en/imports/file-manage.nss @@ -1,6 +1,6 @@ -menu(where=sel.count>0 type='file|dir|drive|namespace|back' mode="multiple" title='File manage' image=\uE253) +menu(where=sel.count>0 type='file|dir|drive|namespace|back' mode="multiple" title='File Manage' image=\uE253) { - menu(separator="after" title='Copy Path' image=icon.copy_path) + menu(separator="after" title=title.copy_path image=icon.copy_path) { item(where=sel.count > 1 title='Copy (@sel.count) items selected' cmd=command.copy(sel(false, "\n"))) item(mode="single" title=@sel.path tip=sel.path cmd=command.copy(sel.path)) @@ -12,6 +12,9 @@ item(mode="single" type='file' where=sel.file.len != sel.file.title.len title=@sel.file.title cmd=command.copy(sel.file.title)) item(mode="single" type='file' where=sel.file.ext.len>0 title=sel.file.ext cmd=command.copy(sel.file.ext)) } + + item(mode="single" type="file" title="Change extension" image=\uE0B5 cmd=if(input("Change extension", "Type extension"), + io.rename(sel.path, path.join(sel.dir, sel.file.title + "." + input.result)))) menu(separator="after" image=\uE290 title=title.select) { @@ -31,7 +34,7 @@ menu(type='file|dir|back.dir' mode="single" title='Attributes') { - var { atrr = io.attributes(sel.path) } + $atrr = io.attributes(sel.path) item(title='Hidden' checked=io.attribute.hidden(atrr) cmd args='/c ATTRIB @if(io.attribute.hidden(atrr),"-","+")H "@sel.path"' window=hidden) @@ -65,7 +68,7 @@ menu(title='New File' image=icon.new_file) { - var { dt = sys.datetime("ymdHMSs")} + $dt = sys.datetime("ymdHMSs") item(title='TXT' cmd=io.file.create('@(dt).txt', 'Hello World!')) item(title='XML' cmd=io.file.create('@(dt).xml', 'Hello World!')) item(title='JSON' cmd=io.file.create('@(dt).json', '[]')) diff --git a/config/en/imports/goto.nss b/config/en/imports/goto.nss index 47ad908..5711acb 100644 --- a/config/en/imports/goto.nss +++ b/config/en/imports/goto.nss @@ -1,4 +1,4 @@ -menu(type='*' where=window.is_taskbar||sel.count mode=mode.multiple title='Goto' sep=sep.both image=\uE14A) +menu(type='*' where=window.is_taskbar||sel.count mode=mode.multiple title=title.go_to sep=sep.both image=\uE14A) { menu(title='Folder' image=\uE1F4) { @@ -23,7 +23,7 @@ menu(type='*' where=window.is_taskbar||sel.count mode=mode.multiple title='Goto' item(title=title.control_panel image=\uE0F3 cmd='shell:::{5399E694-6CE5-4D6C-8FCE-1D8870FDCBA0}') item(title='All Control Panel Items' image=\uE0F3 cmd='shell:::{ED7BA470-8E54-465E-825C-99712043E01C}') item(title=title.run image=\uE14B cmd='shell:::{2559a1f3-21d7-11d4-bdaf-00c04f60b9f0}') - menu(title=title.settings sep=sep.before image=\uE0F3) + menu(where=sys.ver.major >= 10 title=title.settings sep=sep.before image=\uE0F3) { // https://docs.microsoft.com/en-us/windows/uwp/launch-resume/launch-settings-app item(title='system' image=inherit cmd='ms-settings:') @@ -39,7 +39,7 @@ menu(type='*' where=window.is_taskbar||sel.count mode=mode.multiple title='Goto' item(title='apps-features' image=inherit cmd='ms-settings:appsfeatures') item(title='default-apps' image=inherit cmd='ms-settings:defaultapps') item(title='optional-features' image=inherit cmd='ms-settings:optionalfeatures') - item(title='startup' image=inherit cmd='ms-settings:startup') + item(title='startup' image=inherit cmd='ms-settings:startupapps') } menu(title='personalization' image=inherit) { diff --git a/config/en/imports/images.nss b/config/en/imports/images.nss index 6498000..70854b0 100644 --- a/config/en/imports/images.nss +++ b/config/en/imports/images.nss @@ -1,21 +1,17 @@ -var -{ - color3 = @if(theme.islight,image.color3,'none') - color_islight_WB = @if(theme.islight,'#fff','#000') - svg_jjjj='' - clipPath='' - svg_window_template2='' - svg_window_template='' -} +$color3 = @if(theme.islight,image.color3,'none') +$color_islight_WB = @if(theme.islight,'#fff','#000') +$clipPath='' +$svg_window_template2='' +$svg_window_template='' -copy,copy_to_clipboard=' +@copy,copy_to_clipboard=' ' -cut=' +@cut=' @@ -24,7 +20,7 @@ cut=' @clipPath ' -paste=' +@paste=' @@ -32,7 +28,7 @@ paste=' ' -paste_shortcut=' +@paste_shortcut=' @@ -40,7 +36,7 @@ paste_shortcut=' ' -move_to, move_here=' +@move_to, move_here=' @@ -48,7 +44,7 @@ move_to, move_here=' ' -copy_as_path, copy_path=' +@copy_as_path, copy_path=' @@ -56,20 +52,20 @@ copy_as_path, copy_path=' ' -settings, options, folder_options, taskbar_settings=' +@settings, options, folder_options, taskbar_settings=' - @svg_jjjj + @clipPath ' -task_manager=' +@task_manager=' ' -run_as_administrator=' +@run_as_administrator=' @@ -78,13 +74,13 @@ run_as_administrator=' @clipPath ' -run_as_different_user=' +@run_as_different_user=' ' -personalize=' +@personalize=' @@ -94,21 +90,21 @@ personalize=' @clipPath ' -display_settings=' +@display_settings=' ' // pin -pin, pin_to_start, pin_to_taskbar, pin_to_quick_access, pin_current_folder_to_quick_access, pin_to_start_menu=' +@pin, pin_to_start, pin_to_taskbar, pin_to_quick_access, pin_current_folder_to_quick_access, pin_to_start_menu=' ' // unpin -unpin, unpin_from_start, unpin_from_taskbar, unpin_from_quick_access, remove_from_quick_access, remove_from_recent, unpin_from_start_menu=' +@unpin, unpin_from_start, unpin_from_taskbar, unpin_from_quick_access, remove_from_quick_access, remove_from_recent, unpin_from_start_menu=' @@ -120,12 +116,12 @@ unpin, unpin_from_start, unpin_from_taskbar, unpin_from_quick_access, remove_fro @clipPath ' -add_to_favorites=' +@add_to_favorites=' ' -remove_from_favorites=' +@remove_from_favorites=' @@ -136,13 +132,13 @@ remove_from_favorites=' @clipPath ' -delete, permanently_delete, empty_recycle_bin=' +@delete, permanently_delete, empty_recycle_bin=' ' -sort_by=' +@sort_by=' @@ -152,12 +148,12 @@ sort_by=' @clipPath ' -group_by=' +@group_by=' ' -view=' +@view=' @@ -168,33 +164,33 @@ view=' ' -view2=' +@view2=' ' -align_icons_to_grid=' +@align_icons_to_grid=' ' -auto_arrange_icons=' +@auto_arrange_icons=' ' -close, cancel=' +@close, cancel=' ' -expand=' +@expand=' ' -expand_all, expand_group, expand_all_groups=' +@expand_all, expand_group, expand_all_groups=' @@ -204,13 +200,13 @@ expand_all, expand_group, expand_all_groups=' +@collapse=' ' -collapse_all, collapse_group, collapse_all_groups=' +@collapse_all, collapse_group, collapse_all_groups=' @@ -220,7 +216,7 @@ collapse_all, collapse_group, collapse_all_groups=' +@format=' @@ -234,7 +230,7 @@ format=' ' -eject=' +@eject=' @@ -242,7 +238,7 @@ eject=' @clipPath ' -content=' +@content=' @@ -251,30 +247,30 @@ content=' ' -details=' +@details=' ' -extra_large_icons=' +@extra_large_icons=' ' -large_icons=' +@large_icons=' ' -list=' +@list=' ' -medium_icons=' +@medium_icons=' ' -small_icons=' +@small_icons=' @@ -285,41 +281,41 @@ small_icons=' ' -tiles=' +@tiles=' ' -install=' +@install=' ' -select_all, 'Выбрать все'=' +@select_all, 'Выбрать все'=' ' -invert_selection=' +@invert_selection=' ' -select_none=' +@select_none=' ' -share, share_with=' +@share, share_with=' ' -mount=' +@mount=' @@ -331,46 +327,46 @@ mount=' @clipPath ' -new, new_item=' +@new, new_item=' ' -new_folder=' +@new_folder=' ' -new_file=' +@new_file=' ' -open_folder,open_folder_location, open_file_location, open_as_portable=' +@open_folder,open_folder_location, open_file_location, open_as_portable=' ' -open_new_window, open_in_new_window, open_in_new_process=' +@open_new_window, open_in_new_window, open_in_new_process=' ' -open_new_tab, open_in_new_tab=' +@open_new_tab, open_in_new_tab=' ' -open_spot_light=' +@open_spot_light=' ' -open_with=' +@open_with=' @@ -380,13 +376,13 @@ open_with=' @clipPath ' -run_with_powershell, open_windows_powershell, open_powershell_window_here,windows_powershell,windows_powershell_admin=' +@run_with_powershell, open_windows_powershell, open_powershell_window_here,windows_powershell,windows_powershell_admin=' ' -properties=' +@properties=' @@ -394,14 +390,14 @@ properties=' @clipPath ' -restore=' +@restore=' @clipPath ' -undo, undo_copy,undo_delete, undo_rename, undo_new, undo_move=' +@undo, undo_copy,undo_delete, undo_rename, undo_new, undo_move=' @@ -409,7 +405,7 @@ undo, undo_copy,undo_delete, undo_rename, undo_new, undo_move='' -redo, redo_delete, redo_rename, redo_new, redo_move=' +@redo, redo_delete, redo_rename, redo_new, redo_move=' @@ -417,38 +413,38 @@ redo, redo_delete, redo_rename, redo_new, redo_move=' +@refresh=' ' -rename=' +@rename=' ' -rotate_left=' +@rotate_left=' ' -rotate_right=' +@rotate_right=' ' -set_as_desktop_wallpaper, set_as_desktop_background=' +@set_as_desktop_wallpaper, set_as_desktop_background=' ' -next_desktop_background=' +@next_desktop_background=' @@ -457,7 +453,7 @@ next_desktop_background=' ' -desktop, show_desktop, show_desktop_icons,show_the_desktop=' +@desktop, show_desktop, show_desktop_icons,show_the_desktop=' @@ -467,18 +463,18 @@ desktop, show_desktop, show_desktop_icons,show_the_desktop='' -restore_previous_versions=' +@restore_previous_versions=' ' -create_shortcut, create_shortcuts_here=' +@create_shortcut, create_shortcuts_here=' ' -turn_on_bitlocker, turn_off_bitlocker=' +@turn_on_bitlocker, turn_off_bitlocker=' @@ -489,39 +485,39 @@ turn_on_bitlocker, turn_off_bitlocker=' @clipPath ' -show_file_extensions=' +@show_file_extensions=' ' -show_hidden_files=' +@show_hidden_files=' ' -compressed=' +@compressed=' ' -more_options=' +@more_options=' ' -burn_disc_image=' +@burn_disc_image=' ' -cleanup=' +@cleanup=' @@ -532,7 +528,7 @@ cleanup=' @clipPath ' -move_to, move_here,move_to_folder, extract_all, extract_to=' +@move_to, move_here,move_to_folder, extract_all, extract_to=' @@ -540,58 +536,58 @@ move_to, move_here,move_to_folder, extract_all, extract_to=' ' -copy_to,copy_to_folder,copy_here=' +@copy_to,copy_to_folder,copy_here=' ' -pc,this_pc=' +@pc,this_pc=' ' -command_prompt,command_prompt_admin,open_command_prompt,open_command_window_here=' +@command_prompt,command_prompt_admin,open_command_prompt,open_command_window_here=' @svg_window_template ' -manage=' +@manage=' ' -edit=' +@edit=' ' -troubleshoot_compatibility=' +@troubleshoot_compatibility=' @svg_window_template2 ' -customize_this_folder=' +@customize_this_folder=' ' -give_access_to=' +@give_access_to=' ' -send_to=' +@send_to=' ' -include_in_library=' +@include_in_library=' ' -add_a_network_location=' +@add_a_network_location=' @@ -599,7 +595,7 @@ add_a_network_location=' ' -disconnect_network_drive=' +@disconnect_network_drive=' @@ -611,7 +607,7 @@ disconnect_network_drive=' @clipPath ' -map_network_drive=' +@map_network_drive=' @@ -620,62 +616,67 @@ map_network_drive=' ' -make_available_offline=' +@make_available_offline=' - - + + ' -make_available_online=' +@make_available_online=' ' -file_explorer=' +@file_explorer=' ' -file_explorer_options=' +@file_explorer_options=' ' -print=' +@print=' ' -device_manager=' +@device_manager=' ' -disk_management=' +@disk_management=' ' -filter=' +@filter=' ' -window =' +@window =' @svg_window_template ' -code=' +@code=' ' -reddit=' +@reddit=' ' -nvidia=' +@cortana,show_cortana_button=' + + +' + +@nvidia=' ' \ No newline at end of file diff --git a/config/en/imports/modify.nss b/config/en/imports/modify.nss new file mode 100644 index 0000000..277a0dd --- /dev/null +++ b/config/en/imports/modify.nss @@ -0,0 +1,28 @@ +// modify items +// Remove items by identifiers +modify(mode=mode.multiple + where=this.id(id.restore_previous_versions,id.cast_to_device) + vis=vis.remove) + +modify(type="recyclebin" where=window.is_desktop and this.id==id.empty_recycle_bin pos=1 sep) +modify(type="back" find="shortcut" in="/new" vis=vis.remove) + +modify(find="unpin" pos="bottom" menu="Pin/Unpin") +modify(find="pin" pos="top" menu="Pin//Unpin") + +modify(where=this.id==id.copy_as_path menu="file manage") +modify(type="dir.back|drive.back" where=this.id==id.customize_this_folder pos=1 sep="top" menu="file manage") + +modify(where=this.name=="open in terminal" || this.name=="open linux shell here" || this.id==id.open_powershell_window_here + pos="bottom" menu="Terminal") + +modify(find="open with visual studio" pos=1 menu="develop/editors") + +//Move and organize +//modify(mode=mode.multiple find="scan with" menu=title.more_options) + +modify(mode=mode.multiple + where=this.id(id.send_to,id.share,id.create_shortcut,id.set_as_desktop_background,id.rotate_left, + id.rotate_right, id.map_network_drive,id.disconnect_network_drive,id.format, id.eject, + id.give_access_to,id.include_in_library,id.print) + pos=1 menu=title.more_options) diff --git a/config/en/imports/static.nss b/config/en/imports/static.nss deleted file mode 100644 index f2f5b7b..0000000 --- a/config/en/imports/static.nss +++ /dev/null @@ -1,24 +0,0 @@ -shell -{ - // static items - - // Delete items by identifiers - item(mode=mode.multiple - where=this.id(id.restore_previous_versions,id.cast_to_device,id.give_access_to,id.include_in_library,id.print) - vis=vis.remove) - - item(type='recyclebin' where=window.is_desktop and this.id==id.empty_recycle_bin pos=1 sep) - item(type='back' find=['shortcut', '/new'] vis=vis.remove) - item(find='unpin' pos=pos.bottom menu="Pin//Unpin") - item(find='pin' pos=pos.top menu="Pin//Unpin") - item(where=this.id==id.copy_as_path menu='file manage') - item(type='dir.back|drive.back' where=this.id==id.customize_this_folder pos=1 sep='top' menu='file manage') - item(find='"open in terminal"|"Open linux shell here"' pos=pos.bottom sep menu='Terminal') - item(find='open with visual studio' pos=1 menu='develop/editors') - //Move and organize - item(mode=mode.multiple find='scan with' menu=title.more_options) - item(mode=mode.multiple - where=this.id(id.send_to,id.share,id.create_shortcut,id.set_as_desktop_background,id.rotate_left, - id.rotate_right, id.map_network_drive,id.disconnect_network_drive,id.format, id.eject) - pos=1 menu=title.more_options) -} \ No newline at end of file diff --git a/config/en/imports/taskbar.nss b/config/en/imports/taskbar.nss index 3f0d33e..5f14ab0 100644 --- a/config/en/imports/taskbar.nss +++ b/config/en/imports/taskbar.nss @@ -1,21 +1,20 @@ -menu(type="taskbar" vis=key.shift() pos=0 title=app.name image=\uE249) +menu(type="taskbar" vis=key.shift() or key.lbutton() pos=0 title=app.name image=\uE249) { - item(title="config" image=\uE10A cmd=app.cfg) - item(title="manager" image=\uE0F3 admin cmd=app.exe) - item(title="directory" image=\uE0E8 cmd=app.dir) + item(title="config" image=\uE10A cmd='"@app.cfg"') + item(title="manager" image=\uE0F3 admin cmd='"@app.exe"') + item(title="directory" image=\uE0E8 cmd='"@app.dir"') item(title="version\t"+@app.ver vis=label col=1) item(title="docs" image=\uE1C4 cmd='https://nilesoft.org/docs') item(title="donate" image=\uE1A7 cmd='https://nilesoft.org/donate') } - -menu(where=@(isw11 and this.count == 0) type='taskbar' expanded=true) +menu(where=@(this.count == 0) type='taskbar' image=icon.settings expanded=true) { menu(title="Apps" image=\uE254) { item(title='Paint' image=\uE116 cmd='mspaint') item(title='Edge' image cmd='@sys.prog32\Microsoft\Edge\Application\msedge.exe') item(title='Calculator' image=\ue1e7 cmd='calc.exe') - item(title=@str.res('regedit.exe,-16') image cmd='regedit.exe') + item(title=str.res('regedit.exe,-16') image cmd='regedit.exe') } menu(title=title.windows image=\uE1FB) { @@ -26,9 +25,9 @@ menu(where=@(isw11 and this.count == 0) type='taskbar' expanded=true) item(title=title.minimize_all_windows cmd=command.minimize_all_windows) item(title=title.restore_all_windows cmd=command.restore_all_windows) } - item(title=title.task_manager image=icon.task_manager cmd='taskmgr.exe') - item(title=title.taskbar_Settings sep=both image=icon.settings cmd='ms-settings:taskbar') - item(title=title.settings image=icon.settings(auto, @image.color1) cmd='ms-settings:') item(title=title.desktop image=icon.desktop cmd=command.toggle_desktop) - item(vis=@key.shift() title=title.exit_explorer cmd=command.restart_explorer) + item(title=title.settings image=icon.settings(auto, image.color1) cmd='ms-settings:') + item(title=title.task_manager sep=both image=icon.task_manager cmd='taskmgr.exe') + item(title=title.taskbar_Settings sep=both image=inherit cmd='ms-settings:taskbar') + item(vis=key.shift() title=title.exit_explorer cmd=command.restart_explorer) } \ No newline at end of file diff --git a/config/en/imports/terminal.nss b/config/en/imports/terminal.nss index 975d5fa..b7c2623 100644 --- a/config/en/imports/terminal.nss +++ b/config/en/imports/terminal.nss @@ -1,6 +1,9 @@ menu(type='*' where=(sel.count or wnd.is_taskbar or wnd.is_edit) title=title.terminal sep='top' image=icon.run_with_powershell) { - item(title=title.command_prompt admin=key.shift() image cmd='cmd.exe' args='/K TITLE Command Prompt &ver& PUSHD "@sel.dir"') - item(title=title.windows_powershell admin=@key.shift() image cmd='powershell.exe' args="-noexit -command Set-Location -Path '" + @sel.dir + "\\.'") - item(where=sys.ver.major >= 10 title=title.Windows_Terminal admin=key.shift() image='@package.path("WindowsTerminal")\WindowsTerminal.exe' cmd='wt.exe' arg='-d "@sel.path\."') + $tip_run_admin=["\xE1A7 Press SHIFT key to run " + this.title + " as administrator", tip.warning, 1.0] + $has_admin=key.shift() or key.rbutton() + + item(title=title.command_prompt tip=tip_run_admin admin=has_admin image cmd='cmd.exe' args='/K TITLE Command Prompt &ver& PUSHD "@sel.dir"') + item(title=title.windows_powershell admin=has_admin tip=tip_run_admin image cmd='powershell.exe' args='-noexit -command Set-Location -Path "@sel.dir\."') + item(where=package.exists("WindowsTerminal") title=title.Windows_Terminal tip=tip_run_admin admin=has_admin image='@package.path("WindowsTerminal")\WindowsTerminal.exe' cmd='wt.exe' arg='-d "@sel.path\."') } \ No newline at end of file diff --git a/config/en/imports/theme.nss b/config/en/imports/theme.nss new file mode 100644 index 0000000..8f10f3b --- /dev/null +++ b/config/en/imports/theme.nss @@ -0,0 +1,12 @@ +theme +{ + name="modern" + dark=auto + background + { + color=auto + opacity=50 + effect=0 + } + image.align=2 +} \ No newline at end of file diff --git a/config/en/shell.nss b/config/en/shell.nss index 442e82a..d7ec077 100644 --- a/config/en/shell.nss +++ b/config/en/shell.nss @@ -1,51 +1,28 @@ -shell +settings { - var - { - isw11=sys.is11 - } - - set - { - theme - { - name="modern" - background - { - //opacity=95 - effect=0 - } - - image - { - align=2 - } - - item.prefix=auto - } - - exclude.where = !process.is_explorer - showdelay=200 - } - - images import 'imports/images.nss' - - static - { - import 'imports/static.nss' - item(where=this.title.length > 25 menu=title.more_options) - } - - dynamic - { - menu(mode="multiple" title="Pin/Unpin" image=icon.pin) { } - menu(mode="multiple" title=title.more_options image=icon.more_options) { } - - import 'imports/terminal.nss' - import 'imports/file-manage.nss' - import 'imports/develop.nss' - import 'imports/goto.nss' - import 'imports/taskbar.nss' - } + priority=1 + exclude.where = !process.is_explorer + showdelay = 200 + // Options to allow modification of system items + modify.remove.duplicate=1 + tip.enabled=true } +import 'imports/theme.nss' +import 'imports/images.nss' + +import 'imports/modify.nss' + +menu(mode="multiple" title="Pin/Unpin" image=icon.pin) +{ +} + +menu(mode="multiple" title=title.more_options image=icon.more_options) +{ +} + +import 'imports/terminal.nss' +import 'imports/file-manage.nss' +import 'imports/develop.nss' +import 'imports/goto.nss' +import 'imports/taskbar.nss' diff --git a/docs/configuration/index.html b/docs/configuration/index.html new file mode 100644 index 0000000..a30e5d6 --- /dev/null +++ b/docs/configuration/index.html @@ -0,0 +1,202 @@ +

Syntax Rules for Configuration Files

+
+

This chapter describes the syntax rules for the configuration files.

+

The main configuration file shell.nss is located in the installation directory of + Shell, depending on your installation method. +

+ +
General rules
+
    +
  • Syntax is case-insensitive.
  • +
  • Spaces around the equal (=) sign are optional and are ignored.
  • +
  • The properties of modify-items and new-items items are separated + by blank spaces or on a separate line and must be placed in + parentheses ( ). +
  • +
  • Other configuration files can be imported using the import tag. +
  • +
+ +
+ Tip: When there is an error, it is recorded in the log file (shell.log, which is also located in + your installation directory.). +
+ +
shell.nss structure
+

The global section shell{} may have the following subsections:

+ +
Example
+
// variable declaration
+$variable-name = variable-value
+
+//image declaration
+@image-id = image-value
+	
+settings
+{
+	key-name = key-value
+	key-name = [key-value, key-value, ...]
+	...
+}
+
+theme
+{
+	key-name = key-value
+	...
+}
+
+// modify items
+modify ( property-name = property-value   ... )
+remove ( property-name = property-value   ... )
+
+// new items
+
+item ( property-name = property-value   ... )
+
+separator [( property-name = property-value   ... )]
+
+menu ( property-name = property-value   ... )
+{
+	$variable-name = variable-value
+	
+	item ( property-name = property-value   ... )
+	...
+}
+
+ +

Breaking Long Lines

+

For best readability, users often like to avoid lines longer than 80 characters. single + quotes also allow break up a line.

+
item(title='Command prompt'
+	cmd='cmd.exe')
+
+
+ +

Import tag

+

To better organise the configuration file, parts of the configuration can be saved in separate files. These are then + imported using the import tag. With this method, it is also possible to import the same file as a sort of "module" + into different parts of the configuration. A convenient way to include the same sub-menu in different + locations..

+
Syntax
+

The general syntax is as follows:

+
import %path%
+

Where

+
    +
  • %section% is the name of a section. Optional. If given, it must be one + of +
      +
    • settings
    • +
    • themes
    • +
    • modify-items
    • +
    • new-items
    • +
    + The section name is written literally, without any quotes (or the percent signs). +
  • +
  • %path% is a string literal, that returns the path to the + config file that shall be imported. This can be a relative path to the location of the file where the import tag is used, or it can be an absolute path. Expressions are + supported when using single quotes. +
  • +
+ +

There are effectively two different ways this tag is applied, depending on whether the optional + %section% is given:

+
    +
  • Import an entire section
  • +
  • Import as a partial:
  • +
+ +
Import an entire section
+
// import an entire section
+import %path%
+
+In this case, the content of the file found at %path% will be imported into a newly + created section{}. +The result would then look like so: +
// import an entire section
+section {
+	/* content of the imported file goes here! Do not include
+	 *
+	 * section {
+	 * }
+	 *
+	 * in your imported file!
+	 */
+}
+

This syntax may be used only in the following places:

+
    +
  • root section shell{}: shell import %path% +
  • +
  • the global sections +
      +
    • settings{}: import %path%
    • +
    +
  • +
  • + sub-sections of the settings{} section: +
      +
    • theme.background{}: background import + %path%
    • +
    • theme.item{}: item import + %path%
    • +
    • theme.border{}: border import + %path%
    • +
    • ...
    • +
    • settings.tip{}: tip import %path%
    • +
    • settings.exclude{}: exclude import + %path%
    • +
    • settings.modify{}: static import %path% +
    • +
    • settings.new{}: dynamic import + %path%
    • +
    +
  • +
+
Import as a partial
+
section {
+	// some code might go here. Optional.
+
+	// import of a partial section
+	import %path%
+
+	// some more content might go here. Optional.
+}
+In this case, the content of the file found at %path% will be imported into the already + existing section{}. +The result would then look like so: +
section {
+	// some code might go here. Optional.
+
+	// import of a partial section
+	/* content of the imported file goes here! Do not include
+	 *
+	 * section {
+	 * }
+	 *
+	 * in your imported file!
+	 */
+
+	// some more content might go here. Optional.
+}
+

This syntax may be used nearly anywhere:

+
    +
  • in any section
  • +
  • in the body of menu tags +
  • +
diff --git a/docs/configuration/modify-items.html b/docs/configuration/modify-items.html new file mode 100644 index 0000000..f49977b --- /dev/null +++ b/docs/configuration/modify-items.html @@ -0,0 +1,59 @@ +

Modify Items

+
+

The optional modify section contains entries to modify existing context menu items, + added by the system or by a third party.

+ +
Sub-items
+

The section can have the following entry types, all of which are optional:

+
    +
  • One or more item entries. + These contain the instructions on which and how to change existing menuitems. +
  • +
  • One or more imports. The content of the + given file will be placed in the position of the import. +
  • +
+
Example
+

In the following example, two instructions are defined:

+
modify(find = 'copy' image = #00ff00)
+modify(find = 'paste' image = #0000ff)
+remove(find = '"format"')
+
+

Item Entries

+

item entries contain the instructions on how to identify existing menuitems (also referred to as Target), and when and what changes should be applied + to them.

This is done by matching an existing menuitem's title property against the modify item's mandatory find property. If a match is found, the other properties of the modify + item are applied to the appropriate menuitem, such as changing their properties (e.g. title, icon, visibility), or moving them to another location.

+ +
Syntax
+
modify( find = value [property = value [...] ])
+
+
Properties
+

item entries can define three different sets of properties:

+
+
Validation Properties
+
Determine if a given item entry should be processed when a context menu is displayed. Optional. +
+
Filter Properties:
+
Determine if a given menuitem is a valid target + for the process instructions +
    +
  • find (mandatory)
    + Pattern used to identify targets by matching against their title property. +
  • +
+
+
Process Instructions
+
Define what to do with the target. Optional. However, if there are no below. +
+
+

For a complete overview and further details regarding applicable properties, please refer to the properties page.

+

Item Target

+

Item targets are menuitems of an existing context menu. Their properties or location can + be changed by applying the process instructions defined in a modify item.

+
Process instructions
+

Instructions that should be applied to the Target. Basically they consist of properties from the two property + classes menuitem properties and command properties.

+

Once a item is validated and a target identified, then these values are applied to the targeted + menuitem.

diff --git a/docs/configuration/new-items.html b/docs/configuration/new-items.html new file mode 100644 index 0000000..350cf5e --- /dev/null +++ b/docs/configuration/new-items.html @@ -0,0 +1,105 @@ +

New Items

+
+

Add new items to the context menu.

+
Sub-items
+

The section can have the following entry types, all of which are optional:

+
    +
  • Menuitems, i.e. one or more of the following: +
      +
    • One or more item entries. + These appear as top-level items in a context menu. +
    • +
    • One or more menu entries. + These appear as top-level sub-menus in a context menu. +
    • +
    • One or more separator entries. These create a + horizontal line between the given entries. +
    • +
    +
  • +
  • One or more imports. The content of the given file will be placed in the + position of the import. +
  • +
+ +
Example
+

In the following example, one top-level item is created, that is + separated with a horizontal line from an adjacent sub-menu, which in turn has one sub-item + on its own:

+
item(title = 'Hello, World!')
+separator
+menu(title = 'sub menu' image = #0000ff)
+{
+	item(title = 'test sub-item')
+}
+
+ + + +

menuitem is an umbrella term for those entry types, that may appear in a + menu. These simply include the following:

+ + +
+

Items

+

items create a single menu entry.

+ +
Properties
+

Either a title or a image property is mandatory (set to a non-null value). For further details, + please refer to the properties page.

+ +
Syntax
+
item( title = value [property = value [...] ])
+
+ + + +

menu entries create a new sub-menu. They have properties + and sub-entries.

+ + +

Either a title or a image property is mandatory (set to a non-null value). For further details, + please refer to the properties page.

+ + +

menus can have the following entry types, all of which are + optional:

+
    +
  • Menuitems, i.e. one or more of the following: + +
  • +
  • One or more imports. The content of the + given file will be placed in the position of the import. +
  • +
+ + +
menu( title = value [property = value [...] ])
+{
+	[ item() [...] ]
+	[ menu(){} [...] ]
+	[ separator [...] ]
+	[ import 'path/to/import.nss' [...] ]
+}
+
+ +

Separators

+ +

separators create a horizontal line.

+ +
Properties
+

separators do not have any mandatory properties. Please refer to the properties page for further details.

+ +
Syntax
+
separator
+separator( property = value [property = value [...] ])
diff --git a/docs/syntax/properties.html b/docs/configuration/properties.html similarity index 62% rename from docs/syntax/properties.html rename to docs/configuration/properties.html index c3ce195..32a7e80 100644 --- a/docs/syntax/properties.html +++ b/docs/configuration/properties.html @@ -1,5 +1,4 @@

Properties

- - Shell supports the following properties classes: -

Please also see the full index of available properties below.

-
Index
-
    +

    Syntax

    -
    Entry types
    -

    In the following tables, the Types column shows to which entry types the +

    In the following tables, the Types column shows to which entry types the property applies to.

    The following abbreviations are used (if set in bold, then the property is mandatory for the given type):

    -
    se
    -
    static entry, i.e. the +
    mi
    +
    modify item, i.e. the item entry itself. Is basically required to evaluate if the process instructions are applied to any given target.
    -
    st
    -
    static target, i.e. +
    mt
    +
    modify target, i.e. the menuitem of the existing menu to which the process instructions are applied
    -
    dm
    -
    dynamic menu
    -
    di
    -
    dynamic item
    -
    ds
    -
    dynamic separator. +
    nm
    +
    new menu type
    +
    ni
    +
    new item type
    +
    ns
    +
    new separator type.
    -
    Validation Properties
    -

    Determine if a given static - or dynamic entry should be +

    Determine if a given Modify items + or New items entry should be processed when a context menu is displayed.

    +
    - +
    +
    Syntax
    @@ -187,27 +182,20 @@ Shell supports the following properties classes: - - + - - + -
    Wheresi, dm, di, dsmi, nm, ni, ns Process given menuitem if true is returned. Allows the evaluation of arbitrary - expressions, e.g. if().
    + expressions, e.g. if().
    Default = true
    Modesi, dm, di, dsmi, nm, ni, ns Display menuitem by type of selection. The value has one of the following parameters - (of type string): + (of type string): @@ -219,8 +207,7 @@ Shell supports the following properties classes: - @@ -238,8 +225,7 @@ Shell supports the following properties classes: - + - + - - + - -
    none
    multi_uniqueDisplay menuitem when multiple objects of the same type are selected. + Display menuitem when multiple objects of the same type are selected.
    Typesi, dm, di, dsmi, nm, ni, ns Specifies the types of objects for which the menuitem will be displayed.
    Possible values are shown below. Separate multiple types with the pipe character (|), in @@ -323,50 +309,42 @@ Shell supports the following properties classes:
    DesktopDisplay menuitem when the Desktop is selected.Display menuitem when the Desktop is selected.
    NamespaceDisplay menuitem when Namespaces are selected. Can be virtual objects such as My Network Places and Recycle Bin. + Display menuitem when Namespaces are selected. Can be virtual objects such as My Network Places and Recycle Bin.
    ComputerDisplay menuitem when My Computer is selected.Display menuitem when My Computer is selected.
    RecyclebinDisplay menuitem when the Recycle bin is selected. + Display menuitem when the Recycle bin is selected.
    TaskbarDisplay menuitem when the Taskbar is selected. + Display menuitem when the Taskbar is selected.
    - Default = Accepts all types, except for the Taskbar. + Default = Accepts all types, except for the Taskbar.
    -
    Filter Properties
    -

    For static entries only, - filter properties determine if a given menuitem is a valid target for the process instructions

    +

    For Modify items entries only, + filter properties determine if a given menuitem is a valid target for the process instructions

    @@ -383,19 +361,16 @@ Shell supports the following properties classes: Find - dm, di, ds + nm, ni, ns
    -
    For static items (required)
    -
    Apply the current item's process instructions to any existing menuitem if their title property matches the +
    For modify items (required)
    +
    Apply the current item's process instructions to any existing menuitem if their title property matches the pattern of the current item's find property.
    For dynamic items (optional)

    Display the current menuitem if the pattern of its find property matches the - path name or path extension + path name or path extension of the selected files.

    Default = null, which means any string is "matched".

    @@ -405,9 +380,9 @@ Shell supports the following properties classes:
    find = '%pattern%'
     find = '%pattern%|%pattern%[...]'
    -

    where %pattern% can be one or +

    where %pattern% can be one or more - matching instructions (see Examples below). The + matching instructions (see Examples below). The following characters do have special meaning:

    • | Use to separate patterns. If any one pattern @@ -423,14 +398,12 @@ find = '%pattern%|%pattern%[...]'
    • ! Negates the match of the current pattern, or limits - the wildcard (*) to one word only. + the wildcard (*) to one word only.
    • -
    • "" the enclosed string is treated as a word. +
    • "" the enclosed string is treated as a word.
    -

    A word is a sequence of +

    A word is a sequence of alphanumerical characters that is confined to the left and to the right by either a space , a non-word character (e.g. / or -), or the @@ -456,9 +429,7 @@ find = '%pattern%|%pattern%[...]' '"foo"' - contains the literal string foo as a whole word + contains the literal string foo as a whole word only. foo, foo/bar, some foo bar @@ -490,21 +461,21 @@ find = '%pattern%|%pattern%[...]' '!"foo"' - does not contain the word + does not contain the word foo fobar, kung fu bar, foobar foo, kung foo bar, bar/foo/bar '!*foo' - does not contain a word ending on + does not contain a word ending on foo foobar, fooo-fo foo, foo bar, bar/foo 'foo*!' - does not contain a word stharting + does not contain a word stharting wit foo myFooBar, barFoo @@ -569,35 +540,31 @@ find = '%pattern%|%pattern%[...]'

    -
    Menuitem Properties
    -

    This set of properties describe the appearance and location of a given menuitem. For static entries, this is - the - target menuitem. For dynamic entries, this is the newly created menuitem.

    - +

    This set of properties describe the appearance and location of a given menuitem. For modify-items, this is the target menuitem. For dynamic entries, this is the newly created menuitem.

    Appearance
    Location
    @@ -614,34 +581,25 @@ find = '%pattern%|%pattern%[...]' - Title - st, dm, di + st, nm, ni

    Sets the caption of the menuitem.

    -
    For static items (optional)
    +
    For modify-items (optional)

    Default = null, which means the title of the target is not changed.

    For dynamic items (required)
    -

    It is mandatory for menu and item entries, unless a image property is defined.

    +

    It is mandatory for menu and item entries, unless a image property is defined.

    - Visibility (vis) - st, dm, di, ds + st, nm, ni, ns Sets the visibility of a menuitem. Can have one of the following parameters: @@ -658,25 +616,22 @@ find = '%pattern%|%pattern%[...]' - +
    StaticDisplay menuitem as label, with or without an imageDisplay menuitem as label, with or without an image
    Label Display menuitem as label without an image
    -
    - Note:The values Static and Label are not available for static targets. +
    + Note: The values Static and Label are not available for modify-items.
    Default = Normal Separator (sep) - st, dm, di + st, nm, ni Add a separator to the menuitem: @@ -702,10 +657,8 @@ find = '%pattern%|%pattern%[...]' - - + - - - + - - + - + - - + - + - - + - - + - - + @@ -976,9 +899,8 @@ tip = ["Lorem Ipsum is simply dummy text.", tip.info, 1.2] - - +
    Position (pos)st, dm, di, dsThe position at which a menuitem should be inserted into the menu.
    +
    st, nm, ni, nsThe position at which a menuitem should be inserted into the menu.
    Position can have one of the following parameters: @@ -714,20 +667,17 @@ find = '%pattern%|%pattern%[...]' - - - @@ -741,8 +691,7 @@ find = '%pattern%|%pattern%[...]' - + @@ -774,26 +723,22 @@ find = '%pattern%|%pattern%[...]'
    MiddleInsert the menuitem to the middle of the menu. + Insert the menuitem to the middle of the menu.
    TopInsert the menuitem to the top of the menu. + Insert the menuitem to the top of the menu.
    BottomInsert the menuitem to the bottom of the menu. + Insert the menuitem to the bottom of the menu.
    Image, Iconst, dm, dist, nm, ni The icon that appears in a menuitem. This property can be assigned as image files, resource icons, glyph or color. With one of the following parameters @@ -754,7 +703,7 @@ find = '%pattern%|%pattern%[...]'
    Inherit @*Inheriting the image from the parent.*@ - Inherits this property from its parent element. + Inherits this property from its parent item.
    Assign image from location path or resource icon.
    -
    - Note:The value Cmd is not available for static +
    + Note:The value Cmd is not available for modify-items targets.
    Default = null
    Parent, Menust, dm, di, ds

    Move current menuitem to another menu.

    +
    st, nm, ni, ns

    Move current menuitem to another menu.

    Default = null
    Checkedst, dist, ni Type of select option: @@ -812,78 +757,63 @@ find = '%pattern%|%pattern%[...]' Default = 0 - - + - - + - - + - - + - - +
    Defaultst, dist, ni -

    Specifies that the item is the default. A menu can contain only one default +

    Specifies that the item is the default. A menu can contain only one default menuitem, which is displayed in bold.

    Default = false
    Expandeddmnm -

    Move all immediate menuitems to the parent menu.

    +

    Move all immediate menuitems to the parent menu.

    Default = false
    Column(col)dm, dinm, ni

    Create a new column.

    Default = true
    Keysst, dm, dist, nm, ni

    Show keyboard shortcuts.

    Default = null
    Tipst, dm, dist, nm, ni -

    Show a tooltip for the current menuor item.

    +

    Show a tooltip for the current menuor item.

    Default = null
    Syntax
    -
    
    -tip = "Lorem Ipsum is simply dummy text."
    +				
    tip = "Lorem Ipsum is simply dummy text."
     tip = ["Lorem Ipsum is simply dummy text.", tip.info]
    -tip = ["Lorem Ipsum is simply dummy text.", tip.info, 1.2]
    -
    +tip = ["Lorem Ipsum is simply dummy text.", tip.info, 1.2]
    -
    Command Properties

    This set of properties describe how a command is executed. Only available for dynamic items.

    @@ -900,7 +830,7 @@ tip = ["Lorem Ipsum is simply dummy text.", tip.info, 1.2]
    Command (cmd)dini

    The command associated with the menuitem. Occurs when the menuitem is clicked or selected using a shortcut key or access key defined for the menuitem.

    Default = null @@ -909,33 +839,27 @@ tip = ["Lorem Ipsum is simply dummy text.", tip.info, 1.2]
    Arguments (arg, args)di

    The command line parameters to pass to the command property of a menuitem.

    +
    ni

    The command line parameters to pass to the command property of a menuitem.

    Default = null
    Invokedini Set execution type - -
    0, singleexecute the command only once in total. The list of selected - items can be accessed with '@sel' + execute the command only once in total. The list of selected + items can be accessed with @sel
    1, multipleexecute the command once for every single item in the current - selection. The currently processed item can be accessed with e.g '@sel.path.quote' + execute the command once for every single item in the current + selection. The currently processed item can be accessed with e.g @sel.path.quote
    @@ -945,9 +869,8 @@ tip = ["Lorem Ipsum is simply dummy text.", tip.info, 1.2]
    WindowdiControls how the window of the executed command is to be shown. Can be one of the following + niControls how the window of the executed command is to be shown. Can be one of the following parameters:

    Hidden, Show, Visible, Minimized, Maximized

    @@ -957,18 +880,18 @@ tip = ["Lorem Ipsum is simply dummy text.", tip.info, 1.2]
    Directory (dir)di

    Specifies the working directory to +

    ni

    Specifies the working directory to execute - the command in.

    + the command in.

    Default = null
    Admindi

    Execute the command +

    ni

    Execute the command with administrative permissions.

    Default = false
    VerbdiSpecifies the default operation for the selected file. Value type string + niSpecifies the default operation for the selected file. Value type string and can have one of the following parameters:
    @@ -1021,17 +943,15 @@ tip = ["Lorem Ipsum is simply dummy text.", tip.info, 1.2] Default = open - - + -
    Waitdini -

    Wait for the command +

    Wait for the command to complete.

    Default = false
    diff --git a/docs/configuration/settings.html b/docs/configuration/settings.html new file mode 100644 index 0000000..cf76ec4 --- /dev/null +++ b/docs/configuration/settings.html @@ -0,0 +1,87 @@ +

    Settings

    +

    +

    Settings are containers for storing default values.

    +
    settings
    +{
    +	// show menu delay value from 0 to 4000
    +	showdelay = 200
    +
    +	// Prevent interaction with these windows or processes
    +	exclude
    +	{
    +		where = boolean value
    +		window = window name
    +		process = process name
    +	}
    +
    +	tip = true
    +	// or
    +	tip
    +	{
    +		enabled = true
    +
    +		// normal = [background, text]
    +		normal = [default, default]
    +
    +		// normal = [background, text]
    +		primary = [#000, #fff]
    +
    +		// info = [background, text]
    +		info = [#88f, #fff]
    +
    +		// success = [background, text]
    +		success = [#8f8, #fff]
    +
    +		// warning = [background, text]
    +		warning = [#ff8, #fff]
    +
    +		// danger = [background, text]
    +		danger = [#f88, #fff]
    +
    +		// max width value from 200 to 2000
    +		width = 400
    +
    +		// opacity value from 0 to 100
    +		opacity = 100
    +
    +		// radius size value from 0 to 3
    +		radius = 1
    +
    +		time = 1.5
    +
    +		padding = [8, 4]
    +	}
    +
    +	// Disable/Enable modify items processing
    +	modify
    +	{
    +		enabled = boolean value
    +		image = [0 = disable, 1 = enable, 2 = auto reimage]
    +
    +		// Allow/disallow modification of title
    +		title = boolean value
    +
    +		// Allow/disallow modification of visibility
    +		visibility = boolean value
    +
    +		// Allow/disallow modification of parent
    +		parent = boolean value
    +
    +		// Allow/disallow modification of position
    +		position = boolean value
    +
    +		// Allow/disallow to add separator
    +		separator = boolean value
    +
    +		// auto set image and group
    +		auto = boolean value
    +	}
    +
    +	// Disable/Enable new items processing
    +	new
    +	{
    +		enabled = boolean value
    +		// disable/enable image
    +		image = boolean value
    +	}
    +}
    diff --git a/docs/configuration/themes.html b/docs/configuration/themes.html new file mode 100644 index 0000000..c237278 --- /dev/null +++ b/docs/configuration/themes.html @@ -0,0 +1,216 @@ +

    Themes

    +

    +

    Theme section to customize the layout and colors of the context menu.

    +
    theme
    +{
    +	// theme.name = auto, classic, white, black, or modern
    +	name = "modern"
    +
    +	// view = auto, compact, small, medium, large, wide
    +	view = view.compact
    +
    +	dark = true or false
    +
    +	background
    +	{
    +		color = color value
    +		opacity = value from 0 to 100
    +
    +		// effect value 0 = disable, 1 = transparent, 2 = blur, 3 = acrylic
    +		effect = auto
    +
    +		// for acrylic
    +		effect = [3, tint color, opacity]
    +
    +		gradient
    +		{
    +			enabled = boolean value
    +
    +			// linear = [x1, x2, y1, y2]
    +			linear = [0, 100, 0, 0]
    +
    +			// or radial = [cx, cy, r, fx, fy]
    +			radial =[ 100, 100, 150, 100, 100]
    +
    +			// stop = [offset, stop-color]
    +			stop = [0.5, color.accent, 20]
    +
    +			// or add more stop
    +			stop = [
    +				[offset, stop-color],
    +				[offset, stop-color],
    +				[offset, stop-color]
    +			]
    +		}
    +	}
    +
    +	item
    +	{
    +		opacity = value from 0 to 100
    +		radius = value from 0 to 3
    +
    +		// prefix value [auto, 0 = dont display,  1 = display, 2 = ignore]
    +		prefix = 1
    +
    +		text
    +		{
    +			normal = color
    +			normal.disabled = color
    +			select = color
    +			select.disabled = color
    +		}
    +
    +		back
    +		{
    +			normal = color
    +			normal.disabled = color
    +			select = color
    +			select.disabled = color
    +		}
    +
    +		border
    +		{
    +			normal = color
    +			normal.disabled = color
    +			select = color
    +			select.disabled = color
    +		}
    +
    +		padding
    +		{
    +			left = value
    +			top = value
    +			right = value
    +			bottom = value
    +		}
    +
    +		margin
    +		{
    +			left = value
    +			top = value
    +			right = value
    +			bottom = value
    +		}
    +	}
    +
    +	border
    +	{
    +		enabled = boolean value
    +		size = value from 0 to 10
    +		color =  = value
    +		opacity = value
    +		radius = value
    +
    +		padding
    +		{
    +			left = value
    +			top = value
    +			right = value
    +			bottom = value
    +		}
    +	}
    +
    +	shadow
    +	{
    +		enabled = boolean value
    +		size = value from 0 to 30
    +		color = value
    +		opacity = value from 0 to 100
    +		offset = value from 0 to 30
    +	}
    +
    +	font
    +	{
    +		size = value start from 6
    +		name = "tahoma"
    +		weight = value from 1 to 9
    +		italic = 0
    +	}
    +
    +	separator
    +	{
    +		size = value form 0 to 40
    +		color = value
    +		opacity = value
    +
    +		margin
    +		{
    +			left = value
    +			top = value
    +			right = value
    +			bottom = value
    +		}
    +	}
    +
    +	symbol
    +	{
    +		normal = color
    +		normal.disabled = color
    +		select = color
    +		select.disabled = color
    +
    +		// or
    +		chevron
    +		{
    +			normal = color
    +			normal.disabled = color
    +			select = color
    +			select.disabled = color
    +		}
    +
    +		checkmark
    +		{
    +			normal = color
    +			normal.disabled = color
    +			select = color
    +			select.disabled = color
    +		}
    +
    +		bullet
    +		{
    +			normal = color
    +			normal.disabled = color
    +			select = color
    +			select.disabled = color
    +		}
    +	}
    +
    +	image
    +	{
    +		enabled = boolean value
    +
    +		color = [color1, color2, color3]
    +		gap = value
    +		glyph = "font name" // font name for default glyph
    +		scale = boolean value
    +		align = value [0 = Display only the check mark, 1 = 0 = Display only the image,2 = Display the image and check mark together]
    +	}
    +
    +	layout
    +	{
    +		// Right-to-left layout display for Middle Eastern languages
    +		rtl = boolean value
    +
    +		// Align submenus
    +		popup = value from -20 to 20
    +	}
    +}
    +

    Padding and Margin value syntax

    +

    Use the padding shorthand property with four values:

    +padding = [1, 2, 3, 4] +
    left = 1
    +right = 2
    +top = 3
    +bottom = 4
    +

    Use the padding shorthand property with two values:

    +padding = [4, 2] +
    left = 4
    +right = 4
    +top = 2
    +bottom = 2
    +

    Use the padding shorthand property with one value:

    +padding = 4 +
    left = 4
    +right = 4
    +top = 4
    +bottom = 4
    diff --git a/docs/examples/copy-path.html b/docs/examples/copy-path.html index 97c87dc..5ab4ac1 100644 --- a/docs/examples/copy-path.html +++ b/docs/examples/copy-path.html @@ -1,47 +1,32 @@ 
    Copy Path example
    -
    shell 
    +
    // type can set with '~taskbar' equals all file types except taskbar.
    +menu(type='file|dir|back|root|namespace' mode="multiple"  title='copy to clipboard' image=#ff00ff)
     {
    -    dynamic
    -    {
    -        // type can set with '~taskbar' equals all file types except taskbar.
    -        menu(type='file|dir|back|root|namespace' mode="multiple"  title='copy to clipboard' image=#ff00ff)
    -        {
    -            // Appears only when multiple selections.
    -            item(vis=@(sel.count > 1) title='Copy path (@sel.count) items selected'
    -                    cmd=command.copy(sel(false, "\n")))
    +	// Appears only when multiple selections.
    +	item(vis=@(sel.count > 1) title='Copy path (@sel.count) items selected'
    +			cmd=command.copy(sel(false, "\n")))
     
    -            item(mode="single" title=sel.path 
    -                    cmd=command.copy(sel.path))
    +	item(mode="single" title=sel.path 
    +			cmd=command.copy(sel.path))
     
    -            item(mode="single" type='file|dir|back.dir'
    -                    vis=sel.short.len!=sel.path.len title=sel.short
    -                    cmd=command.copy(sel.short))
    -            separator
    -            item(mode="single" vis=@(sel.parent.len>3) title=sel.parent 
    -                    cmd=command.copy(sel.parent))
    -            separator
    -            item(mode="single" type='file|dir|back.dir' title=sel.file.name
    -                    cmd=command.copy(sel.file.name))
    -                   
    -            item(mode="single" type='file' title=sel.file.title
    -                    cmd=command.copy(sel.file.title))
    +	item(mode="single" type='file|dir|back.dir'
    +			vis=sel.short.len!=sel.path.len title=sel.short
    +			cmd=command.copy(sel.short))
    +	separator
    +	item(mode="single" vis=@(sel.parent.len>3) title=sel.parent 
    +			cmd=command.copy(sel.parent))
    +	separator
    +	item(mode="single" type='file|dir|back.dir' title=sel.file.name
    +			cmd=command.copy(sel.file.name))
    +		   
    +	item(mode="single" type='file' title=sel.file.title
    +			cmd=command.copy(sel.file.title))
     
    -            item(mode="single" type='file' title=sel.file.ext
    -                   cmd=command.copy(sel.file.ext))
    -        }
    -    }
    -}
    - -
    - - - - - - - - - - - + item(mode="single" type='file' title=sel.file.ext + cmd=command.copy(sel.file.ext)) +} +
    + + +
    diff --git a/docs/examples/favorites.html b/docs/examples/favorites.html index 2c1b3f3..e2e9f1c 100644 --- a/docs/examples/favorites.html +++ b/docs/examples/favorites.html @@ -1,37 +1,27 @@ 
    Favorite applications and directories example
    -
    shell 
    +
    menu(type='desktop|taskbar' title='Favorites' image=#00ff00)
     {
    -    dynamic
    -    {
    -        menu(type='desktop|taskbar' title='Favorites' image=#00ff00)
    -        {
    -            menu(title='Applications' image=#ff0000)
    -            {
    -                item(title='Command prompt' image cmd='cmd.exe')
    -                item(title='PowerShell' image cmd='powershell.exe')
    -                item(title='Registry editor' image cmd='regedit.exe')
    -                separator
    -                item(title='Paint' image cmd='mspaint.exe')
    -                item(title='Notepad' image cmd='notepad.exe')
    -            }
    -            separator
    -            menu(title='Directories' image=#0000ff)
    -            {
    -                item(title='Downloads' cmd=user.downloads)
    -                item(title='Pictures' cmd=user.pictures)
    -                item(title='Home' cmd=user.directory)
    -                separator
    -                item(title='Windows' cmd=sys.directory)
    -                item(title='Program files' cmd=sys.prog())
    -            }
    -        }
    -    }
    +	menu(title='Applications' image=#ff0000)
    +	{
    +		item(title='Command prompt' image cmd='cmd.exe')
    +		item(title='PowerShell' image cmd='powershell.exe')
    +		item(title='Registry editor' image cmd='regedit.exe')
    +		separator
    +		item(title='Paint' image cmd='mspaint.exe')
    +		item(title='Notepad' image cmd='notepad.exe')
    +	}
    +	separator
    +	menu(title='Directories' image=#0000ff)
    +	{
    +		item(title='Downloads' cmd=user.downloads)
    +		item(title='Pictures' cmd=user.pictures)
    +		item(title='Home' cmd=user.directory)
    +		separator
    +		item(title='Windows' cmd=sys.directory)
    +		item(title='Program files' cmd=sys.prog())
    +	}
     }
    -
    - - - - - - +
    + +
    diff --git a/docs/examples/goto.html b/docs/examples/goto.html index fd794f8..095bb74 100644 --- a/docs/examples/goto.html +++ b/docs/examples/goto.html @@ -1,62 +1,53 @@ 
    Goto example
    -
    shell
    +
    menu(mode="multiple" title='Goto' sep="both" image= \uE14A)
     {
    -    dynamic
    -    {
    -		menu(mode="multiple" title='Goto' sep="both" image= \uE14A)
    -        {
    -			menu(title='Folder' image=\uE1F4)
    -			{
    -				item(title='Windows' image=inherit cmd=sys.dir)
    -				item(title='System' image=inherit cmd=sys.bin)
    -				item(title='Program Files' image=inherit cmd=sys.prog)
    -				item(title='Program Files x86' image=inherit cmd=sys.prog32)
    -				item(title='ProgramData' image=inherit cmd=sys.programdata)
    -				item(title='Applications' image=inherit cmd='shell:appsfolder')
    -				item(title='Users' image=inherit cmd=sys.users)
    -				separator
    -				item(title='Desktop' image=inherit cmd=user.desktop)
    -				item(title='Downloads' image=inherit cmd=user.downloads)
    -				item(title='Pictures' image=inherit cmd=user.pictures)
    -				item(title='Documents' image=inherit cmd=user.documents)
    -				item(title='Startmenu' image=inherit cmd=user.startmenu)
    -				item(title='Profile' image=inherit cmd=user.dir)
    -				item(title='AppData' image=inherit cmd=user.appdata)
    -				item(title='Temp' image=inherit cmd=user.temp)
    -			}
    -            
    -            item(title=title.control_panel image=\uE0F3 cmd='shell:::{5399E694-6CE5-4D6C-8FCE-1D8870FDCBA0}')
    -            item(title='All Control Panel Items' image=\uE0F3 cmd='shell:::{ED7BA470-8E54-465E-825C-99712043E01C}')
    -            item(title=title.run image=\uE14B cmd='shell:::{2559a1f3-21d7-11d4-bdaf-00c04f60b9f0}')
    -           
    -            menu(title=title.settings sep="before" image=id.settings.icon)
    -            {
    -                // https://docs.microsoft.com/en-us/windows/uwp/launch-resume/launch-settings-app
    -                item(title='systeminfo' image=inherit cmd arg='/K systeminfo')
    -                item(title='search' cmd='search-ms:' image=inherit)
    -                item(title='settings' image=inherit cmd='ms-settings:')
    -                item(title='about' image=inherit cmd='ms-settings:about')
    -                item(title='usb' image=inherit cmd='ms-settings:usb')
    -                item(title='network-status' image=inherit cmd='ms-settings:network-status')
    -                item(title='network-ethernet' image=inherit cmd='ms-settings:network-ethernet')
    -                item(title='personalization-background' image=inherit cmd='ms-settings:personalization-background')
    -                item(title='personalization-colors' image=inherit cmd='ms-settings:colors')
    -                item(title='lockscreen' image=\uE0F3 cmd='ms-settings:lockscreen')
    -                item(title='personalization-start' image=inherit cmd='ms-settings:personalization-start')
    -                item(title='appsfeatures' image=inherit cmd='ms-settings:appsfeatures')
    -                item(title='optionalfeatures' image=inherit cmd='ms-settings:optionalfeatures')
    -                item(title='defaultapps' image=inherit cmd='ms-settings:defaultapps')
    -                item(title='yourinfo' image=inherit cmd='ms-settings:yourinfo')
    -                item(title='windowsupdate' image=inherit cmd='ms-settings:windowsupdate')
    -                item(title='windowsdefender' image=inherit cmd='ms-settings:windowsdefender')
    -                item(title='network connections' image=inherit cmd='shell:::{7007ACC7-3202-11D1-AAD2-00805FC1270E}')
    -            }
    -        }
    -    }
    +	menu(title='Folder' image=\uE1F4)
    +	{
    +		item(title='Windows' image=inherit cmd=sys.dir)
    +		item(title='System' image=inherit cmd=sys.bin)
    +		item(title='Program Files' image=inherit cmd=sys.prog)
    +		item(title='Program Files x86' image=inherit cmd=sys.prog32)
    +		item(title='ProgramData' image=inherit cmd=sys.programdata)
    +		item(title='Applications' image=inherit cmd='shell:appsfolder')
    +		item(title='Users' image=inherit cmd=sys.users)
    +		separator
    +		item(title='Desktop' image=inherit cmd=user.desktop)
    +		item(title='Downloads' image=inherit cmd=user.downloads)
    +		item(title='Pictures' image=inherit cmd=user.pictures)
    +		item(title='Documents' image=inherit cmd=user.documents)
    +		item(title='Startmenu' image=inherit cmd=user.startmenu)
    +		item(title='Profile' image=inherit cmd=user.dir)
    +		item(title='AppData' image=inherit cmd=user.appdata)
    +		item(title='Temp' image=inherit cmd=user.temp)
    +	}
    +	
    +	item(title=title.control_panel image=\uE0F3 cmd='shell:::{5399E694-6CE5-4D6C-8FCE-1D8870FDCBA0}')
    +	item(title='All Control Panel Items' image=\uE0F3 cmd='shell:::{ED7BA470-8E54-465E-825C-99712043E01C}')
    +	item(title=title.run image=\uE14B cmd='shell:::{2559a1f3-21d7-11d4-bdaf-00c04f60b9f0}')
    +   
    +	menu(title=title.settings sep="before" image=id.settings.icon)
    +	{
    +		// https://docs.microsoft.com/en-us/windows/uwp/launch-resume/launch-settings-app
    +		item(title='systeminfo' image=inherit cmd arg='/K systeminfo')
    +		item(title='search' cmd='search-ms:' image=inherit)
    +		item(title='settings' image=inherit cmd='ms-settings:')
    +		item(title='about' image=inherit cmd='ms-settings:about')
    +		item(title='usb' image=inherit cmd='ms-settings:usb')
    +		item(title='network-status' image=inherit cmd='ms-settings:network-status')
    +		item(title='network-ethernet' image=inherit cmd='ms-settings:network-ethernet')
    +		item(title='personalization-background' image=inherit cmd='ms-settings:personalization-background')
    +		item(title='personalization-colors' image=inherit cmd='ms-settings:colors')
    +		item(title='lockscreen' image=\uE0F3 cmd='ms-settings:lockscreen')
    +		item(title='personalization-start' image=inherit cmd='ms-settings:personalization-start')
    +		item(title='appsfeatures' image=inherit cmd='ms-settings:appsfeatures')
    +		item(title='optionalfeatures' image=inherit cmd='ms-settings:optionalfeatures')
    +		item(title='defaultapps' image=inherit cmd='ms-settings:defaultapps')
    +		item(title='yourinfo' image=inherit cmd='ms-settings:yourinfo')
    +		item(title='windowsupdate' image=inherit cmd='ms-settings:windowsupdate')
    +		item(title='windowsdefender' image=inherit cmd='ms-settings:windowsdefender')
    +		item(title='network connections' image=inherit cmd='shell:::{7007ACC7-3202-11D1-AAD2-00805FC1270E}')
    +	}
     }
    -
    - - - +
    diff --git a/docs/examples/taskbar.html b/docs/examples/taskbar.html index 397c1b6..74a3671 100644 --- a/docs/examples/taskbar.html +++ b/docs/examples/taskbar.html @@ -1,22 +1,13 @@ 
    Taskbar example
    -
    shell 
    -{
    -    var
    -    {
    -        hello_world = 'Hello World!'
    -    }
    +
    $hello_world = 'Hello World!'
     
    -    dynamic
    -    {
    -	  item(title=hello_world cmd=msg(hello_world))
    -	  separator
    -	  item(title='Command prompt' cmd args='/k echo @hello_world')
    -	  separator
    -	  menu(title='Sub menu')
    -	  {
    -	      item(title='Open Paint' cmd='paint.exe' arg=sel.path)
    -	      separator
    -	      item(title='Open Notepad' cmd='notepad.exe' arg='"@sel.path"')
    -	  }
    -    }
    +item(title=hello_world cmd=msg(hello_world))
    +separator
    +item(title='Command prompt' cmd args='/k echo @hello_world')
    +separator
    +menu(title='Sub menu')
    +{
    +  item(title='Open Paint' cmd='paint.exe' arg=sel.path)
    +  separator
    +  item(title='Open Notepad' cmd='notepad.exe' arg='"@sel.path"')
     }
    \ No newline at end of file diff --git a/docs/expressions/color.html b/docs/expressions/color.html index f5acc58..4d18b77 100644 --- a/docs/expressions/color.html +++ b/docs/expressions/color.html @@ -1,4 +1,5 @@ 

    Color literal


    Hexadecimal Colors
    -

    interprets color constants as hexadecimal if they are preceded by # and hexadecimal color is specified with: #RRGGBB, where the RR (red), GG (green) and BB (blue) hexadecimal integers specify the components of the color. All values must be between 00 and FF.
    For example, the #0000FF value is rendered as blue, because the blue component is set to its highest value (FF) and the others are set to 00.
    There are 140 color names are predefined under the color scope.

    \ No newline at end of file +

    interprets color constants as hexadecimal if they are preceded by # and hexadecimal color is specified with: +#RRGGBB or #RRGGBBAA, where the RR (red), GG (green) and BB (blue)and AA (alpha) hexadecimal integers specify the components of the color. All values must be between 00 and FF.
    For example, the #0000FF value is rendered as blue, because the blue component is set to its highest value (FF) and the others are set to 00.
    There are 140 color names are predefined under the color scope.

    \ No newline at end of file diff --git a/docs/expressions/comments.html b/docs/expressions/comments.html index 75ea5e0..bc3d1b3 100644 --- a/docs/expressions/comments.html +++ b/docs/expressions/comments.html @@ -7,24 +7,18 @@ Any text between // and the end of the line is ignored (will not be executed).

    This example uses a single-line comment before a line of code:

    -
    shell
    +	
    dynamic 
     {
    -    dynamic 
    -    {
    -        // This is a comment
    -        item(title='Hello World!')
    -        
    -        //item(title='Hello World!')
    -    }
    +	// This is a comment
    +	item(title='Hello World!')
    +	
    +	//item(title='Hello World!')
     }

    This example uses a single-line comment at the end of a line of code:

    -
    shell
    +	
    dynamic 
     {
    -    dynamic 
    -    {
    -        item(title='Hello World!') // This is a comment
    -    }
    +    item(title='Hello World!') // This is a comment
     }

    @@ -34,18 +28,14 @@ Multi-line comments start with /* and ends with */.
    Any text between /* and */ will be ignored.

    -
    shell
    +
    dynamic
     {
    -    dynamic
    -    {
    -        item(title='Hello,/* multiple-lines comment inside */ world')
    -        
    -        /*
    -        item(title='test item 1')
    -        item(title='test item 2')
    -        */
    -    }
    -
    +	item(title='Hello,/* multiple-lines comment inside */ world')
    +	
    +	/*
    +	item(title='test item 1')
    +	item(title='test item 2')
    +	*/
     }

    Single or multi-line comments?
    diff --git a/docs/expressions/operators.html b/docs/expressions/operators.html index 9355619..8f613a8 100644 --- a/docs/expressions/operators.html +++ b/docs/expressions/operators.html @@ -40,7 +40,7 @@ - + @@ -104,7 +104,7 @@ a>b ? a : b // evaluates to whichever is greater, a or b.Bitwise Operators

    Bitwise operators modify variables considering the bit patterns that represent the values they store.

    -
    operatordescriptionoperatordescription
    ==Equal to
    +
    diff --git a/docs/syntax/variables.html b/docs/expressions/variables.html similarity index 74% rename from docs/syntax/variables.html rename to docs/expressions/variables.html index 6b88f8e..736b443 100644 --- a/docs/syntax/variables.html +++ b/docs/expressions/variables.html @@ -1,46 +1,33 @@ -

    Variables

    -
    -

    Variables are containers for storing data values.

    -
      -
    • Global and local variables are optional.
    • -
    • To declare more than one variable, use a space.
    • -
    -

    The general rules for constructing names for variables (unique identifiers) are:

    -
      -
    • Names can contain letters, digits and underscores (_).
    • -
    • Names must begin with a letter.
    • -
    • Names cannot contain whitespaces or special characters like !, #, %, etc.
    • -
    • Reserved words (like keywords, such as null, true, false, etc.) cannot be used as names.
    • -
    • Variables can be placed in globle variables, or in the dynamic body section of an menu, or in both.
    • -
    -

    - All variables must be identified with unique names.
    - These unique names are called identifiers. - Identifiers can be short names (like x and y) or more descriptive names (age, sum, totalVolume). -

    -

    Note: It is recommended to use descriptive names in order to create understandable and maintainable code

    -
    Example
    -
    shell 
    -{
    -    var
    -    {
    -        hello_world = 'Hello World!'
    -        test_add1 = 5 + 6
    -    }
    -	
    -    dynamic
    -    {
    -	  item(title = @hello_world cmd = @msg(hello_world))
    -
    -	  menu(title = @test_add1)
    -	  {
    -	      var
    -	      {
    -	          test_sub1 = 11 - 5
    -	      }
    -	      
    -	      item(title = @test_sub1)
    -	  }
    -    }
    -}
    - +

    Variables

    +
    +

    Variables are containers for storing data values.

    +
      +
    • Global and local variables are optional.
    • +
    • To declare more than one variable, use a space.
    • +
    +

    The general rules for constructing names for variables (unique identifiers) are:

    +
      +
    • Names can contain letters, digits and underscores (_).
    • +
    • Names must begin with a letter.
    • +
    • Names cannot contain whitespaces or special characters like !, #, %, etc.
    • +
    • Reserved words (like keywords, such as null, true, false, etc.) cannot be used as names.
    • +
    • Variables can be placed in globle variables, or in the dynamic body section of an menu, or in both.
    • +
    +

    + All variables must be identified with unique names.
    + These unique names are called identifiers. + Identifiers can be short names (like x and y) or more descriptive names (age, sum, totalVolume). +

    +

    Note: It is recommended to use descriptive names in order to create understandable and maintainable code

    +
    Example
    +
    $hello_world = 'Hello World!'
    +$test_add1 = 5 + 6
    +
    +item(title = hello_world cmd = msg(hello_world))
    +
    +menu(title = test_add1)
    +{
    +	$test_sub1 = 11 - 5
    +	item(title = test_sub1)
    +}
    + diff --git a/docs/functions/app.html b/docs/functions/app.html index 21f165e..c174667 100644 --- a/docs/functions/app.html +++ b/docs/functions/app.html @@ -2,7 +2,6 @@

    The namespace of the application contains file paths, version and some details.


    -
    app.directory

    Returns the path of Shell directory.

    @@ -13,8 +12,7 @@
    app.cfg
    -

    Returns the path of the configuration file shell.nss (or shell.shl +

    Returns the path of the configuration file shell.nss (or shell.shl in older installations).

    Syntax

    app.cfg     // usage in section context
    @@ -71,7 +69,7 @@
     
     
    app.reload
    -

    Reload the configuration file. +

    Reload the configuration file.

    Syntax

    app.reload     // usage in section context
    @@ -80,7 +78,7 @@
     
     
    app.unload
    -

    Unload the configuration file. +

    Unload the configuration file.

    Syntax

    app.unload     // usage in section context
    diff --git a/docs/functions/clipboard.html b/docs/functions/clipboard.html
    new file mode 100644
    index 0000000..39b2cf0
    --- /dev/null
    +++ b/docs/functions/clipboard.html
    @@ -0,0 +1,39 @@
    +
    CLIPBOARD
    +
    +

    Clipboard handling functions.

    +
    + +
    +
    clipboard.get
    +

    Returns the value of the stored clipboard.

    +

    Syntax

    + clipboard.get +
    + +
    +
    clipboard.set
    +

    Store a value in the clipboard.

    +

    Syntax

    + clipboard.set("Hello world!") +
    + +
    +
    clipboard.length
    +

    Returns the length of the value stored in the clipboard.

    +

    Syntax

    + clipboard.length +
    + +
    +
    clipboard.is_empty
    +

    Verifies that there is a value stored in the clipboard.

    +

    Syntax

    + clipboard.is_empty +
    + +
    +
    clipboard.empty
    +

    Empty values stored in the clipboard.

    +

    Syntax

    + clipboard.empty +
    diff --git a/docs/functions/color.html b/docs/functions/color.html index 8f46588..392b204 100644 --- a/docs/functions/color.html +++ b/docs/functions/color.html @@ -164,7 +164,7 @@ color.accent_dark1 color.accent_dark2 color.accent_dark3 color.opacity -color.light -color.dark +color.lighten +color.darken color.rgba
    \ No newline at end of file diff --git a/docs/functions/index.html b/docs/functions/index.html index b01a251..6e5b195 100644 --- a/docs/functions/index.html +++ b/docs/functions/index.html @@ -2,6 +2,13 @@

    The functions and variables have unique titles described by fully qualified names that indicate a logical hierarchy.

    Shell has a number of functions and variables built into it that are always available. They are listed here in alphabetical order.

    +
    +
    indexof
    +

    Find the position of a menu item.

    +

    Syntax

    + indexof(expression[, default position]) +
    +
    if

    Conditionally executes another statement.

    @@ -136,6 +143,7 @@ none default
    -
    app | color | image | io | key | msg | path | reg | sel | str | sys | user +
    app | color | image | io | key | msg | path | reg | sel | str | sys | user| input +| ini | clipboard
    diff --git a/docs/functions/ini.html b/docs/functions/ini.html new file mode 100644 index 0000000..9f6f8c8 --- /dev/null +++ b/docs/functions/ini.html @@ -0,0 +1,17 @@ +
    INI
    +
    +

    Functions for handleing with .ini files.

    +
    +
    +
    ini.get
    +

    Returns the value of the key

    +

    Syntax

    + ini.get('path\to\ini file', "section", "key") +
    + +
    +
    ini.set
    +

    Set the key value.

    +

    Syntax

    + ini.set('path\to\ini file', "section", "key", "value") +
    \ No newline at end of file diff --git a/docs/functions/input.html b/docs/functions/input.html new file mode 100644 index 0000000..66dbc80 --- /dev/null +++ b/docs/functions/input.html @@ -0,0 +1,18 @@ +
    INPUT
    +
    +

    The input box allows the user to enter and pass data.

    +
    +
    +
    input
    +

    Show the input box with the window title and call parameter passed.
    +The function returns a non-zero value if the OK button is pressed. Otherwise, it returns zero.

    +

    Syntax

    + input("Title", "Prompt") +
    + +
    +
    input.result
    +

    Returns the input value resulting from the input box.

    +

    Syntax

    + input.result +
    diff --git a/docs/functions/io.html b/docs/functions/io.html index d429016..90c9435 100644 --- a/docs/functions/io.html +++ b/docs/functions/io.html @@ -167,3 +167,10 @@ io.datetime.modified(sel.path,2000,1,1))
    io.datetime.accessed(sel.path,2000,1,1))
    + +
    +
    io.meta
    +

    Gets meta data by property key.

    +

    Syntax

    + io.meta('path\to\file',"System.Size")) +
    diff --git a/docs/functions/key.html b/docs/functions/key.html index ec7c53d..2e15999 100644 --- a/docs/functions/key.html +++ b/docs/functions/key.html @@ -79,4 +79,14 @@ key(key.shift, key.control, 87)
    +
    +
    key.send
    +

    Send one or more keys to the current window.

    +

    Syntax

    +
    key.send(key.f5)
    +key.send(key.ctrl,'n')
    +key.send(key.shift, key.delete)
    +
    + + diff --git a/docs/functions/reg.html b/docs/functions/reg.html index 7cdee8e..2ea92de 100644 --- a/docs/functions/reg.html +++ b/docs/functions/reg.html @@ -4,11 +4,15 @@
    Registry hive enum

    Syntax

    -
    reg.cr	// HKEY_CLASSES_ROOT
    -reg.cu	// HKEY_CURRENT_USER
    -reg.lm	// HKEY_LOCAL_MACHINE
    -reg.u	// HKEY_USERS
    -reg.cc	// HKEY_CURRENT_CONFIG
    +
    HKCU
    +HKCR
    +HKLM
    +HKU
    +HKEY_CLASSES_ROOT
    +HKEY_CURRENT_USER
    +HKEY_LOCAL_MACHINE
    +HKEY_USERS
    +
    Registry value type Enum
    @@ -27,4 +31,49 @@ reg.qword // REG_QWORD

    Syntax

    reg(reg.lm, 'SOFTWARE\Microsoft\Windows NT\CurrentVersion','ProductName')

    reg(reg.cr, 'txtfile\DefaultIcon') +
    + +
    +
    reg.exists
    +

    Check that the key or value name exists

    +

    Syntax

    +

    Check that the key exists

    + reg.exists('HKCU\Control Panel\Desktop') +

    Check that the value name exists

    + reg.exists('HKCU\Control Panel\Desktop', "WallPaper") +
    + +
    +
    reg.get
    +

    Read data by value name

    +

    Syntax

    +
    reg('HKCU\Control Panel\Desktop', "WallPaper")
    +reg.get('HKCU\Control Panel\Desktop', "WallPaper")
    +reg.get('HKCU\Control Panel\Desktop')
    +
    + +
    +
    reg.set
    +

    Allows creating a subkey with the value name and value data

    +

    Syntax

    +

    Create Subkey

    +
    reg.set('HKCU\Software\Nilesoft\Shell')
    +

    Create Subkey with value and set value data type.

    +
    reg.set('HKCU\Software\Nilesoft\Shell', "test-int", 1, reg.dword)
    +reg.set('HKCU\Software\Nilesoft\Shell', "test-str", 1, reg.sz)
    +reg.set('HKCU\Software\Nilesoft\Shell', "test-str", 'some string', reg.sz)
    + +

    Set value data with auto type detection.

    
    +reg.set('HKCU\Software\Nilesoft\Shell', 'test-auto-int', 1)
    +reg.set('HKCU\Software\Nilesoft\Shell', 'test-auto-str', 'some string')
    +
    + +
    +
    reg.delete
    +

    Allows deleting a subkey or deleting a value

    +

    Syntax

    +

    Delete value name.

    +
    reg.delete('HKCU\Software\Nilesoft\Shell', 'test-auto')
    +

    Delete subkey.

    +
    reg.delete('HKCU\Software\Nilesoft\Shell')
    \ No newline at end of file diff --git a/docs/functions/sel.html b/docs/functions/sel.html index f6e1fe1..2d60464 100644 --- a/docs/functions/sel.html +++ b/docs/functions/sel.html @@ -214,3 +214,10 @@ sel(true, "\n")

    Syntax

    sel.hidden(index=0)
    + +
    +
    sel.meta
    +

    Gets meta data by property key.

    +

    Syntax

    + sel.meta("System.Size")) +
    diff --git a/docs/functions/this.html b/docs/functions/this.html index f15b661..5ede648 100644 --- a/docs/functions/this.html +++ b/docs/functions/this.html @@ -5,7 +5,7 @@
    Syntax
    
    -this.type	// Returns the type of the current item [menu = 2, item = 1, separator = 0]
    +this.type	// Returns the type of the current item [item = 0, menu = 1, separator = 2]
     this.checked	// Returns true if the current item is checked
     this.pos	// Returns the position of the current item in the context menu
     this.disabled	// Returns true if the current item is disabled
    diff --git a/docs/get-started.html b/docs/get-started.html
    index 913f42b..7de9bfe 100644
    --- a/docs/get-started.html
    +++ b/docs/get-started.html
    @@ -11,31 +11,23 @@
     
    Quickstart

    Let's create our first menu item.

    Open the configuration file "shell.nss" and Write the following code and save.

    -
    Operator
    -


    Use the following keys to enable/disable
    -

    These keys are used when you press right-click or press Shift+F10 keys

    - CTRL To enable and reload the configuration file shell.nss
    - WIN To make priority to the modern context menu for Windows 11
    - CTRL+WIN To disable Shell and Enable Classic Context Menu
    - RIGHT-CLICK + LEFT-CLICK To reload the configuration file shell.nss
    +

    These keys are used when you press right-click or press Shift+F10 keys

    + CTRL To enable and reload the configuration file shell.nss
    + WIN To make priority to the modern context menu for Windows 11
    + CTRL+WIN To disable Shell and Enable Classic Context Menu
    + RIGHT-CLICK+LEFT-CLICK To reload the configuration file shell.nss
    diff --git a/docs/menu.json b/docs/menu.json index f8db784..bd1708e 100644 --- a/docs/menu.json +++ b/docs/menu.json @@ -3,18 +3,19 @@ {"title":"Installation", "link":"/docs/installation"}, {"title":"Get Started", "link":"/docs/get-started"}, { - "title":"Syntax", "link":"/docs/syntax", + "title":"Configuration", "link":"/docs/configuration", "items": [ - {"title":"Variables", "link":"/docs/syntax/variables"}, - {"title":"Set", "link":"/docs/syntax/set"}, - {"title":"Static", "link":"/docs/syntax/static"}, - {"title":"Dynamic", "link":"/docs/syntax/dynamic"}, - {"title":"Properties", "link":"/docs/syntax/properties" } + {"title":"Settings", "link":"/docs/configuration/settings"}, + {"title":"Themes", "link":"/docs/configuration/themes"}, + {"title":"Modify items", "link":"/docs/configuration/modify-items"}, + {"title":"New items", "link":"/docs/configuration/new-items"}, + {"title":"Properties", "link":"/docs/configuration/properties" } ] },{ "title":"Expressions", "link":"/docs/expressions", "items": [ {"title":"Comments", "link":"/docs/expressions/comments"}, + {"title":"Variables", "link":"/docs/expressions/variables"}, {"title":"String literal", "link":"/docs/expressions/string"}, {"title":"Numeric literal", "link":"/docs/expressions/numeric"}, {"title":"Color literal", "link":"/docs/expressions/color"}, @@ -41,14 +42,17 @@ {"title":"sys", "link":"/docs/functions/sys"}, {"title":"this", "link":"/docs/functions/this"}, {"title":"user", "link":"/docs/functions/user"}, - {"title":"window", "link":"/docs/functions/window"} + {"title":"window", "link":"/docs/functions/window"}, + {"title":"clipboard", "link":"/docs/functions/clipboard"}, + {"title":"input", "link":"/docs/functions/input"}, + {"title":"ini", "link":"/docs/functions/ini"} ] },{ "title":"Examples", "link":"/docs/examples", "items": [ {"title":"Copy path", "link":"/docs/examples/copy-path"}, {"title":"Favorites", "link":"/docs/examples/favorites"}, - {"title":"Goto", "link":"/docs/examples/goto"} + {"title":"Go to", "link":"/docs/examples/goto"} ] } ] \ No newline at end of file diff --git a/docs/syntax/default.html b/docs/syntax/default.html deleted file mode 100644 index 1fa025a..0000000 --- a/docs/syntax/default.html +++ /dev/null @@ -1,164 +0,0 @@ -

    Default

    -

    -

    Default are containers for storing default values.

    - -
    shell 
    -{
    -    default
    -    {
    -        // view = auto, compact, small, medium, large, wide
    -        view = view.compact
    -
    -        // theme = auto, dark, light, white, black, modern, modern_light, modern_dark
    -        theme = theme.modern
    -
    -        // border size value from 0 to 10
    -        frame = 1
    -        // or
    -        frame // border
    -        {
    -            // border size value from 0 to 10
    -            size = 1
    -
    -            color = #2c2c2c
    -
    -            // opacity value from 0 to 100
    -            opacity = 20
    -
    -            // radius size value from 0 to 3
    -            radius = 1
    -
    -            padding = [0, 4, 0, 4]
    -        }
    -
    -        // shadow size value from 0 to 10
    -        shadow = 1
    -        // or
    -        shadow
    -        {
    -            // shadow size value from 0 to 10
    -            size = 1
    -
    -            // opacity value from 0 to 100
    -            opacity = 50
    -
    -            color = #000
    -        }
    -
    -        item
    -        {
    -            // text = [normal, selected]
    -            text = [#fff, #fff]
    -        
    -            // back = [normal, selected]
    -            back = [#2c2c2c, #3c3c3c]
    -        
    -            // radius size value from 0 to 3
    -            radius = 1
    -
    -            margin = [4, 0]
    -
    -            padding = [8, 4]
    -        }
    -        
    -        separator = #202020
    -        // or
    -        separator // sep
    -        {
    -            color = #202020
    -        
    -            size = 1
    -        
    -            margin = [8, 2]
    -        }
    -	
    -        // symbol = [normal, selected]
    -        symbol = [#f00, #800]
    -        // or
    -        symbol
    -        {
    -            // sub = [normal, selected]
    -            sub = [#f00, #800]
    -
    -            // checked = [normal, selected]
    -            checked = [#0f0, #080]
    -        
    -            // radio = [normal, selected]
    -            radio = [#00f, #008]
    -        }
    -
    -        image
    -        {
    -            gap = 8
    -            size = 16
    -            color = #ffff
    -        }
    -
    -        tip = true
    -        // or
    -        tip
    -        {
    -            enabled = true
    -
    -            // normal = [background, text]
    -            normal = [default, default]
    -
    -            // normal = [background, text]
    -            primary = [#000, #fff]
    -
    -            // info = [background, text]
    -            info = [#88f, #fff]
    -
    -            // success = [background, text]
    -            success = [#8f8, #fff]
    -
    -            // warning = [background, text]
    -            warning = [#ff8, #fff]
    -
    -            // danger = [background, text]
    -            danger = [#f88, #fff]
    -
    -            // max width value from 200 to 2000
    -            width = 400
    -
    -            // opacity value from 0 to 100
    -            opacity = 100
    -
    -            // radius size value from 0 to 3
    -            radius = 1
    -
    -            time = 1.5
    -
    -            padding = [8, 4]
    -        }
    -        
    -        // show menu delay value from 0 to 4000
    -        showdelay = 200
    -
    -        // font = [size, font name]
    -        font = [12, 'Brush Script']
    -    }
    -}
    - -

    Padding and Margin value syntax

    -

    Use the padding shorthand property with four values:

    -padding = [1, 2, 3, 4] -
    left = 1
    -right = 2
    -top = 3
    -bottom = 4
    - -

    Use the padding shorthand property with two values:

    -padding = [4, 2] -
    left = 4
    -right = 4
    -top = 2
    -bottom = 2
    - -

    Use the padding shorthand property with one value:

    - -padding = 4 -
    left = 4
    -right = 4
    -top = 4
    -bottom = 4
    diff --git a/docs/syntax/dynamic.html b/docs/syntax/dynamic.html deleted file mode 100644 index f01dfbc..0000000 --- a/docs/syntax/dynamic.html +++ /dev/null @@ -1,125 +0,0 @@ -

    Dynamic Items

    -
    -

    The optional dynamic section adds new menu items to the context menu.

    - -
    Sub-items
    -

    The section can have the following entry types, all of which are optional:

    -
      -
    • One var block to define "local" variables. -
    • -
    • Menuitems, i.e. one or more of the following: -
        -
      • One or more item entries. - These appear as top-level items in a context menu. -
      • -
      • One or more menu entries. - These appear as top-level sub-menus in a context menu. -
      • -
      • One or more separator entries. These create a - horizontal line between the given entries. -
      • -
      -
    • -
    • One or more imports. The content of the given file will be placed in the - position of the import. -
    • -
    -

    While the var block should be at the top of the section, the other entries can appear in any order.

    - -
    Example
    -

    In the following example, one top-level item is created, that is - separated with a horizontal line from an adjacent sub-menu, which in turn has one sub-item - on its own:

    -
    shell 
    -{
    -    dynamic
    -    {
    -        item(title = 'Hello, World!')
    -        separator
    -        menu(title = 'sub menu' image = #0000ff)
    -        {
    -            item(title = 'test sub-item')
    -        }
    -    }
    -}
    -
    - - - -

    menuitem is an umbrella term for those entry types, that may appear in a - menu. These simply include the following:

    - - -
    - -

    Items

    - -

    items create a single menu entry.

    - -
    Properties
    -

    Either a title or a image property is mandatory (set to a non-null value). For further details, - please refer to the properties page.

    - -
    Syntax
    -
    item( title = value [property = value [...] ])
    -
    - - - -

    menu entries create a new sub-menu. They have properties - and sub-entries.

    - - -

    Either a title or a image property is mandatory (set to a non-null value). For further details, - please refer to the properties page.

    - - -

    menus can have the following entry types, all of which are - optional:

    -
      -
    • One var block to define "local" variables. -
    • -
    • Menuitems, i.e. one or more of the following: - -
    • -
    • One or more imports. The content of the - given file will be placed in the position of the import. -
    • -
    - - -
    menu( title = value [property = value [...] ])
    -{
    -	[ item() [...] ]
    -	[ menu(){} [...] ]
    -	[ separator [...] ]
    -	[ import 'path/to/import.nss' [...] ]
    -}
    -
    - -

    Separators

    - -

    separators create a horizontal line.

    - -
    Properties
    -

    separators do not have any mandatory properties. Please refer to the properties page for further details.

    - -
    Syntax
    -
    separator
    -separator( property = value [property = value [...] ])
    diff --git a/docs/syntax/index.html b/docs/syntax/index.html deleted file mode 100644 index 67eff90..0000000 --- a/docs/syntax/index.html +++ /dev/null @@ -1,278 +0,0 @@ -

    Syntax Rules for Configuration Files

    -
    -

    This chapter describes the syntax rules for the configuration files.

    -

    The main configuration file shell.nss (or shell.shl - in older installations) is located in the installation directory of - Shell, depending on your installation method. -

    - -
    General rules
    -
      -
    • Syntax is case-insensitive.
    • -
    • Spaces around the equal (=) sign are optional and are ignored.
    • -
    • The properties of static and dynamic items are separated - by blank spaces or on a separate line and must be placed in - parentheses ( ). -
    • -
    • Other configuration files can be imported using the import tag. -
    • -
    - -
    - Tip: When there is an error, it is recorded in the log file (shell.log, which is also located in - your installation directory.). -
    - -
    shell.nss structure
    -

    The global section shell{} may have the following subsections:

    -
      -
    • Section var{} for global - variables. Optional. -
    • -
    • Section set{} for settings. - Optional. -
        -
      • As of version 1.8.0, set{} has replaced the - section default{} for - default values, which is now deprecated. Please use set{} for new installations. -
      • -
      -
    • -
    • Section static{} with - instructions on how to change existing menuitems. Optional. -
        -
      • Static items are only of one type: item.
      • -
      -
    • -
    • Section dynamic{} with - definitions for new menuitems. - Optional. - -
    • -
    - -
    Example
    - -
    shell
    -{
    -	// global variables
    -	var // variables 
    -	{
    -		// variables content
    -		variable-name = variable-value
    -		...
    -	}
    -
    -	set // settings
    -	{
    -		theme
    -		{
    -			set-name = set-value
    -			...
    -		}
    -
    -		set-name = set-value
    -		set-name = [set-value, set-value, ...]
    -		...
    -	}
    -
    -	images
    -	{
    -		id = value
    -		"item 1" = value
    -		id1,id2, id3, "item 2" = value
    -		....
    -	}
    -
    -	// static items
    -	static
    -	{
    -		// static items content
    -		item ( property-name = property-value   ... )
    -		...
    -	}
    -
    -	// dynamic items
    -	dynamic
    -	{
    -		// dynamic items content
    -		item ( property-name = property-value   ... )
    -
    -		separator [( property-name = property-value   ... )]
    -
    -		menu ( property-name = property-value   ... )
    -		{
    -		   var // local variables
    -		   {
    -				variable-name = variable-value
    -				...
    -			}
    -			
    -			item ( property-name = property-value   ... )
    -			...
    -		}
    -		...
    -	}
    -}
    -
    - -

    Breaking Long Lines

    -

    For best readability, users often like to avoid lines longer than 80 characters. single - quotes also allow break up a line.

    -
    shell 
    -{
    -	dynamic
    -	{
    -		item(title='Command prompt'
    -			cmd='cmd.exe')
    -	}
    -}
    -
    - -

    Import tag

    -

    To better organise the configuration file, parts of the configuration can be saved in separate files. These are then - imported using the import tag. With this method, it is also possible to import the same file as a sort of "module" - into different parts of the configuration. A convenient way to include the same sub-menu in different - locations..

    - -
    Syntax
    -

    The general syntax is as follows:

    -
    shell
    -{
    -	[ %section% ] import %path%
    -}
    -

    Where

    -
      -
    • %section% is the name of a section. Optional. If given, it must be one - of -
        -
      • var
      • -
      • set
      • -
      • images
      • -
      • static
      • -
      • dynamic
      • -
      - The section name is written literally, without any quotes (or the percent signs). -
    • -
    • %path% is a string literal, that returns the path to the - config file that shall be imported. This can be a relative path to the location of the file where the import tag is used, or it can be an absolute path. Expressions are - supported when using single quotes. -
    • -
    - -

    There are effectively two different ways this tag is applied, depending on whether the optional - %section% is given:

    -
      -
    • Import an entire section
    • -
    • Import as a partial:
    • -
    - -
    Import an entire section
    -
    shell
    -{
    -	// import an entire section
    -	%section% import %path%
    -}
    -In this case, the content of the file found at %path% will be imported into a newly - created section{}. -The result would then look like so: -
    shell
    -{
    -	// import an entire section
    -	section {
    -		/* content of the imported file goes here! Do not include
    -		 *
    -		 * section {
    -		 * }
    -		 *
    -		 * in your imported file!
    -		 */
    -	}
    -}
    -

    This syntax may be used only in the following places:

    -
      -
    • root section shell{}: shell import %path% -
    • -
    • the global sections -
        -
      • var{}: var import %path%
      • -
      • set{}: set import %path%
      • -
      • images{}: images import %path%
      • -
      • static{}: static import %path%
      • -
      • dynamic{}: dynamic import %path% -
      • -
      -
    • -
    • - sub-sections of the set{} section: -
        -
      • set.theme{}: theme import %path% -
      • -
      • set.theme.background{}: background import - %path%
      • -
      • set.theme.item{}: item import - %path%
      • -
      • set.theme.border{}: border import - %path%
      • -
      • ...
      • -
      • set.tip{}: tip import %path%
      • -
      • set.exclude{}: exclude import - %path%
      • -
      • set.static{}: static import %path% -
      • -
      • set.dynamic{}: dynamic import - %path%
      • -
      -
    • -
    -
    Import as a partial
    -
    shell
    -{
    -	section {
    -		// some code might go here. Optional.
    -
    -		// import of a partial section
    -		import %path%
    -
    -		// some more content might go here. Optional.
    -	}
    -}
    -In this case, the content of the file found at %path% will be imported into the already - existing section{}. -The result would then look like so: -
    shell
    -{
    -	section {
    -		// some code might go here. Optional.
    -
    -		// import of a partial section
    -		/* content of the imported file goes here! Do not include
    -		 *
    -		 * section {
    -		 * }
    -		 *
    -		 * in your imported file!
    -		 */
    -
    -		// some more content might go here. Optional.
    -	}
    -}
    -

    This syntax may be used nearly anywhere:

    -
      -
    • in any section
    • -
    • in the body of menu tags -
    • -
    diff --git a/docs/syntax/set.html b/docs/syntax/set.html deleted file mode 100644 index d26ada4..0000000 --- a/docs/syntax/set.html +++ /dev/null @@ -1,316 +0,0 @@ -

    Settings

    -

    -

    Set are containers for storing default values.

    - -
    shell 
    -{
    -	set // settings
    -	{
    -		theme
    -		{
    -			// theme.name = auto, classic, white, black, or modern
    -			name = "modern"
    -
    -			// view = auto, compact, small, medium, large, wide
    -			view = view.compact
    -
    -			dark = true or false
    -
    -			background
    -			{
    -				color = color value
    -				opacity = value from 0 to 100
    -
    -				// effect value 0 = disable, 1 = transparent, 2 = blur, 3 = acrylic
    -				effect = auto
    -
    -				// for acrylic
    -				effect = [3, tint color, opacity]
    -
    -				gradient
    -				{
    -					enabled = boolean value
    -
    -					// linear = [x1, x2, y1, y2]
    -					linear = [0, 100, 0, 0]
    -
    -					// or radial = [cx, cy, r, fx, fy]
    -					radial =[ 100, 100, 150, 100, 100]
    -
    -					// stop = [offset, stop-color]
    -					stop = [0.5, color.accent, 20]
    -
    -					// or add more stop
    -					stop = [
    -						[offset, stop-color],
    -						[offset, stop-color],
    -						[offset, stop-color]
    -					]
    -				}
    -			}
    -
    -			item
    -			{
    -				opacity = value from 0 to 100
    -				radius = value from 0 to 3
    -
    -				// prefix value [auto, 0 = dont display,  1 = display, 2 = ignore]
    -				prefix = 1
    -
    -				text
    -				{
    -					normal = color
    -					select = color
    -					normal_disabled = color
    -					select_disabled = color
    -				}
    -
    -				back
    -				{
    -					normal = color
    -					select = color
    -					normal_disabled = color
    -					select_disabled = color
    -				}
    -
    -				border
    -				{
    -					normal = color
    -					select = color
    -					normal_disabled = color
    -					select_disabled = color
    -				}
    -
    -				padding
    -				{
    -					left = value
    -					top = value
    -					right = value
    -					bottom = value
    -				}
    -
    -				margin
    -				{
    -					left = value
    -					top = value
    -					right = value
    -					bottom = value
    -				}
    -			}
    -
    -			border
    -			{
    -				enabled = boolean value
    -				size = value from 0 to 10
    -				color =  = value
    -				opacity = value
    -				radius = value
    -
    -				padding
    -				{
    -					left = value
    -					top = value
    -					right = value
    -					bottom = value
    -				}
    -			}
    -
    -			shadow
    -			{
    -				enabled = boolean value
    -				size = value from 0 to 30
    -				color = value
    -				opacity = value from 0 to 100
    -				offset = value from 0 to 30
    -			}
    -
    -			font
    -			{
    -				size = value start from 6
    -				name = "tahoma"
    -
    -				weight = value from 1 to 9
    -
    -				italic = 0
    -			}
    -
    -			separator
    -			{
    -				size = value form 0 to 40
    -				color = value
    -				opacity = value
    -
    -				margin
    -				{
    -					left = value
    -					top = value
    -					right = value
    -					bottom = value
    -				}
    -			}
    -
    -			symbol
    -			{
    -				normal = color
    -				select = color
    -				normal_disabled = color
    -				select_disabled = color
    -
    -				// or
    -				chevron
    -				{
    -					normal = color
    -					select = color
    -					normal_disabled = color
    -					select_disabled = color
    -				}
    -
    -				checkmark
    -				{
    -					normal = color
    -					select = color
    -					normal_disabled = color
    -					select_disabled = color
    -				}
    -
    -				bullet
    -				{
    -					normal = color
    -					select = color
    -					normal_disabled = color
    -					select_disabled = color
    -				}
    -			}
    -
    -			image
    -			{
    -				enabled = boolean value
    -
    -				color = [color1, color2, color3]
    -				// or
    -				color.color1 = color
    -				color.color2 = color
    -				color.color3 = color
    -
    -				gap = value
    -				glyph = "font name" // font name for default glyph
    -				scale = boolean value
    -				align = value [0 = Display only the check mark, 1 = Display the image and check mark together]
    -			}
    -
    -			layout
    -			{
    -				// Right-to-left layout display for Middle Eastern languages
    -				rtl = boolean value
    -
    -				// Align submenus
    -				popup = value from -20 to 20
    -			}
    -		}
    -
    -		tip = true
    -		// or
    -		tip
    -		{
    -			enabled = true
    -
    -			// normal = [background, text]
    -			normal = [default, default]
    -
    -			// normal = [background, text]
    -			primary = [#000, #fff]
    -
    -			// info = [background, text]
    -			info = [#88f, #fff]
    -
    -			// success = [background, text]
    -			success = [#8f8, #fff]
    -
    -			// warning = [background, text]
    -			warning = [#ff8, #fff]
    -
    -			// danger = [background, text]
    -			danger = [#f88, #fff]
    -
    -			// max width value from 200 to 2000
    -			width = 400
    -
    -			// opacity value from 0 to 100
    -			opacity = 100
    -
    -			// radius size value from 0 to 3
    -			radius = 1
    -
    -			time = 1.5
    -
    -			padding = [8, 4]
    -		}
    -
    -		// show menu delay value from 0 to 4000
    -		showdelay = 200
    -
    -		// Prevent interaction with these windows or processes
    -		exclude
    -		{
    -			where = boolean value
    -			window = window name
    -			process = process name
    -		}
    -
    -		// Disable/Enable static items processing
    -		static
    -		{
    -			enabled = boolean value
    -			image = [0 = disable, 1 = enable, 2 = auto reimage]
    -
    -			// Allow/disallow modification of title
    -			title = boolean value
    -
    -			// Allow/disallow modification of visibility
    -			visibility = boolean value
    -
    -			// Allow/disallow modification of parent
    -			parent = boolean value
    -
    -			// Allow/disallow modification of position
    -			position = boolean value
    -
    -			// Allow/disallow to add separator
    -			separator = boolean value
    -
    -			// auto set image and group
    -			auto = boolean value
    -		}
    -
    -		// Disable/Enable dynamic items processing
    -		dynamic
    -		{
    -			enabled = boolean value
    -			// disable/enable image
    -			image = boolean value
    -		}
    -	}
    -}
    - -

    Padding and Margin value syntax

    -

    Use the padding shorthand property with four values:

    -padding = [1, 2, 3, 4] -
    left = 1
    -right = 2
    -top = 3
    -bottom = 4
    - -

    Use the padding shorthand property with two values:

    -padding = [4, 2] -
    left = 4
    -right = 4
    -top = 2
    -bottom = 2
    - -

    Use the padding shorthand property with one value:

    - -padding = 4 -
    left = 4
    -right = 4
    -top = 4
    -bottom = 4
    diff --git a/docs/syntax/static.html b/docs/syntax/static.html deleted file mode 100644 index 6507b05..0000000 --- a/docs/syntax/static.html +++ /dev/null @@ -1,101 +0,0 @@ -

    Static Items

    -
    -

    The optional static section contains entries to modify existing context menu items, - added by the system or by a third party.

    - -
    Sub-items
    -

    The section can have the following entry types, all of which are optional:

    -
      -
    • One var block to define "local" variables. -
    • -
    • One or more item entries. - These contain the instructions on which and how to change existing menuitems. -
    • -
    • One or more imports. The content of the - given file will be placed in the position of the import. -
    • -
    -

    While the var block should be at the top of the section, the other entries can appear in any order.

    - -
    Example
    -

    In the following example, two instructions are defined:

    -
    shell 
    -{
    -    static
    -    {
    -        item(find = 'copy' image = #00ff00)
    -        item(find = 'paste' image = #0000ff)
    -    }
    -}
    -
    - -

    Item Entries

    - -

    item entries contain the instructions on how to identify existing menuitems (also referred to as Target), and when and what changes should be applied - to them.

    This is done by matching an existing menuitem's title property against the static item's mandatory find property. If a match is found, the other properties of the static - item are applied to the appropriate menuitem, such as changing their properties (e.g. title, icon, visibility), or moving them to another location.

    - -
    Syntax
    -
    item( title = value [property = value [...] ])
    -
    - - -
    Properties
    - -

    item entries can define three different sets of properties:

    -
    -
    Validation Properties
    -
    Determine if a given item entry should be processed when a context menu is displayed. Optional. -
    -
    Filter Properties:
    -
    Determine if a given menuitem is a valid target - for the process instructions -
      -
    • find (mandatory)
      - Pattern used to identify targets by matching against their title property. -
    • -
    -
    -
    Process Instructions
    -
    Define what to do with the target. Optional. However, if there are no process instruction specified, the entry is of no practical use. For - further details refer to its separate section - below. -
    -
    - -

    For a complete overview and further details regarding applicable properties, please refer to the properties page.

    - -

    Item Target

    - -

    Item targets are menuitems of an existing context menu. Their properties or location can - be changed by applying the process instructions defined in a static item.

    - -
    Process instructions
    -

    Instructions that should be applied to the Target. Basically they consist of properties from the two property - classes menuitem properties and command properties.

    -

    Once a item is validated and a target identified, then these values are applied to the targeted - menuitem.

    diff --git a/extensions/README.md b/extensions/README.md deleted file mode 100644 index 952e7f7..0000000 --- a/extensions/README.md +++ /dev/null @@ -1 +0,0 @@ -This folder includes extensions for formatting and highlighting configuration files. \ No newline at end of file diff --git a/extensions/vscode/README.md b/extensions/vscode/README.md deleted file mode 100644 index 9e57120..0000000 --- a/extensions/vscode/README.md +++ /dev/null @@ -1 +0,0 @@ -vscode addon for formatting and highlighting .nss files \ No newline at end of file diff --git a/www/Default.aspx b/www/Default.aspx deleted file mode 100644 index 964a3be..0000000 --- a/www/Default.aspx +++ /dev/null @@ -1,26 +0,0 @@ -<%@ Page Language="VB" AutoEventWireup="false" Codebehind="Default.aspx.vb" CodeFile="Default.aspx.vb" Inherits="_Default" Debug="true" %><% - -Select Case requestType - -Case "document" - - Dim pageName As String - Dim pageSlug As String - - requestedFile = preparePage(requestedFile, pageSlug, pageName) - -%><% - -Case "image" - - includeImage(requestedFile) - -Case Else - -%> -Unknown Type <%= requestType %> -<% - -End Select - -%> \ No newline at end of file diff --git a/www/Default.aspx.vb b/www/Default.aspx.vb deleted file mode 100644 index acbe0b4..0000000 --- a/www/Default.aspx.vb +++ /dev/null @@ -1,430 +0,0 @@ -Option Strict On - -Imports System.IO -Imports System.Globalization -Imports System.Text.Json -Imports System.XML -Imports System.XML.Linq - -Partial Class _Default - -Inherits System.Web.UI.Page - -Friend Shared SERVER_NAME As String -Friend Shared SERVER_PORT As String -Friend Shared HTTPS As String - -Friend Shared rootUrl As String = "http://" & SERVER_NAME -Friend const nilesoftRoot As String = "https://nilesoft.org" -Friend const gitRepo As String = "https://github.com/moudey/shell" -Friend const gitBranch As String = "main" -Friend const gitRootUrl As String = gitRepo & "/blob/" & "main" - -Friend Shared nilesoftUrl As String -Friend Shared gitUrl As String - -Friend Shared appRoot As DirectoryInfo -Friend Shared projectRoot As DirectoryInfo -Friend Shared docsRoot As DirectoryInfo - -Friend Shared requestType As String -Friend Shared requestUrl As String -Friend Shared requestMap As String -Friend Shared requestedFile As FileInfo -Friend Shared fileModified As DateTime -Friend Shared fileUrl As String - -Private Shared rgxRemoveIndex As New Regex("(.*)(index)?\.html$") -Private Shared rgxReplaceDash As New Regex("[-_]+") - -''' Creates a TextInfo based on the "en-US" culture. -Private Shared myTI As TextInfo = New CultureInfo("en-US", False).TextInfo - - -Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load - - ''' Get directories - appRoot = New DirectoryInfo(HttpRuntime.AppDomainAppPath) - projectRoot = appRoot.parent - docsRoot = New DirectoryInfo(projectRoot.FullName & "/docs") - - ''' Get the current requested URL - requestType = Request.QueryString("type") - - ''' sanitize for empty values and the default file - If String.IsNullOrEmpty(requestType) Then - requestType = "document" - End If - - ''' Get the current requested URL - requestUrl = Request.QueryString("path") - - ''' sanitize for empty values and the default file - If String.IsNullOrEmpty(requestUrl) Then - requestUrl = "/" - Else If requestUrl = "default.aspx" Then - requestUrl = "/" - End If - - ''' Evaluate which file is required: - ''' - - ''' First, take url at face value - requestMap = projectRoot.FullName & requestUrl.replace("/", "\") - requestedFile = New FileInfo(requestMap) - - End Sub - - -''' this is called from Default.aspx to actually include the requested content -Protected Function preparePage(pageFile As FileInfo, ByRef basename As String, ByRef caption As String) As FileInfo - - Dim dirInfo As DirectoryInfo - Dim suffix = "" - Dim isHTTPS = false - - ''' Get server information - SERVER_NAME = Request.ServerVariables.GetValues( "SERVER_NAME")(0) - SERVER_PORT = Request.ServerVariables.GetValues( "SERVER_PORT")(0) - HTTPS = Request.ServerVariables.GetValues( "HTTPS")(0) - isHTTPS = if(HTTPS = "ON", true, false ) - - ''' Build foot URL - If isHTTPS Then - rootUrl = "https://" & SERVER_NAME & if(SERVER_PORT = "443", "", ":" & SERVER_PORT) - Else - rootUrl = "http://" & SERVER_NAME & if(SERVER_PORT = "80", "", ":" & SERVER_PORT) - End If - - ''' If the url ends with ".html", we just go for it - If Not pageFile.Extension.ToLower() = ".html" Then - - ''' Otherwise try adding ".html" - This would be the case for a file in a directory - ''' E.g. /docs/installation should really load /docs/installation.html - suffix = ".html" - dirInfo = New DirectoryInfo(pageFile.FullName) - pageFile = New FileInfo(pageFile.FullName & suffix) - - ''' test, if file exists - If not pageFile.Exists Then - - ''' otherwise it could be a directory, and we look for the "index.html" - ''' So test for the directory - If dirInfo.Exists Then - - ''' If found, assume the default: index.html - suffix = "index.html" - pageFile = New FileInfo(dirInfo.FullName & "\" & suffix) - - End If - - End If - - End If - - ''' Create helper urls for the bottom of the page - gitUrl = gitRootUrl & requestUrl & suffix - fileUrl = rgxRemoveIndex.Replace(rootUrl & requestUrl, "$1") - nilesoftUrl = rgxRemoveIndex.Replace(nilesoftRoot & requestUrl, "$1") - - If pageFile.Exists Then - fileModified = File.GetLastWriteTime(pageFile.FullName) - End If - - extractNames(pageFile.Name, basename, caption) - - return pageFile - -End Function - - - ''' this is called from Default.aspx to actually include the requested content -Protected Function includePage(pageFile As FileInfo) As Boolean - - If Not pageFile.Exists Then - return false - End If - - ' Open the stream and read it back. - Dim sr As StreamReader = pageFile.OpenText() - - Response.Write( sr.ReadToEnd() ) - sr.Close() - - return true - -End Function - -Protected Function includeImage(imageFile As FileInfo) As Boolean - - If not imageFile.Exists Then - - Response.Clear() - Response.StatusCode = 404 - Response.StatusDescription = "File not found" - Response.Flush() - - return false - - End If - - ''' Set the page's content type ... - Select Case imageFile.Extension.ToLower() - - Case "png" - Response.ContentType = "image/png" - - Case "jpg", "jpeg" - Response.ContentType = "image/jpeg" - - Case Else - Response.ContentType = "application/octet-stream" - - End Select - - Response.TransmitFile(imageFile.FullName) - - Response.Flush() - - return true - -End Function - -''' This is used to automagically create the left-side navigation. It's not perfect, but does the job -Protected Function PrintNav(ByVal initial As DirectoryInfo) As XElement - - ''' create return element - Dim xmlRoot As XElement = - Dim children As IEnumerable(Of XElement) - - Dim menuFile As FileInfo = New FileInfo(initial.FullName & "\menu.json") - - - If menuFile.Exists Then - PrintNavXmlAppendChildren(xmlRoot, PrintNavJson(menuFile)) - Else - PrintNavXmlAppendChildren(xmlRoot, PrintNavFS(initial)) - End If - - return xmlRoot - -End Function - -Protected Function PrintNavXmlMarkActive(ByRef html As XElement, ByVal link As String) As XElement - - ''' If it's the current page, mark it active - If link = "/" & requestUrl Then - html.Descendants("a")(0).Attribute("class").Value = "is-active" - End If - - return html - -End Function - -Protected Function PrintNavXmlCreateDir(ByVal caption As String, ByVal link As String) As XElement - - Dim html As XElement - - ''' Create the html - html = _ -
  • - -
    - - <%= caption %> -
    -
    -
  • - - ''' Update the href attribute - html.Descendants("a")(0).Attribute("href").Value = link - - return PrintNavXmlMarkActive(html, link) - -End Function - -Protected Function PrintNavXmlCreateFile(ByVal caption As String, ByVal link As String) As XElement - - Dim html As XElement - - ''' create the required html - html = _ -
  • - - <%= caption %> - -
  • - - ''' update the href property - html.Descendants("a")(0).Attribute("href").Value = link - - return PrintNavXmlMarkActive(html, link) - -End Function - -Protected Function PrintNavXmlAppendChildren( - ByRef parentNode As XElement, - ByRef childNode As XElement - ) As Long - - Dim children As IEnumerable(Of XElement) - - ''' get files and sub-folders - children = childNode.Elements - - ''' if found any, append them - If children.count() > 0 Then - - parentNode.add(
      ) - - parentNode.Descendants("ul")(0).add( children ) - - End If - - return children.count() - -End Function - -Protected Function PrintNavJson(ByVal menuFile As FileInfo) As XElement - - Dim jsonString = File.ReadAllText(menuFile.FullName) - - Using document As JsonDocument = JsonDocument.Parse(jsonString) - - Dim root As JsonElement = document.RootElement - - return PrintNavJsonArray(root) - - End Using - -End Function - -Protected Function PrintNavJsonArray(items As JsonElement) As XElement - - Dim xmlRoot As XElement = - Dim count = items.GetArrayLength() - - For Each item As JsonElement In items.EnumerateArray() - - ''' Append to the result - xmlRoot.Add(PrintNavJsonElement(item)) - - Next - - return xmlRoot - -End Function - -Protected Function PrintNavJsonElement(item As JsonElement) As XElement - - Dim element As JsonElement = Nothing - Dim title As String = "N/A" - Dim link As String = "#" - Dim html As XElement - Dim children As IEnumerable(Of XElement) - - If item.TryGetProperty("title", element) Then - title = element.GetString() - End If - - If item.TryGetProperty("link", element) Then - link = element.GetString() - End If - - - If item.TryGetProperty("items", element) Then - - html = PrintNavXmlCreateDir(title, link) - - PrintNavXmlAppendChildren(html, PrintNavJsonArray(element)) - - Else - - html = PrintNavXmlCreateFile(title, link) - - End If - - return html - -End Function - - -''' This is used to automagically create the left-side navigation. It's not perfect, but does the job -Protected Function PrintNavFS(ByVal initial As DirectoryInfo) As XElement - - Dim fileName As FileInfo - Dim directoryNae As String = initial.FullName - Dim base As String = initial.FullName.replace(projectRoot.FullName & "\", "/").replace("\", "/") - Dim html As XElement - Dim children As IEnumerable(Of XElement) - Dim basename As String - Dim caption As String - Dim link As String - - ''' create return element - Dim xmlRoot As XElement = - - ''' loop through the files in the given directory - For Each fileName In initial.GetFiles() - - ''' ignore the index.html, As it was already added As a directory - If fileName.Name = "index.html" Then - continue for - End If - - ''' Get the file's basename and convert it from "snake-case" to "Title Case" - ''' (basename and caption are passed ByRef) - extractNames(fileName.Name, basename, caption) - - ''' create the link - link = base & "/" & basename - - ''' create the required html - html = PrintNavXmlCreateFile(caption, link) - - ''' Append to the result - xmlRoot.Add(html) - next - - - - ''' Loop through the sub-directories - For Each directoryName In initial.GetDirectories() - - ''' Get the file's basename and convert it from "snake-case" to "Title Case" - ''' (basename and caption are passed ByRef) - extractNames(directoryName.Name, basename, caption) - - ''' Skip listing all images - If basename = "images" Then - continue for - End If - - ''' create the link - link = base & "/" & basename - - ''' Create the html - html = PrintNavXmlMarkActive(PrintNavXmlCreateDir(caption, link), link) - - ''' get files and sub-folders - PrintNavXmlAppendChildren(html, PrintNav(directoryName)) - - ''' add directory to the result - xmlRoot.Add(html) - Next - - return xmlRoot - -End function - -Protected Sub extractNames(ByVal path As String, ByRef basename As String, ByRef caption As String) - - basename = rgxRemoveIndex.Replace(path, "$1") - caption = myTI.ToTitleCase(rgxReplaceDash.Replace(basename, " ")) - -End Sub - - -End Class - - diff --git a/www/README.md b/www/README.md deleted file mode 100644 index 213a39f..0000000 --- a/www/README.md +++ /dev/null @@ -1,90 +0,0 @@ -# View documentation on your local machine - -**WARNING: This is not meant to be used on a production sever!!** - -It's sole intention is to be able to see the documentation documents in a context like on the live website in order to -be able to see the full formatting. So it's mainly intended for documentation authors or editors. - -## Local web server - -### Get Cassini 4 (tiny, redistributable ASP.NET webserver) - -With PowerShell (no administrative privileges required): - -``` PowerShell -# Source URL -$url = "https://github.com/adriancs2/CassiniDev/releases/download/5f7df0d/CassiniDev4.zip" - -# Destination file -$zip = ".\CassiniDev4.zip" - -# Download the file -Invoke-WebRequest -Uri $url -OutFile $zip - -# Unzip the file -Expand-Archive -Path $zip -DestinationPath '.\bin\CassiniDev4\' - -# Delete archive -Remove-Item $zip - -``` - -### Start the web server - -With PowerShell: - -``` PowerShell -# Set the port you want to listen on. 80 is the default for http:// -$port = 80 - -# Run the webserver -.\bin\CassiniDev4\CassiniDev4.exe /port:$port /path:. /vpath:/ /nodirlist /portMode:Specific - -echo "To see the documentation, open the following url in your browser:" -echo "http://localhost:$port/docs" - -``` - -With Command Prompt: - -``` Cmd -# Set the port you want to listen on. 80 is the default for http:// -set port = 80 - -# Run the webserver -.\bin\CassiniDev4\CassiniDev4.exe /port:%port% /path:. /vpath:/ /nodirlist /portMode:Specific - -echo To see the documentation, open the following url in your browser: -echo http://localhost:%port%/docs - -``` - -### Stop the web server - -In your tray icons section, you will find an icon showing above url as tooltip. Right-clicking on the icon opens a -context menu with the following options: - -- Show -- Brows -- View Log -- Exit - -Obviously, choose `Exit` to quit the web server. :-) - - \ No newline at end of file diff --git a/www/Web.config b/www/Web.config deleted file mode 100644 index 71e7a11..0000000 --- a/www/Web.config +++ /dev/null @@ -1,119 +0,0 @@ - - - - - - - -
      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/www/_aside.aspx b/www/_aside.aspx deleted file mode 100644 index 6841277..0000000 --- a/www/_aside.aspx +++ /dev/null @@ -1,34 +0,0 @@ -<%@ Import Namespace="System.IO" %> - - diff --git a/www/_footer.aspx b/www/_footer.aspx deleted file mode 100644 index 4584d51..0000000 --- a/www/_footer.aspx +++ /dev/null @@ -1,96 +0,0 @@ -
      -
      -
      -
      -
      - Newsletter - Features, releases, showcase... stay in the loop! -
      -
      -
      -
      - -
      -
      - -
      -
      -
      -
      -
      - -
      -
      - - - -
      -
      - © 2023 Nilesoft Ltd. - Privacy Policy | - Terms | about -
      -
      -
      - - - - - - - - - - - - - - - - - - - - - - - - - -
      -
      -
      -
      -
      - - - - - - - - diff --git a/www/_page.aspx b/www/_page.aspx deleted file mode 100644 index c980883..0000000 --- a/www/_page.aspx +++ /dev/null @@ -1,257 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - <%= pageName %> - Shell - - - - - - - - - - - - - - - - - - - - -
      - -
      -
      -

      Documents

      -
      -
      - Advertisement -
      - -
      -
      - -
      -
      -<% - -If Not includePage(requestedFile) Then - Response.StatusCode = 404 -%> -File Not Found -<% -End If - -%> -
      - -
      -     appRoot:        <%= appRoot.FullName %>
      -     projectRoot:    <%= projectRoot.FullName %>
      -     docsRoot:       <%= docsRoot.FullName %>
      -     requestUrl:     <%= requestUrl %>
      -     requestMap:     <%= requestMap %>
      -     requestedFile:  <%= requestedFile.FullName %>
      -     exists:         <%= requestedFile.Exists %>
      -     modified:       <%= fileModified %>
      -     accessed:       <%= Now() %>
      -
      -     pageName:       <%= pageName %>
      -     pageSlug:       <%= pageSlug %>
      -
      -     rootUrl:        <%= rootUrl %>
      -     fileUrl:        <%= fileUrl %>
      -     nilesoftUrl:    <%= nilesoftUrl %>
      -     gitUrl:         <%= gitUrl %>
      -
      -     SERVER_NAME:     <%= SERVER_NAME %>
      -     SERVER_PORT:     <%= SERVER_PORT %>
      -     HTTPS:           <%= HTTPS %>
      - 
      - -
      -

      - This page is - open source. Noticed a - typo? Or something unclear? -
      - - Improve this page on GitHub - -

      -
      -
      -
      - Advertisement -
      - -
      -
      -
      -
      -
      -
      - - - diff --git a/www/assets/css/glyphs.css b/www/assets/css/glyphs.css deleted file mode 100644 index f4e4bba..0000000 --- a/www/assets/css/glyphs.css +++ /dev/null @@ -1,245 +0,0 @@ -@font-face { - font-family: 'nilesoft.shell'; - font-style: normal; - font-weight: 400; - /*src: url('/assets/font/shell.woff2') format('woff2');*/ - src:url("../font/shell.eot?#iefix") format("embedded-opentype"), - url("../font/shell.woff2") format("woff2"), - url("../font/shell.woff") format("woff"), - url("../font/shell.ttf") format("truetype"), - url("../font/shell.svg#nilesoft-shell") format("svg"); -} - -#glyph li { - background-color: transparent; - color: black; - cursor: pointer; - float: left; - font-size: 32px; - font-family: 'nilesoft.shell' !important; - text-align: center; - height: 64px; - width: 64px; - padding-top: 6px; - margin: 0.5em 0.5em; -} - -#glyph li p { - text-align: center; - font: bold 9px Arial, sans-serif; - width: 100%; -} - -#glyph li:hover { - background-color: #000; - color: #fff !important; -} - -#glyph a {color: currentColor;} -#glyph a:hover {color: currentColor;} - -.glyph { - background-color: transparent; - color: black; - cursor: pointer; - font-size: 256px; - font-family: 'nilesoft.shell' !important; - text-align: center; -} - -.ig { - background-color: transparent; - color: black; - cursor: pointer; - font-family: 'nilesoft.shell' !important; - text-align: center; -} - - -i.g { - background-color: transparent; - font-family: 'nilesoft.shell' !important; - font-style:normal; - text-align: center; - cursor:default; - padding:0; - margin:0; -} - -.i { - font-family: 'nilesoft.shell' !important; - font-weight: 400; } - -.i { - -moz-osx-font-smoothing: grayscale; - -webkit-font-smoothing: antialiased; - display: inline-block; - font-style: normal; - font-variant: normal; - text-rendering: auto; - line-height: 1; } - -.i-lg { - font-size: 1.33333em; - line-height: 0.75em; - vertical-align: -.0667em; } - -.i-xs { - font-size: .75em; } - -.i-sm { - font-size: .875em; } - -.i-1x { - font-size: 1em; } - -.i-2x { - font-size: 2em; } - -.i-3x { - font-size: 3em; } - -.i-4x { - font-size: 4em; } - -.i-5x { - font-size: 5em; } - -.i-6x { - font-size: 6em; } - -.i-7x { - font-size: 7em; } - -.i-8x { - font-size: 8em; } - -.i-9x { - font-size: 9em; } - -.i-10x { - font-size: 10em; } - -.i-fw { - text-align: center; - width: 1.25em; } - -.i-ul { - list-style-type: none; - margin-left: 2.5em; - padding-left: 0; } - .i-ul > li { - position: relative; } - -.i-li { - left: -2em; - position: absolute; - text-align: center; - width: 2em; - line-height: inherit; } - -.i-border { - border: solid 0.08em #eee; - border-radius: .1em; - padding: .2em .25em .15em; } - -.i-pull-left { - float: left; } - -.i-pull-right { - float: right; } - -.i.i-pull-left { - margin-right: .3em; } - -.i.i-pull-right { - margin-left: .3em; } - -.i-spin { - animation: i-spin 2s infinite linear; } - -.i-pulse { - animation: i-spin 1s infinite steps(8); } - -@keyframes i-spin { - 0% { - transform: rotate(0deg); } - 100% { - transform: rotate(360deg); } } - -.i-rotate-90 { - -ms-filter: "progid:DXImageTransform.icrosoft.BasicImage(rotation=1)"; - transform: rotate(90deg); } - -.i-rotate-180 { - -ms-filter: "progid:DXImageTransform.icrosoft.BasicImage(rotation=2)"; - transform: rotate(180deg); } - -.i-rotate-270 { - -ms-filter: "progid:DXImageTransform.icrosoft.BasicImage(rotation=3)"; - transform: rotate(270deg); } - -.i-flip-horizontal { - -ms-filter: "progid:DXImageTransform.icrosoft.BasicImage(rotation=0, mirror=1)"; - transform: scale(-1, 1); } - -.i-flip-vertical { - -ms-filter: "progid:DXImageTransform.icrosoft.BasicImage(rotation=2, mirror=1)"; - transform: scale(1, -1); } - -.i-flip-horizontal.i-flip-vertical { - -ms-filter: "progid:DXImageTransform.icrosoft.BasicImage(rotation=2, mirror=1)"; - transform: scale(-1, -1); } - -:root .i-rotate-90, -:root .i-rotate-180, -:root .i-rotate-270, -:root .i-flip-horizontal, -:root .i-flip-vertical { - filter: none; } - -.i-stack { - display: inline-block; - height: 2em; - line-height: 2em; - position: relative; - vertical-align: middle; - width: 2.5em; } - -.i-stack-1x, -.i-stack-2x { - left: 0; - position: absolute; - text-align: center; - width: 100%; } - -.i-stack-1x {line-height: inherit; } -.i-stack-2x {font-size: 2em; } -.i-inverse {color: #fff; } - -.i-comment:before{content:"\E25C";} -.i-view:before{content:"\E12E";} -.i-time:before{content:"\E126";} -.i-edit:before{content:"\E0A1";} -.i-delete:before{content:"\E0B4";} -.i-tag:before{content:"\E177";} -.i-download:before{content:"\E0BC";} -.i-book:before{content:"\E1C2";} -.i-facebook:before{content:"\E244";} -.i-twitter:before{content:"\E242";} -.i-reddit:before{content:"\E23F";} -.i-github:before{content:"\E22B";} -.i-chevron-left:before{content:"\E007";} -.i-chevron-right:before{content:"\E008";} -.i-chevron-up:before{content:"\E009";} -.i-chevron-down:before{content:"\E00a";} -.i-grid:before{content:"\E097";} -.i-add:before{content:"\E160";} -.i-sub:before{content:"\E161";} -.i-user:before{content:"\E105";} -.i-user-setting:before{content:"\E0FE";} -.i-users:before{content:"\E107";} -.i-notification:before{content:"\E189";} -.i-email:before{content:"\E115";} -.i-rss-square:before{content:"\E29B";} -.i-rss:before{content:"\E29C";} \ No newline at end of file diff --git a/www/assets/css/main.css b/www/assets/css/main.css deleted file mode 100644 index 7cfd184..0000000 --- a/www/assets/css/main.css +++ /dev/null @@ -1,313 +0,0 @@ -html, body { - font-family: 'Open Sans', sans-serif; - color: #000000; -} - -/* footer */ -body { - display: flex; - min-height: 100vh; - flex-direction: column; -} - -#mst-main { - flex: 1; -} - -#mst-footer { - color: black; - background-color: white; -} - -ul.is-unstyled { - list-style: none; - margin: 0; - padding: 0; -} - -ul.is-styled { - padding-left: 3em; -} - -ul.is-styled-square { - list-style-type: square; - padding-left: 3em; -} - -.menu-list a { - padding: 0.5em 0.75em; -} - -.menu-list a:hover { - color: white; - background-color: black; -} - -.navbar-menu.is-white .navbar-start > a.navbar-item:focus, -.navbar-menu.is-white .navbar-start > a.navbar-item:hover, -.navbar-menu.is-white .navbar-start > a.navbar-item.is-active, -.navbar-menu.is-white .navbar-start .navbar-link:focus, -.navbar-menu.is-white .navbar-start .navbar-link:hover, -.navbar-menu.is-white .navbar-start .navbar-link.is-active, -.navbar-menu.is-white .navbar-end > a.navbar-item:focus, -.navbar-menu.is-white .navbar-end > a.navbar-item:hover, -.navbar-menu.is-white .navbar-end > a.navbar-item.is-active, -.navbar-menu.is-white .navbar-end .navbar-link:focus, -.navbar-menu.is-white .navbar-end .navbar-link:hover, -.navbar-menu.is-white .navbar-end .navbar-link.is-active { - background-color: black; - color: white; -} - -a.uline { - text-decoration: none; - border-bottom: 1px solid currentColor; -} - -/*a {text-decoration: underline;}*/ -a.underline { - text-decoration: underline; -} - -a.navbar-item.is-active, -.navbar-link.is-active, -.menu-list a.is-active { - background-color: black; - color: white; - border-bottom: 0; - text-decoration: none; -} - -/* -.navbar.is-white .navbar-brand .navbar-link::after { - border-color: #000000; -}*/ - -.syntax { - color: black; -} - -.syntax-comment { - color: #00aa00; -} - -.syntax-string { - color: #A7154F; -} - -.syntax-number { - color: #FF0080; -} - -.syntax-keyword { - color: #0000FF; -} - -.syntax-code { - font-weight: bolder; -} - -.syntax-prop { - color: #aaa; -} - -.paypal { - font-weight: bolder; -} - -.paypal i { - color: #007bff; -} - -.item-slide { - box-sizing: border-box; -} - -img.is-512 { - max-width: 512px; - max-height: 512px; -} - -img.is-256 { - max-width: 256px; - max-height: 256px; -} - -img.is-128 { - max-width: 128px; - max-height: 128px; -} - -img.is-100 { - max-width: 100%; - height: auto; -} - -img.is-75 { - max-width: 75%; - height: auto; -} - -img.is-50 { - max-width: 50%; - height: auto; -} - -img.is-25 { - max-width: 25%; - height: auto; -} - -.tags a.tag { - text-decoration-line: none; - background-color: black; - color: white; -} - -.tags a.tag:hover { - text-decoration-line: none; - background-color: #808080; -} - -.modal-content-image { - overflow: auto; - position: relative; - text-align: center; -} - -.size-32px { - height: 32px; - width: 32px; -} - -.h-32px { - height: 32px; -} - -.w-32px { - width: 32px; -} - -.border-left { - border-left: 1px solid #000; -} - -.border-right { - border-right: 1px solid #000; -} - -.border-top { - border-top: 1px solid #000; -} - -.border-bottom { - border-bottom: 1px solid #000; -} - -.post { - background-color: #fff; - border-radius: 0; - box-shadow: 0 .5em 1em -.125em rgba(10, 10, 10, .1), 0 0 0 1px rgba(10, 10, 10, .02); - color: #4a4a4a; - display: block; - padding: 0; - margin-block: 2rem; - /*max-height:200px; - min-height:200px*/ -} - -.post-image { - padding: 0; - margin: 0; -} - -img, video { - height: auto; - max-width: 100%; -} - -.opacity-25 { - opacity: 50; -} - -.opacity-50 { - opacity: 50; -} - -.opacity-75 { - opacity: 50; -} - -.modal-background-white { - background-color: rgba(255, 255, 255, .95); -} - -/** - * Generate links to be copied to anchor targets: - * - * First, make the target stand out to the left a bit, so that hovering gets activated more easily - */ -H1[id], -H2[id], -H3[id], -H4[id], -H5[id], -H6[id], -[id] > H1, -[id] > H2, -[id] > H3, -[id] > H4, -[id] > H5, -[id] > H6, -[id].copy-link, -[id].copy-link-child > :first-child { - z-index: 99; - margin-left: -1em; - padding-left: 1em; - position: relative; -} - -/* Then, on hovering, make it go even further to the left, so there is room for the link icon */ -H1[id]:hover, -H2[id]:hover, -H3[id]:hover, -H4[id]:hover, -H5[id]:hover, -H6[id]:hover, -[id] > H1:hover, -[id] > H2:hover, -[id] > H3:hover, -[id] > H4:hover, -[id] > H5:hover, -[id] > H6:hover, -[id].copy-link:hover, -[id].copy-link-child > :first-child:hover { - z-index: 99; - margin-left: -2em; - padding-left: 0.3em; - position: relative; -} - -/* And last, make the link icon appear to the left. */ -H1[id]:hover::before, -H2[id]:hover::before, -H3[id]:hover::before, -H4[id]:hover::before, -H5[id]:hover::before, -H6[id]:hover::before, -[id] > H1:hover::before, -[id] > H2:hover::before, -[id] > H3:hover::before, -[id] > H4:hover::before, -[id] > H5:hover::before, -[id] > H6:hover::before, -[id].copy-link:hover::before, -[id].copy-link-child > :first-child:hover::before { - content: '\01f517 \a0'; - cursor: pointer; -} - -/* Make the text in the toast align to the left, as it looks more smoothly. */ -.toast > li { - text-align: right; -} diff --git a/www/assets/css/prism.css b/www/assets/css/prism.css deleted file mode 100644 index 1a334b1..0000000 --- a/www/assets/css/prism.css +++ /dev/null @@ -1,166 +0,0 @@ -/* PrismJS 1.28.0 -https://prismjs.com/download.html#themes=prism&languages=markup+css+clike+c+csharp+cpp+json+makefile+markdown+cshtml+uri */ -/** - * prism.js default theme for JavaScript, CSS and HTML - * Based on dabblet (http://dabblet.com) - * @author Lea Verou - */ - -code[class*="language-"], -pre[class*="language-"] { - color: black; - background: none; - text-shadow: 0 1px white; - font-family: Consolas, Monaco, 'Andale Mono', 'Ubuntu Mono', monospace; - font-size: 1em; - text-align: left; - white-space: pre; - word-spacing: normal; - word-break: normal; - word-wrap: normal; - line-height: 1.5; - - -moz-tab-size: 4; - -o-tab-size: 4; - tab-size: 4; - - -webkit-hyphens: none; - -moz-hyphens: none; - -ms-hyphens: none; - hyphens: none; -} - -pre[class*="language-"]::-moz-selection, pre[class*="language-"] ::-moz-selection, -code[class*="language-"]::-moz-selection, code[class*="language-"] ::-moz-selection { - text-shadow: none; - background: #b3d4fc; -} - -pre[class*="language-"]::selection, pre[class*="language-"] ::selection, -code[class*="language-"]::selection, code[class*="language-"] ::selection { - text-shadow: none; - background: #b3d4fc; -} - -@media print { - code[class*="language-"], - pre[class*="language-"] { - text-shadow: none; - } -} - -/* Code blocks */ -pre[class*="language-"] { - padding: 1em; - margin: .5em 0; - overflow: auto; -} - -:not(pre) > code[class*="language-"], -pre[class*="language-"] { - background: #f5f5f5; -} - -/* Inline code */ -:not(pre) > code[class*="language-"] { - padding: .1em; - border-radius: .3em; - white-space: normal; -} - -.token.comment, -.token.prolog, -.token.doctype, -.token.cdata { - color: #080; -} - -.token.punctuation { - color: #999; -} - -.token.namespace { - opacity: .7; -} - -.token.symbol, -.token.deleted { - color: #00f; -} - -.token.numbers { - color: #f00; -} - -.token.keyword, -.token.boolean { - color: #00f; -} - -.token.color { - color: #f00; -} - -.token.char { - color: #da1039; -} - -.token.string { - color: #da1039; -} - -.token.operator, -.token.entity, -.token.url, -.language-css .token.string, -.style .token.string { - color: #9a6e3a; - /* This background color was intended by the author of this theme. */ - background: hsla(0, 0%, 100%, .5); -} - -.token.atrule, -.token.attr-value { - color: #07a; -} - -.token.function { - color: #00a; - font-weight: bold; -} - -.token.item { - /*color: #f0f; - font-weight: bold;*/ -} - -.token.property { - /*color: #a0a;*/ -} - -.token.class-name { - /*color: #f0f;*/ - font-weight: bold; -} - -.token.regex, -.token.important, -.token.variable { - color: #e90; -} - -.token.important, -.token.bold { - font-weight: bold; -} -.token.italic { - font-style: italic; -} - -.token.entity { - cursor: help; -} - -.token.sections{ -font-weight: bold; -} diff --git a/www/assets/font/shell.eot b/www/assets/font/shell.eot deleted file mode 100644 index d153e9f..0000000 Binary files a/www/assets/font/shell.eot and /dev/null differ diff --git a/www/assets/font/shell.svg b/www/assets/font/shell.svg deleted file mode 100644 index b95e2d5..0000000 --- a/www/assets/font/shell.svg +++ /dev/null @@ -1,2709 +0,0 @@ - - - - -Created by FontForge 20201107 at Wed Jun 29 20:28:19 2022 - By Unknown - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/www/assets/font/shell.ttf b/www/assets/font/shell.ttf deleted file mode 100644 index f8d46a7..0000000 Binary files a/www/assets/font/shell.ttf and /dev/null differ diff --git a/www/assets/font/shell.woff b/www/assets/font/shell.woff deleted file mode 100644 index e3502d8..0000000 Binary files a/www/assets/font/shell.woff and /dev/null differ diff --git a/www/assets/font/shell.woff2 b/www/assets/font/shell.woff2 deleted file mode 100644 index 8df90c9..0000000 Binary files a/www/assets/font/shell.woff2 and /dev/null differ diff --git a/www/assets/js/main.js b/www/assets/js/main.js deleted file mode 100644 index 8332e9c..0000000 --- a/www/assets/js/main.js +++ /dev/null @@ -1,202 +0,0 @@ -$(async => { - var root = $(document.documentElement); - var body = $('body'); - // Check for click events on the navbar burger icon - $('.navbar-burger').click(() => { - // Toggle the "is-active" class on both the "navbar-burger" and the "navbar-menu" - $(this).toggleClass('is-active'); - $('.navbar-menu').toggleClass('is-active'); - }); - $('.lightbox').click(function (link) { - link.preventDefault(); - var lightbox = $(this); - if (!lightbox.is('a') && !lightbox.hasClass('lightbox')) - return 'Clicked item is not a link with class .lightbox'; - var modal = $(''); - modal.append($(''), - $('').attr('src', lightbox.children('img').attr('src'))); - body.append(modal); - root.addClass('is-clipped'); - $(modal).click(() => { - root.removeClass('is-clipped'); - modal.remove(); - }); - $(document).keydown((event) => { - var e = event || window.event; - if (e.keyCode === 27) { - root.removeClass('is-clipped'); - modal.remove(); - } - }); - }); - - var Ubevca = async => { - var XTaDIdsy = () => { - if (typeof gtag !== 'undefined') { - gtag('event', 'adblock'); - } - var EEvTIiaA = $(''); - body.append(EEvTIiaA); - root.addClass("is-clipped"); - } - (async => { - var GyqcGnd = 0; - $('ins.adsbygoogle').each((i, e) => { - const x = $(e).get(0); - if (x.offsetLeft > -100 && x.offsetTop > -50 && (x.offsetHeight > 0 && x.offsetWidth > 0)) { - GyqcGnd++; - } - }); - if (GyqcGnd === 0) { - XTaDIdsy(); - } else try { - fetch("https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js", { - method: "HEAD", - mode: "no-cors" - }) - .catch((err) => { - XTaDIdsy(); - }); - } catch (e) { - XTaDIdsy(); - } - })(); - }; - - /** - * Function to copy a text to the clipboard - **/ - function copyTextToClipboard(text) { - const textarea = document.createElement('textarea'); - const selection = document.getSelection(); - const range = document.createRange(); - - textarea.textContent = text; - document.body.appendChild(textarea); - - range.selectNode(textarea); - selection.removeAllRanges(); - selection.addRange(range); - - const result = document.execCommand('copy'); - - document.body.removeChild(textarea); - - return result; - } - - /** - * Function to dynamically load CSS with a single request. - * - * @see: https://stackoverflow.com/a/46984311/3102305 - */ - $.extend({ - getCss: function (url, success) { - - if ($("head").children("style[data-url='" + url + "']").length) { - console.warn("CSS file already loaded: " + url); - } - - var deferred = $.Deferred(function (defer) { - $.ajax({ - url: url - , context: {defer: defer, url: url} - , dataType: 'text' - , cache: (function () { - let cache = $.ajaxSetup().cache; - if (cache === undefined) { - cache = false; - } - return cache; - })() - }) - .then( - function (css, textStatus, jqXHR) { - css = "\n\n/* CSS dynamically loaded by jQuery */\n\n" + css; - $('').appendTo("head"); - this.defer.resolve(css, textStatus, jqXHR); - } - , function (jqXHR, textStatus, errorThrown) { - this.defer.reject(jqXHR, textStatus, errorThrown); - } - ); - }); - if ($.isFunction(success)) { - deferred.done(success); - } - return deferred; - } - }); - - /** - * Append event listener to the elements that shall get the icon to copy the anchored link - */ - document.querySelectorAll( - 'h1[id], h2[id], h3[id], h4[id], h5[id], h6[id], ' + - '[id]>h1, [id]>h2, [id]>h3, [id]>h4, [id]>h5, [id]>h6, ' + - '[id].copy-link-child > :first-child' - ).forEach(function (element) { - element.addEventListener("click", function (event) { - - const id = event.target.id !== '' - ? event.target.id - : event.target.parentElement.id - - const page = window.location.href - .replace(/#.*$/, ''); - - const link = page + '#' + id; - const nilesoft = link - .replace(/^https?:\/\/[^/]+/, 'https://nilesoft.org'); - - const emAsPx = parseFloat(getComputedStyle(event.target).fontSize); - const em2 = 2 * emAsPx - - const hitLinkIcon = event.layerX < em2; - - /*console.log({ - emAsPx: emAsPx, - em2: em2, - layerX: event.layerX, - clientX: event.clientX, - doCopy: hitLinkIcon, - link: link, - offsetLeft: event.target.offsetLeft, - parentOffsetLeft: event.target.parentElement.offsetLeft, - parentClass: event.target.parentElement.className, - event: event - })*/ - - if (hitLinkIcon) { - const result = copyTextToClipboard(nilesoft); - if (result) { - console.log('copied: ' + nilesoft); - - const toast = function () { - $.toast.config.align = 'right'; - $.toast('' + nilesoft + '
      copied to clipboard!', { - type: 'info', - duration: 3000, - }); - } - - if ($.toast === undefined) { - console.log('loading jquery.toast ...') - // @see: https://github.com/Soldier-B/jquery.toast - $.getCss( - "/assets/lib/jquery.toast/jquery.toast.min.css", - $.getScript( - "/assets/lib/jquery.toast/jquery.toast.min.js" - , toast - ) - ); - } else { - toast(); - } - - window.location.href = link; - } - } - }); - }); -}); \ No newline at end of file diff --git a/www/assets/js/prism.js b/www/assets/js/prism.js deleted file mode 100644 index 9a962bd..0000000 --- a/www/assets/js/prism.js +++ /dev/null @@ -1,1327 +0,0 @@ -/* PrismJS 1.28.0 -https://prismjs.com/download.html#themes=prism&languages=clike+csharp */ -/// - -var _self = (typeof window !== 'undefined') - ? window // if in browser - : ( - (typeof WorkerGlobalScope !== 'undefined' && self instanceof WorkerGlobalScope) - ? self // if in worker - : {} // if in node js - ); - -/** - * Prism: Lightweight, robust, elegant syntax highlighting - * - * @license MIT - * @author Lea Verou - * @namespace - * @public - */ -var Prism = (function (_self) { - - // Private helper vars - var lang = /(?:^|\s)lang(?:uage)?-([\w-]+)(?=\s|$)/i; - var uniqueId = 0; - - // The grammar object for plaintext - var plainTextGrammar = {}; - - - var _ = { - /** - * By default, Prism will attempt to highlight all code elements (by calling {@link Prism.highlightAll}) on the - * current page after the page finished loading. This might be a problem if e.g. you wanted to asynchronously load - * additional languages or plugins yourself. - * - * By setting this value to `true`, Prism will not automatically highlight all code elements on the page. - * - * You obviously have to change this value before the automatic highlighting started. To do this, you can add an - * empty Prism object into the global scope before loading the Prism script like this: - * - * ```js - * window.Prism = window.Prism || {}; - * Prism.manual = true; - * // add a new