The main Tickle documentation and reference implementation
Go to file
Xananax b03ddcb428 feat: handle local urls
feat: debug mode (auto-refreshes pages)
fix: date ordering
feat: add poor person's jQuery
improvement: rename startLoading to showLoadingOverlay
fix: do not load initial page twice
improvement: allow arbitrary spaces between filename and date in files.txt
2022-06-28 11:05:59 +02:00
examples.md first commit 2022-06-27 23:20:12 +02:00
files.txt feat: handle local urls 2022-06-28 11:05:59 +02:00
index.html feat: handle local urls 2022-06-28 11:05:59 +02:00
readme.md feat: handle local urls 2022-06-28 11:05:59 +02:00
tutorial-hackers.md first commit 2022-06-27 23:20:12 +02:00
tutorial-publishers.md first commit 2022-06-27 23:20:12 +02:00

Tickle

Possibly the simplest way to self-publish on the web today.

Tickle is a self-publishing platform with no build system, and no tooling required.

What is Tickle?

A small, small, small script that will load markdown files, parse them in the browser, and display them.

Accent is kept on keeping the script aired, readable, and easy to hack.

By default, Tickle will:

  1. Read a text file containing a list of posts
  2. Load the first post
  3. Parse the markdown
  4. Display the list of links, and the pages

Tickle is small enough that a moderately knowledgeable programmer should be able to make it do whatever they want.

How do I use Tickle?

  1. write markdown files
  2. reference your files in a text file called "files.txt"
  3. upload everything on some server

We have a neat little UI to help you do all of that. You don't have to use it, but it's neat.

Here are more detailed explanations, for different knowledge levels.

It's important to know that Tickle is an idea. Think of it as a specification. We have a few examples listed here

FAQ

Q: Why would I want to use this rather than medium/similar?

A: Medium locks your content behind paywalls and spies on users. Other providers have similar issues. If you care about being in control of your data, or not having to deal with embargos, or not spying on people, or not helping corporations, or keeping your tools simple and lightweight, then you'll probably like Tickle. If you don't care, then using something like Medium probably fits your needs better.

Q: What if I want custom functionality, but don't know programming at all?

A: Check the examples first, and see if there's something for you. Otherwise, write to us! Find us on X or Y, and shoot your request. Maybe we'll get to it

Q: Everything in the browser? Isn't that bad for SEO?

A: Who cares? SEO is dead. No one finds blogs organically by googling them, the first pages are entirely occupied by clickbait. If your articles will be shared, they will be shared by people, and the technical side of your page counts zilch there

Q: Isn't it bad for performance?

A: Again, who cares? For Facebook, a microsecond lost means a large amount of people will not see ads fast enough, that loses them money. But someone who comes to read your blog will wait 300ms to read your article, no worries.

Q: What about accessibility?

A: We haven't started working on this, but we care about this a lot, and we will make sure Tickle websites are accessible, at least in the default blog recipe.

Q: What's the license?

A: The license is upcoming

Q: "Tickle"?

A: It stands for "article"... Or maybe "art", "tickle"? It's a neat name found by Otto.