Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/introduction.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ The client [JavaScript library](js-sdk/getting-started/overview.mdx) enables **w

### Prerelease libraries

The [C++/C](c2pa-c//readme.md), [Python](c2pa-python/readme.md), and [Node.js](c2pa-node/readme.md) libraries enable applications written in those languages to **create, verify, and display Content Credentials**.
The [C++/C](c2pa-c/readme.md), [Python](c2pa-python/readme.md), and [Node.js](c2pa-node/readme.md) libraries enable applications written in those languages to **create, verify, and display Content Credentials**.

:::warning Warning
These libraries are all early prerelease versions. They may have bugs and unimplemented features, and their APIs are subject to change.
Expand Down
2 changes: 1 addition & 1 deletion docs/manifest/assertions-actions.md
Original file line number Diff line number Diff line change
Expand Up @@ -478,4 +478,4 @@ For example, the following action identifies that the `c2pa.opened` action was p

This documentation covers C2PA v1 actions. The [C2PA Technical Specification](https://c2pa.org/specifications/specifications/1.4/specs/C2PA_Specification.html#_actions) also describes expanded v2 actions. V1 actions are fully specified in the actions array. However, a v2 action may either be specified by an element of the actions array or from an element in the templates array with the same action name.

There are some additional differences between v1 and v2 actions, for example in v2, `softwareAgent` is a [ClaimGeneratorInfo](../manifest/manifest-ref#claimgeneratorinfo) structure instead of a string. The CAI APIs can read all v2 actions and write most v2 actions.
There are some additional differences between v1 and v2 actions, for example in v2, `softwareAgent` is a [ClaimGeneratorInfo](../manifest/manifest-ref.mdx#claimgeneratorinfo) structure instead of a string. The CAI APIs can read all v2 actions and write most v2 actions.
4 changes: 2 additions & 2 deletions docs/manifest/examples.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,15 @@ import CodeBlock from '@theme/CodeBlock';

## C2PA test files

The C2PA [public-testfiles](https://github.com/c2pa-org/public-testfiles) repository contains numerous examples of asset files with Content Credentials. See https://c2pa.org/public-testfiles/ for links to easily inspect each asset file using Verify using [an asset URL](../verify#entering-an-asset-url) and to the corresponding [manifest report](../c2patool/#displaying-manifest-data) and [detailed manifest report](../c2patool/#detailed-manifest-report) from C2PA Tool.
The C2PA [public-testfiles](https://github.com/c2pa-org/public-testfiles) repository contains numerous examples of asset files with Content Credentials. See https://c2pa.org/public-testfiles/ for links to easily inspect each asset file using Verify using [an asset URL](../verify.mdx#using-an-asset-url) and to the corresponding [manifest report](../c2patool/docs/usage.md#displaying-manifest-data) and [detailed manifest report](../c2patool/docs/usage.md#detailed-manifest-report) from C2PA Tool.

:::note
The claims on these test files were signed with C2PA Tool's built-in test certificate and key (which is not on the [known certificate list](../trust-list.mdx)). Thus, Verify will display the warning: "The Content Credential issuer couldn’t be recognized. This file may not come from where it claims to."
:::

## Examples from C2PA Tool

The command-line [C2PA Tool](/docs/c2patool), `c2patool`, is helpful when developing applications to work with manifest data. When saving a manifest, it has two modes:
The command-line [C2PA Tool](../c2patool/readme.md), `c2patool`, is helpful when developing applications to work with manifest data. When saving a manifest, it has two modes:

- **Standard mode** (the default), where it saves a manifest file in JSON format, which is simplified and slightly different from the underlying binary manifest structure.
- **Detailed mode** (specified with the `-d` option), where it saves a file that more closely reflects the actual structure of the binary data, including assertions with JUMBF URLs and their associated hashes.
Expand Down
2 changes: 1 addition & 1 deletion docs/manifest/ingredients.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ The C2PA Technical Specification describes _ingredient assertions_ but the CAI S

Each ingredient used to create an asset is listed in the [JSON manifest](manifest-ref.mdx) `ingredients` array. When an ingredient itself has Content Credentials, those manifests are included in the composed asset's manifest store to keep the provenance data intact.

The `ingredients` array contains an [ingredient object](manifest-ref#ingredient) for each ingredient. The only required property of the `ingredient` object is the `title` property, which usually is the source file name.
The `ingredients` array contains an [ingredient object](manifest-ref.mdx#ingredient) for each ingredient. The only required property of the `ingredient` object is the `title` property, which usually is the source file name.

Other important properties of the ingredient object include:
- `format`: MIME type of the source file.
Expand Down
4 changes: 2 additions & 2 deletions docs/manifest/signing-manifests.md
Original file line number Diff line number Diff line change
Expand Up @@ -163,7 +163,7 @@ Certificate:
.
```

You now have all the needed information to configure C2PA Tool for manifest signing. Edit your [manifest store file](/docs/c2patool/manifest) to have the following content:
You now have all the needed information to configure C2PA Tool for manifest signing. Edit your [manifest store file](../c2patool/docs/manifest.md) to have the following content:

```json
"alg": "ps256",
Expand All @@ -173,7 +173,7 @@ You now have all the needed information to configure C2PA Tool for manifest sign

The `private_key` and `sign_cert` properties must be full paths to the key and certificate chain files generated above.

You can now use C2PA Tool [to add a manifest to an image or other asset file](../c2patool/readme.md#adding-a-manifest-to-an-asset-file). The command will be something like this:
You can now use C2PA Tool [to add a manifest to an image or other asset file](../c2patool/docs/usage.md#adding-a-manifest-to-an-asset-file). The command will be something like this:

```
c2patool -m my_manifest.json -o signed_image.jpg my_image.jpg
Expand Down
2 changes: 1 addition & 1 deletion docs/manifest/validation.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Don't assume that just because you didn't get an error from the function return

Ingredients are validated when they are imported into an asset and the result is stored in the ingredient's `validation_status` array.

Only errors that are not already recorded in the `validation_status` of an ingredient are reported. See [ValidationStatus](./manifest-ref#validationstatus) object in Manifest store reference.
Only errors that are not already recorded in the `validation_status` of an ingredient are reported. See [ValidationStatus](./manifest-ref.mdx#validationstatus) object in Manifest store reference.

## Error status codes

Expand Down