spiegel-keyman/developer/docs/help/context/new-project-parameters.md
Marc Durdin b751336c13 refactor(developer): copy dev 17.0 help into repo
1. Copy help.keyman.com/developer/17.0/* into /developer/docs/help
2. Update references to 18.0 where appropriate
3. Copy all referenced images from /cdn/dev into
   /developer/docs/help/images and update links in documentation

Next commit: add deployment to help-keyman-com.sh. Note: simplest way to
test links at this point is to use the help.keyman.com auto deploy and
wait for the PR on help.keyman.com to be validated; we could look at an
internal link validation tool that verifies markdown links?

Relates-to: #12347
2024-09-16 08:46:24 +07:00

59 lines
No EOL
2.2 KiB
Markdown

---
title: New Project Parameters Dialog
---
![New Project Parameters dialog](../images/ui/frmNewProjectParameters.png)
Allows you to quickly fill in common parameters for a new keyboard
project, adding keyboard, package, documentation and metadata files,
following the [file layout](/developer/keyboards/) used in the [Keyman keyboards repository](https://github.com/keymanapp/keyboards).
Projects can also be created from the command line with
[KMConvert](kmconvert).
### Parameters
Keyboard Name
: The descriptive name of the keyboard. This will be set in the
[`&Name`](/developer/language/reference/name) store in the keyboard,
in the package name, and where appropriate in documentation and
metadata.
Copyright
: A copyright string for the keyboard. This will be set in the
[`&Copyright`](/developer/language/reference/copyright) store in the
keyboard, in the package metadata, and where appropriate in
documentation and metadata.
Version
: The initial version number of the keyboard. This should follow the
format specified in the
[`&Keyboardversion`](/developer/language/reference/keyboardversion)
store for the keyboard. This will be set also in the package
metadata, and where appropriate in documentation and metadata.
Author
: The name of the developer of the keyboard. This will be set in the
package metadata, and where appropriate in documentation and
metadata.
Targets
: Specifies the default deployment targets for the keyboard, set in
the [`&Targets`](/developer/language/reference/targets) store in the
keyboard, and controls the files added to the package initially.
This also is reflected in documentation and metadata.
Languages
: Specifies the default BCP 47 language tags which will be added to
the package metadata and project metadata.
Path
: Specifies the base path where the project folder will be created.
The project folder name will be the keyboard ID. If the folder
already exists, then you will be prompted before Keyman Developer
overwrites files inside it.
Keyboard ID
: The base filename of the keyboard, project and package. This must
conform to the Keyman keyboard identifier rules, using the
characters a-z, 0-9 and _ (underscore) only.