Skip to content

Latest commit

 

History

History
50 lines (37 loc) · 2.31 KB

select-files.md

File metadata and controls

50 lines (37 loc) · 2.31 KB
Raw

Select YAML files

Meety can load meeting specifications from multiple YAML files. This way, you can, for example, manage the meetings for Conference A and those for Lecture B in different files.

Options

By default, Meety attempts to load all files with extensions .yaml or .yml

  • in the current working directory of the application and
  • in the user's home directory, usually
    • /home/<username>/ on Linux,
    • /Users/<username>/ on MacOS and
    • C:\Users\<username>\ on Windows

You can prevent this by using the option --only-explicit or -e when you invoke Meety.

Explicit loading of files. Via the option -f FILE or --file FILE you can explicitly define a YAML file FILE from which Meety loads meeting specifications. This option can be used repeatedly.

Explicit loading from directories. In a similar fashion you can ask Meety to load all YAML files from a given directory using the -d DIRECTORY or --directory DIRECTORY option. This option can be used repeatedly too.

Permanently set paths. Instead of providing options on every invocation of Meety you can add them to the configuration file. This way, they are used automatically on each invocation. This is described in more detail in the section on default arguments of the configuration documentation.

Example

As an example let us assume that the following files and directories are in your home directory.

friends.yaml
work.yaml
meetings/
    conferenceA.yaml
    lectureB.yaml

Let us consider some combinations of options (assuming that you invoke Meety in the home directory):

  • No options. Both files in the home directory are loaded:
    • friends.yaml
    • work.yaml
  • Explicit files (-f meetings/lectureB.yaml). The named file is loaded additionally, resulting in three loaded files:
    • friends.yaml
    • work.yaml
    • meetings/lectureB.yaml
  • Only explicit file (-e -f meetings/lectureB.yaml). The files in the home directory are not loaded anymore, resulting in a single loaded file:
    • meetings/lectureB.yaml
  • Explicit directory (-d meetings). All files in the given directory are loaded additionally, resulting in four loaded files:
    • friends.yaml
    • work.yaml
    • meetings/conferenceA.yaml
    • meetings/lectureB.yaml