Writing on Kauri
Writing on Kauri
Welcome to Kauri, we're excited to help you share your knowledge across the world via the Ethereum ecosystem.
We've tried to make contributing as smooth as possible, but since Kauri is in beta, contact us with comments, concerns, criticism, or any form of feedback by emailing firstname.lastname@example.org.
Now on to the good stuff.
Download and Configure Metamask
Metamask is a browser extension that gives you access to your Ethereum accounts in the browser. Add the MetaMask extension to your browser and follow the setup instructions. Set MetaMask to the "Rinkeby" network when using Kauri.
Sign In to Kauri
Kauri uses Metamask to associate your posts with an Ethereum address and allow for bounties to be paid for your posts. Click the Sign In button beneath the profile picture in the top right, and click Sign on the MetaMask popup to complete the process (this is not a transaction, and doesn't cost you any ETH).
Edit Your Profile
While not required, adding profile details gives readers extra details about you, and adds a username to your articles. Kauri keeps your email address private, and we use it for notifications.
The first page of your profile displays your account details and five sub-sections.
- Articles: Shows all your published articles.
- Drafts: Shows all your unpublished draft articles.
- Collections: Shows all the article collections you created.
- Awaiting Owner Approval: Shows changes to articles you have submitting awaiting approval by their owner.
- Pending My Approval: Shows changes to your articles submitted by others awaiting your approval.
Writing an Article
To write an article, select Create in the top right corner, and click Write Article from the drop-down.
Clicking this button takes you to the editor interface. The editor supports Markdown and has a rich-text menu if you're new to Markdown or have forgotten any of the syntax. You can find a helpful Markdown cheatsheet here.
You can upload PNG, GIF or JPEG images of up to 10 MB in size from the editor toolbar using the rightmost image button. You can also click the link above the upload box to add an image from a remote location. This uploads the image to IPFS and creates a markdown image tag with the URL auto-filled.
If you have an image already hosted elsewhere you want to use, click the leftmost image button on the editor toolbar and add the URL to the markdown image tag.
You can't upload videos to Kauri, but to embed videos hosted elsewhere, click the video button in the editor toolbar, paste the video into the popup box and an HTML embed tag is created for you.
If you want to preview the final content, select the Preview tab.
When you're finished, you can save the article as a draft using the Save as Draft button, or publish with the Publish button. If you choose to save a draft of the article, you can return to it anytime in from the Drafts section of your profile. Publishing the article make it appear in your public profile.
Tagging your content correctly helps readers find what they are looking for on Kauri. You can add between one and five tags to an article. Add tags by starting to type the relevant term, and selecting it from the autocomplete list, or hit enter to save a new tab.
One of the core principles of Kauri is keeping content up-to-date and usable, and you can update any articles you've written whenever you want.
To update an article, first, open it. On the right-hand side of the article is an Update Article button. This button returns you to the editor, where you can make changes.
If it's content you own, then you publish the changes as soon as you click Update Article.
If you want to suggest changes to articles owned by other writers, when you click Update Article, your suggested changes and comments wait for the owner to view, approve, and publish when they click Approve Changes.
You also have the option of saving the article as a draft, but this creates a new version of the article with a new ID, and the old one still exists.
Claim an Article by Submitting it On-chain
Submitting an article on-chain claims it as yours in a transaction on the Ethereum Blockchain.
Click the Submit Article to On-Chain button next to an article.