Publish

To make your changes accessible to other users, you need to publish them.

Local Storage of Changes: Until publication (i.e., git commit + git push), all changes remain stored locally on your computer in the current branch.

Pre-Publication Synchronization: Sync the catalog to the latest version before publishing to resolve any potential conflicts.

Selective Publishing: You can publish selected articles or all articles at once.

Each publication automatically generates a comment, which will be saved in Git storage as the commit message. This comment can be edited if needed.

Reverting Local Changes: Local changes can be reverted before publication. Once published, reverting changes in Gramax is no longer possible.

Publish Changes

  1. Click the cloud icon in the repository status bar.

  2. If necessary, enable Advanced Mode to show detailed information about added and removed lines and article resources.

  3. Review the changes in the articles.

  4. Select the articles to publish. By default, all are selected.

  5. Click Publish.

Frequently Asked Questions

Why is there no publish button in my catalog?

Any changes are published to a storage. Therefore, the catalog must be connected to one of them.

  • The catalog was uploaded from the storage, but the connection is not established — click the storage icon and fill in the storage details.

  • The catalog exists only locally — click the storage icon, add it, and publish the catalog.

How to revert changes in an article?

Before publication: If you need to revert local changes that have not yet been published.

Open the changes publication window and click Discard changes next to the article.

After publication: If you need to revert changes when the article has already been published.

The function to revert to a previous version is not available in Gramax. However, you can republish the article. To do this:

  1. Open the article and click Show history in the article menu.

  2. Select one of the versions, copy the article's content, and close the change history.

  3. In the article menu, click Edit Markdown and paste the content from the clipboard.

  4. Publish the changes.

The catalog was uploaded from the repository, but a strikethrough cloud icon is displayed in the status bar

Your access token to the repository has expired. Re-add the storage, and the catalog will automatically connect to the repository.