Snipt offers a full featured blogging platform alongside its obvious code storage and sharing functionalities. This Snipt documents those blogging features.
If you have any questions, there are a bunch of ways to get in touch:
- Ask "nicksergeant" in #snipt on irc.freenode.net.
- Use the comments attached to this snipt.
- Use the support chat in the bottom right.
- Reply to us on Twitter.
- File a support ticket on GitHub
Note: Go Pro to get the most out of the Snipt blogging platform. You'll thank us later :)
First off, every user automatically has a Snipt blog. The URL format is:
username.snipt.net
So if your username is cz, your URL would be https://cz.snipt.net/.
Note: If you have an underscore in your username, the underscores would be represented by dashes
in your default blog URL (since underscores are not valid in domains or subdomains). So our api_test_user
has a blog URL of: https://api-test-user.snipt.net.
If you become a Snipt Pro, you can point a custom domain to your Snipt blog. Here's an example of a Snipt blog with a custom domain: http://nicksergeant.com.
If you decide to go Pro (you should, it's awesome), simply head to your Account and enter the domain you'd like to use, and update your DNS with instructions from your Account page.
To get a Snipt to appear on your Snipt blog, you simply mark a Snipt as both Public
and Blog post. Markdown is a great post Type if you're writing text-heavy posts, or you
can simply use whatever code type and you'll get the Snipt-style highlighting on blog posts,
as well.
Publish date
On blog posts, sometimes it's useful to state that the post was originally published on
a certain date and time (such as with importing from another blogging platform). When you
mark a post as Blog post, the Publish date field will automatically appear. You can
also use the Publish date to schedule posts to be published in the future.
Custom content
Snipt embeds
The blogging platform allows you to embed other Snipts into blog posts themselves. We haven't yet built out the UI for this yet, so you have to do some digging.
In the blog post, you would enter this code to embed another Snipt:
[[921ac0bbb4d922ddcbc2e61fd2cd8ed]]
The ID between the brackets is the key of the Snipt. You can find the key by going to your
Snipt and clicking "Embed". The key is the ID at the end of the URL (not including slashes):
https://snipt.net/embed/921ac0bbb4d922ddcbc2e61fd2cd8ed/
YouTube videos
When you're in your Markdown snipt, adding this custom tag will automatically embed a YouTube video with the desired dimensions:
[[youtube-{video_id}-{width}x{height}]]
Where {video_id} is replaced with something like K7vU2cDIyjU (you can grab the ID in the URL
of any YouTube video). {width} would be replaced with a width value like 688 and {height} with something like
387.
Vimeo videos
Same as YouTube above, but the code is:
[[vimeo-{video_id}-{width}x{height}]]
Tweets
First, grab the ID from the tweet URL. If the URL is https://twitter.com/Snipt/status/319285740448133123, the tweet_id would be 319285740448133123. Then you'd embed your tweet in your post like so (omit the curly brackets):
[[tweet-{tweet_id}]]
Headings
Currently we have one custom style for headings in certain themes:
- H4s are styled with a blue decorator in the side gutter of the "Pro Adams" theme, as seen here: http://nicksergeant.com/work/
Regular Snipt users are given a default blog theme for which to use for their Snipt blog. However, if you become a Snipt Pro, you gain access to exclusive Pro-only blog themes. Currently there is one Pro theme available, but we're working on others.
- Default theme sample: https://test.snipt.net/
- "Pro Adams" theme sample: http://nicksergeant.com
Both the default blog theme and the Pro blog theme have support for adding additional content
in the sidebar. To enable this content, create a Snipt with the title "Sidebar", set the
Type to Markdown, and mark it as Blog post. The content will then appear in the sidebar
of your blog theme.
The sidebar in the Pro theme also supports a GitTip button. To enable the button, first set your GitTip username in your Account, then place this text where you would like the button to be rendered in the sidebar:
[[gittip]]
The Pro theme also has support for additional text in the header. To enable this content, create
a Snipt with the title "Header", set the Type to Markdown, and mark it as Blog post. The
content will then appear in the sidebar of your blog theme.
If you're a Snipt Pro, you can customize the CSS of your blog theme
(either the default theme or any of the Pro themes). To enable this, create
a Snipt with the title "CSS", set the Type to CSS, and mark it as Blog post. The custom
CSS will then be loaded into your blog theme.
If you're a Snipt Pro, we offer a few custom fields you can override for your blog. All of these fields can be updated on your Account page once you're a Pro. The fields are:
- Disqus shortname -- If you have your own Disqus account that you'd like to use for your blog comments.