The main Tickle documentation and reference implementation
Go to file
2023-06-07 22:07:47 +02:00
components refactor 2023-05-09 04:00:53 +02:00
examples/musings added a few loading utilities 2023-05-18 23:33:33 +02:00
modules smol updates even mor 2023-06-07 22:07:47 +02:00
examples.md first commit 2022-06-27 23:20:12 +02:00
favicon.ico commented code, added some info, added icon 2022-07-03 00:21:20 +02:00
favicon.svg commented code, added some info, added icon 2022-07-03 00:21:20 +02:00
files.txt commented code, added some info, added icon 2022-07-03 00:21:20 +02:00
index.html tickle functionality restored 2023-05-13 17:26:48 +02:00
readme.md commented code, added some info, added icon 2022-07-03 00:21:20 +02:00
tutorial-hackers.md commented code, added some info, added icon 2022-07-03 00:21:20 +02:00
tutorial-publishers.md commented code, added some info, added icon 2022-07-03 00:21:20 +02:00
tutorial-styling.md commented code, added some info, added icon 2022-07-03 00:21:20 +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. Render 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. Optional: reference files in a text file called "files.txt" to fill the side navigation
  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.

TODO: specify where to find us

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 could mean a large amount of people will miss some ads, and that costs them profits. 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

TODO: decide on a license

Q: "Tickle"?

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