@@ -122,7 +122,7 @@ manager. Type checking is ensured through
122122Set up the development environment with:
123123
124124``` sh
125- uv sync --dev --extra workflows
125+ $ uv sync --dev --extra workflows
126126```
127127
128128from within the project’s checked out repository. The `--extra
@@ -133,7 +133,7 @@ workflows.
133133To test seeding a ODK repository:
134134
135135``` sh
136- uv run odk seed -C config.yaml -g [other seeding options...]
136+ $ uv run odk seed -C config.yaml -g [other seeding options...]
137137```
138138
139139Note the ` -g ` option, which instructs the seeding process not to try
@@ -146,36 +146,39 @@ ODK-Core was checked out. To run a `odk` command from anywhere else, use
146146UV’s ` --project ` option:
147147
148148``` sh
149- uv --project /path/to/odk-core run odk seed -C config.yaml -g [...]
149+ $ uv --project /path/to/odk-core run odk seed -C config.yaml -g [...]
150150```
151151
152152I’d recommend setting up an alias like:
153153
154154``` sh
155- alias odk-dev=" uv --project /path/to/odk-core run odk"
155+ $ alias odk-dev=" uv --project /path/to/odk-core run odk"
156156```
157157
158158so that you can use ` odk-dev ` from anywhere, e.g. try seeding a
159159repository with:
160160
161161``` sh
162- odk-dev seed -g -C config.yaml [...]
162+ $ odk-dev seed -g -C config.yaml [...]
163163```
164164
165- Note the ` -g ` option in the ` seed ` commands above: it instructs the
166- seeding script _ not_ to build the ontology in the newly seeded
167- repository. This is because building the ontology would require a full
168- ODK environment.
169-
170- To be able to test building the ontology (or running any kind of ODK
171- workflows more generally), first create a native ODK environment, then
172- activate it:
165+ To be able to test running a ODK workflow, instead of merely seeding a
166+ ODK repository, first create a native ODK environment, then activate it:
173167
174168``` sh
175169$ odk-dev install /my/test/env
176170$ . /my/test/env/bin/activate-odk-environment.sh
177171```
178172
173+ It is then possible to seed a repository without skipping the building
174+ of the initial release, and more generally to run any workflow within
175+ the newly seeded repository:
176+
177+ ``` sh
178+ $ odk-dev seed -C config.yaml [...]
179+ $ cd target/< myont> /src/ontology
180+ $ make clean refresh-imports
181+ ```
179182
180183Copying
181184-------
0 commit comments