LDMakeList: Difference between revisions

From LDraw.org Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Software
{{Software
|developer=Tim Gould
|logo            = {{software/logo|CMD icon.png}}
|function=Library utility
|developer       = [[Meet Tim Gould|Tim Gould]]
|version=2.01
|version         = 2.14 {{comment|2013-10-06}}
|platform=Windows
|operating system = Microsoft Windows<br>Mac OS X
|website=[http://code.google.com/p/ldmakelist/ LDMakeList]
|language        = English
|genre            = Library utility
|license          = GNU GPL
|website         = [http://code.google.com/p/ldmakelist code.google.com/p/ldmakelist]
}}
}}
'''LDMakeList''' is a tool created by [[Meet Tim Gould|Tim Gould]] as a replacement for the default '''mklist.exe''' that is included with LDraw.
'''{{PAGENAME}}''' is a tool created by Tim Gould as a replacement for the default [[mklist]] that is currently included with [[LDraw]].


LDMakeList has a number of advantages over mklist.exe, including:
It has a number of advantages over mklist, including:
* The ability to disregard parts whose names begin with certain characters, by using the -h command, meaning that colour aliases and other parts that are defined with leading character such as _ or ~ are not listed.
 
* Different sorting options (eg. -d for description, -n for filename, -p to leave patterns at the end)
* The ability to disregard parts whose names begin with certain characters, by using the {{code|-h}} command, meaning that colour aliases and other parts that are defined with leading character such as {{code|_}} or {{code|~}} are not listed.
* The ability to shorten long descriptions to ensure compatibility with older LDraw software
* Different sorting options (eg. {{code|-d}} for description, {{code|-n}} for filename, {{code|-p}} to leave patterns at the end).
* The ability to shorten long descriptions to ensure compatibility with older LDraw software.
 
LDMakeList is included with the [[LDraw All-In-One Installer]].


==Usage==
==Usage==
By running the executable file, the following information is supplied:
<pre style="display:inline-block">LDMakeList
 
<pre style="overflow:auto;">LDList
Use -? for help, -v for version
Use -? for help, -v for version
Valid options are:
Valid options are:
Line 25: Line 29:
-m or -M : include pri_M_itives in the list
-m or -M : include pri_M_itives in the list
-u or -U : include _U_nofficial part directory
-u or -U : include _U_nofficial part directory
-a or -A : exclude _A_liases from the list
-r or -R : _R_emove duplicate entries (experimental)
-r or -R : _R_emove duplicate entries (experimental)
-o or -O : Include _o_fficial parts only
-o or -O : Include _o_fficial parts only
Line 32: Line 37:
-x or -X : do not write parts._x_ml file
-x or -X : do not write parts._x_ml file


e.g. "LDList -d -h=_ -i~" will generate a parts.lst file sorted by
eg. "LDMakeList -d -h=_ -i~" will generate a parts.lst file sorted
description excluding colour and part aliases and removing the
by description (-d), excluding colour = and some parts _ (-h=_),
~ character from the start of descriptions
and removing the ~ character (-i~) from the start of descriptions
 
The -L tag lets you select the base directory for your LDraw
installation (defaults to environment variable LDRAWDIR)
eg. "LDMakeList -d -L." sorts by descriptions in the present
directory
 
eg. "LDMakeList -u" will look in [LDRAWDIR]/Unofficial/Parts
as well as [LDRAWDIR]/Parts for part files
 
The -m tag is not recommended for beginner LDraw users


* The old limit for part descriptions is 64 characters and it is
* The old limit for part descriptions is 64 characters and it is
Line 43: Line 58:
Sort by [D]escription or [N]umber?</pre>
Sort by [D]escription or [N]umber?</pre>


Selecting either D or N will arrange the data in the outputted parts.lst file in a certain order. The option to select D or N will not appear if the option -d or -n or -p is selected.
Selecting either {{code|D}} or {{code|N}} will arrange the data in the outputted {{code|parts.lst}} file in a certain order. The option to select {{code|D}} or {{code|N}} will not appear if the option {{code|-d}} or {{code|-n}} or {{code|-p}} is selected.


By running the application from the command line, the other switches can also be enabled or disabled.
By running the application from the command line, the other switches can also be enabled or disabled.
==Mac installation==
Instructions for Mac (NB. you probably require [http://en.wikipedia.org/wiki/OS_X_Mavericks OS X Mavericks] to run this)
# Save {{code|LDMakeList-2.14-Mac.tar}} ([https://drive.google.com/folderview?id=0B1sfkk_j3usWdEYzNkNaNW5PbjA&usp=sharing|from here]) without changing its filename into your LDraw directory.
# Double-click on it in {{code|Finder}}, then go into the directory it creates.
# Double-click on {{code|RunLDMakeList}}, it will run with {{code|-d}} in the parent directory.
# If you extract to anywhere else, first copy {{code|LDMakeList}} and {{code|RunLDMakeList}} into your LDraw directory, and then run.[1]
'''NB''' Mac power users may also use {{code|Terminal.app}}, then {{code|cd}} into the LDraw directory, then run {{code|LDMakeList}} with any of the command line arguments listed above.
[1] This strips {{code|LDMakeList-Mac}} off the end of the script's directory if present, and runs there. If not present, it simply runs in the script's directory.
==See also==
* [[makelist]]
* [[makelst2]]
* [[mklist]]


==External links==
==External links==
*[http://code.google.com/p/ldmakelist/ LDMakeList] on Google Code Project Hosting
* [http://code.google.com/p/ldmakelist/ LDMakeList] on Google Code Project Hosting
 
* [https://drive.google.com/folderview?id=0B1sfkk_j3usWdEYzNkNaNW5PbjA&usp=sharing LDMakeList 2.14] on Google Drive
[[Category:Software]]

Latest revision as of 17:03, 26 January 2015

LDMakeList
Developer(s) Tim Gould
Initial release unknown
Current version 2.14 (2013-10-06)
Development status unknown
Operating system Microsoft Windows
Mac OS X
Available in English
Type Library utility
License GNU GPL
Website code.google.com/p/ldmakelist
Software infobox

LDMakeList is a tool created by Tim Gould as a replacement for the default mklist that is currently included with LDraw.

It has a number of advantages over mklist, including:

  • The ability to disregard parts whose names begin with certain characters, by using the -h command, meaning that colour aliases and other parts that are defined with leading character such as _ or ~ are not listed.
  • Different sorting options (eg. -d for description, -n for filename, -p to leave patterns at the end).
  • The ability to shorten long descriptions to ensure compatibility with older LDraw software.

LDMakeList is included with the LDraw All-In-One Installer.

Usage

LDMakeList
Use -? for help, -v for version
Valid options are:
-d or -D : sort by _D_escription (default)
-n or -N : sort by file_N_ame
-p or -P : sort by description (_P_atterns at end of file)
-s or -S : use _S_hort descriptions*
-m or -M : include pri_M_itives in the list
-u or -U : include _U_nofficial part directory
-a or -A : exclude _A_liases from the list
-r or -R : _R_emove duplicate entries (experimental)
-o or -O : Include _o_fficial parts only
-l[DIRNAME] or -L[DIRNAME] : Read from _L_Draw director DIRNAME
-h[C] or -H[C] : -H_ide descriptions starting with character(s) [C]
-i[C] or -I[C] : str_I_p leading character(s) [C] from descriptions
-x or -X : do not write parts._x_ml file

eg. "LDMakeList -d -h=_ -i~" will generate a parts.lst file sorted
by description (-d), excluding colour = and some parts _ (-h=_),
and removing the ~ character (-i~) from the start of descriptions

The -L tag lets you select the base directory for your LDraw
installation (defaults to environment variable LDRAWDIR)
eg. "LDMakeList -d -L." sorts by descriptions in the present
directory

eg. "LDMakeList -u" will look in [LDRAWDIR]/Unofficial/Parts
as well as [LDRAWDIR]/Parts for part files

The -m tag is not recommended for beginner LDraw users

* The old limit for part descriptions is 64 characters and it is
possible that descriptions longer than this might break some
old software. This ensures that the output filenames are no
longer than 64 characters. Use if programs are giving errors.

Sort by [D]escription or [N]umber?

Selecting either D or N will arrange the data in the outputted parts.lst file in a certain order. The option to select D or N will not appear if the option -d or -n or -p is selected.

By running the application from the command line, the other switches can also be enabled or disabled.

Mac installation

Instructions for Mac (NB. you probably require OS X Mavericks to run this)

  1. Save LDMakeList-2.14-Mac.tar (here) without changing its filename into your LDraw directory.
  2. Double-click on it in Finder, then go into the directory it creates.
  3. Double-click on RunLDMakeList, it will run with -d in the parent directory.
  4. If you extract to anywhere else, first copy LDMakeList and RunLDMakeList into your LDraw directory, and then run.[1]

NB Mac power users may also use Terminal.app, then cd into the LDraw directory, then run LDMakeList with any of the command line arguments listed above.

[1] This strips LDMakeList-Mac off the end of the script's directory if present, and runs there. If not present, it simply runs in the script's directory.

See also

External links