• Activity
  • Votes
  • Comments
  • New
  • All activity
  • Showing only topics in ~tildes with the tag "guides". Back to normal view / Search all groups
    1. Tildes and comment formatting, markdown: a quick and dirty guide

      At the suggestion of a certain heathen who shall remain unnamed. I'm tossing up a quick and dirty comment (and post text) formatting guide. There is a formatting guide in the docs/wiki with a link...

      At the suggestion of a certain heathen who shall remain unnamed. I'm tossing up a quick and dirty comment (and post text) formatting guide. There is a formatting guide in the docs/wiki with a link just above the comment box, but it can be a bit much to digest.

      *italics*
      **bold**
      ~~strikethrough~~
      [Text goes here](URL goes here)
      <small>small text</small> 
      <sub>subscript</sub>
      <sup>superscript</sup>
      # headline
      `code which removes the formatting and makes it look like this block`
      * bulleted
      * lists
      1. and
      1. numbered
      1. lists
      

      Spoilers is a bit more complicated, the <details> start and end </details> is required, but the <summary> start and end </summary> is not unless you want text in the summary or you want the summary to be blank.

      <details>
      <summary>Summary text!</summary>
      
      Body text inside spoiler!
      </details>
      
      For example if you leave out the summary code then the box just says "Details" like this.
      Or you can have a summary...

      ...like this.

      Or by leaving the text between the summary code blank you can have the box be empty but still have spoiler text within

      You can use formatting like bold, italics, or even...
      ...spoilers within spoilers! ...but you have to leave an extra line above this or it *won't work* and your formatting will be revealed to **all!**

      Three underscores (or dashes, but dashes require an extra line) in a row on their own line creates a blank line to divide a topic...
      ---

      You also have a sub-headline text option by putting a single dash under text...
      -
      ...or headline text by putting an equal sign under text.
      =


      If you like userscripts (who doesn't?) you can install extensions like ViolentMonkey that allow you to install little bits of code like the Tildes Formatting Toolbar that can change/improve the sites you use and make formatting here a breeze.


      Do use the formatting responsibly, but here are examples for bold, italics, strikethrough, links, small text, subscript, superscript,

      headline text,

      sub-headline text,

      code,

      • bulleted
      • lists,
      1. and
      2. numbered
      3. lists

      Most formatting can be combined as well such as superscripts, lines, and small text to make...

      ...sentences with a...1


      1...footnote

      97 votes
    2. How to contribute a theme to Tildes

      Want to contribute a theme to Tildes but don't know where to start? Let's fix that. Before we start, get yourself a development environment setup and do a quick read through of the general...

      Want to contribute a theme to Tildes but don't know where to start? Let's fix that.

      Before we start, get yourself a development environment setup and do a quick read through of the general development info to get acquainted with how Tildes works (or at least the HTML and CSS section).

      For this walkthrough I'll be using tildexample as the example name for the theme, but if you decide to contribute a theme for real, make sure it uses the proper name of your theme. :P

      Step 1: Sassy _Sass

      Open the Tildes codebase using your text editor of choice and navigate to the themes directory at tildes/scss/themes. Then create a copy of _default.scss at _tildexample.scss. The default White theme is the canonical source of all colors used, so it's the best place to start from.

      Below is an annotated example of all the things you need to change in your new theme file.

      Annotated example theme
      // Add a small description of the theme here with maybe a link to its website.
      // Check the other themes for examples. https://example.org/tildexample
      
      // Change the theme variable to $theme-tildexample
      // ↓ ↓ ↓ ↓ ↓ ↓ 
      $default-theme: (
        // A whole bunch of color definitions, edit as your theme demands.
        // ...
      );
      
      // Append ".theme-tildexample" to the body selector.
      // ↓ ↙
      body {
        // Don't forget to update the theme variable here too.
        //                  ↓ ↓ ↓ ↓ ↓ ↓ ↓
        @include use-theme($default-theme);
      }
      
      @include theme-preview-block(
        // Change the text to tildexample.
        // ↓ ↓
        "white",
        // And again update the theme variable here.
        //       ↓ ↓ ↓ ↓ ↓ ↓ ↓
        map-get($default-theme, "foreground-primary"),
        map-get($default-theme, "background-primary")
        //       ↑ ↑ ↑ ↑ ↑ ↑ ↑
      );
      

      Once that's done, head to tildes/scss/styles.scss and at the bottom of the file add your theme import:

      @import "themes/tildexample";
      

      Step 2: Hardcoding a TheMe coLor

      Boy that title is a stretch just to say, we need to add 2 lines to the HTML base template.

      Inside the tildes/tildes/templates/base.jinja2 file is a section of if/elif/elif/elif/... statements to set the theme color meta element. Add yourself an elif block and add your theme color.

      For this you probably want to use the background-primary color you used in your theme definition. I've used #ff00dd below because it spells food. I'm such a jokester.

      {% elif request.current_theme == "tildexample" %}
      <meta name="theme-color" content="#ff00dd">
      {% endif %}
      

      Step 3: Snakey Wakey

      Finally the last step is to grab your trusty pungi and give it a blow.

      Head to tildes/tildes/views/settings.py and find the THEME_OPTIONS constant. Here you want to add the theme class you used in body.theme-<this part> and a proper name that will be shown in the theme dropdown.

      THEME_OPTIONS = {
          "white": "White",
          # Many other themes...
          "tildexample": "Tildes Theme Example",
      }
      

      Once that's all been done, check it out in your development site and see if it works.

      Now git!

      Commit. Push. Merge request. Have some water. Deimos reviews, merges and deploys your theme. Job's done.

      26 votes
    3. Tips on starting a good discussion topic

      For creating link topics, see Posting on Tildes in the official documentation. When you don’t see the discussion you want, you can create a new topic. Starting a new Tildes topic is pretty easy....

      For creating link topics, see Posting on Tildes in the official documentation.

      When you don’t see the discussion you want, you can create a new topic. Starting a new Tildes topic is pretty easy. However, It can be done in better or worse ways, so here are some tips:

      1. Choosing a group

      Don't worry about this too much. Unlike subreddits, Tildes groups mostly don't have their own rules or subcultures. They're folders for organizing topics. If you put a topic in the wrong place, someone will move it. Either ~talk or ~misc are good if you don't know where to put it.

      But you do need to click on a group to go to the group's page. Then look in the sidebar on the right side. (If you're on mobile, you will need to open the sidebar.) There's a blurb explaining what the group is about, and a button under it to start a topic.

      2. Choosing a good title

      For discussion topics, a question often makes a good title.

      Tildes has users from all over the world. Asking people to share their own experiences lets anyone participate and you can learn interesting things about people in other places.

      • Bad: "What do you think of this terrible weather?"

      • Better: "What's the weather like where you are?"

      Discussing a specific weather event would also be fine, but you need to say where it is.

      A downside to asking a very generic question is that it might get more attention than you're hoping for. (For example, you might get advice that's not relevant where you live.) If you want to narrow things down geographically, be specific about which country or region you're interested in. We probably don't yet have enough users for hyper-local topics to get many responses, but feel free to try.

      3. Writing an introduction

      For a discussion topic, you skip the link box and write something in the box below it. You can write whatever you like here.

      3a. Setting ground rules (optional)

      Sometimes you have something specific you're looking for and it helps to make a sort of game out of it by making up some rules. A good example is @kfwyre's AlbumLove topics. If you just ask for music recommendations, people are going to answer in any old way, maybe by making long lists. So instead the game is to review one album.

      Tildes users are usually pretty cooperative as long as you make it clear what you're looking for and the game isn't too weird. (And if they get the rules a little wrong, it's usually not a big deal.)

      4. Tags (optional)

      This is optional because if i you skip it, someone will do it for you, but if you want to help out, there is more about tags in the official docs. You could also look at similar topics in another window to see what tags we use.

      5. Seeding the topic (optional)

      After posting the topic, you might want to add some top-level comments to get it going. For example, if it's a megathread then you might put a link to a different article in each reply. Or, if you have a lot of questions to ask, you could put each question in a separate comment. This would keep the answers to each question separate.

      6. Encouraging discussion (optional)

      You will see a notification at the top of any Tildes web pages you visit whenever someone posts a top-level reply in your new topic. Replying and upvoting (if warranted) will help keep conversation going. Conversation encourages more conversation. You can do a lot even without any formal “mod” powers. (Some users also have ability to label replies, which affects sort order.)

      Okay, that's it for me. What are some tips you have about starting new topics? One tip per comment, please! <= See what I did there?

      41 votes
    4. Due to Activity sort constantly bumping older topics to the top, the "Knights of New" are especially important here on Tildes

      So if you want to encourage people to post more content, please take time to occasionally check the New sort. If you leave a comment on new topics you are interested in and want to see more...

      So if you want to encourage people to post more content, please take time to occasionally check the New sort. If you leave a comment on new topics you are interested in and want to see more discussion on, it will help them thrive. No pressure, and please don't just leave a comment for the sake of commenting, but just a gentle reminder to try your best to look out for the newly submitted content, and the people who submit it.

      Happy Tildying everyone. :)

      72 votes
    5. A general introduction to Tildes

      Lots of new folks seem to be coming in these past days, so I wanted to make a post that compiles some useful things to know, commonly asked questions, and a general idea of tildes history (short...

      Lots of new folks seem to be coming in these past days, so I wanted to make a post that compiles some useful things to know, commonly asked questions, and a general idea of tildes history (short though it may be). Please keep in mind that tildes is still in Alpha, and many features that are usually present such as repost detection haven't been implemented yet.

      Settings

      First of all, check out the settings page if you haven't yet. It's located in your user profile, on the right sidebar. There are different themes available, the account default is the 'white' theme, which you can change. I recommend setting up account recovery in case you forget your password, and toggle marking new comments to highlight new comments in a thread. There are more features available but you should go look in the settings yourself.

      Posting

      You can post a topic by navigating to a group and clicking on the button in the right sidebar. Tildes uses markdown, if you are not familiar with it check the text formatting doc page. Please tag your post so it is easier for other people to find, and check out the topic tagging guidelines. Some posts have a topic log in the sidebar that shows what changes were done to the post since it was posted. You can see an example here. Some people have the ability to add tags to posts, edit titles, and move posts to different groups. They were given the ability by Deimos, see this post.

      Topic Tags

      You can find all posts with the same tag by clicking on a tag on a post, which will take you to an url like https://tildes.net/?tag=ask, where ask is the tag you clicked on. Replace ask with whatever tag you want to search for. You can also filter tags within a group like this: https://tildes.net/~tildes?tag=discussion, and it will only show you posts within that group. Clicking on a tag while you are in a group achieves the same effect.

      You can also filter out posts with specific tags by going to your settings and defining topic tag filters.

      Comment Tags

      Comment tags are a feature that was present in the early days of tildes, but was removed because of abuse. There were five tags you can tag on someone else's comment: joke, noise, offtopic, troll, flame. The tags have no effect on sorting or other systematic features; they were only used to inform the user on the nature of a comment. The tags would show up along with the number of people who applied them, like this: [Troll] x3, [Noise] x5

      People used these tags as a downvote against comments they disliked, and because the tags appeared at the top of a comment in bright colors, they often would bias the user before they read the comment. The abuse culminated in the first person banned on the website, and the comment tags were disabled for tweaking.

      As of September 07, 2018, the comment tags have been re-enabled and are experimented with. Any account over a week old will have access to this ability. The tagging button is located on the centre bottom of a comment. You cannot tag your own comment. Here are the comment tagging guidelines from the docs.

      Currently, the tags are: exemplary, joke, offtopic, noise, malice. The exemplary tag can only be applied once every 8 hours, and requires you to write an anonymous message to the author thanking them for their comment. Similarly, applying the malice tag requires a message explaining why the comment is malicious. The tags have different effects on the comments, which you can read about here, and here.

      Search

      The search function is fairly primitive right now. It only includes the title and text of posts and their topic tags.

      Default sorting

      The current default sorting is activity, last 3 days in the main page, activity, all time in individual groups. Activity sort bumps a post up whenever someone replies to it. 'Last 3 days' mean that only posts posted in the past 3 days will be shown. You can change your default sort by choosing a different sort method and/or time period, and clicking the 'set as default' button that will appear on the right.

      Bookmarks

      You can bookmark posts and comments. The "bookmark" button is on the bottom of posts and comments. Your bookmarked posts can be viewed through the bookmark page in your user profile sidebar. Note: to unbookmark a post, you have to refresh first.

      Extensions

      @Emerald_Knight has compiled a list of user created extensions and CSS themes here: https://gitlab.com/Emerald_Knight/awesome-tildes

      In particular, I found the browser extension Tildes Extended by @crius and @Bauke very useful. It has nifty features like jumping to new comments, markdown preview and user tagging.

      Tildes Development

      Tildes is open source and if you want to contribute to tildes development, this is what you should read: https://gitlab.com/tildes/tildes/blob/master/CONTRIBUTING.md

      For those who can't code, you might still be interested in the issue boards on Gitlab. It contains known issues, features being worked on, and plans for the future. If you have a feature in mind that you want to suggest, try looking there first to see if others have thought of it already, or are working on it.


      Tildes' Design and Mechanics

      In other words, how is it going to be different from reddit? Below are some summaries of future mechanics and inspiration for tildes' design. Note: most of the mechanics have not been implemented and are subject to change and debate.

      1. Tildes will not have conventional moderators. Instead, the moderation duties will be spread to thousands of users by the trust system. [Trust people, but punish abusers]. More info on how it works and why it is designed that way:

      2. Instead of subreddits, there are groups, a homage to Usenet. Groups will be organized hierarchically, the first and only subgroup right now is ~tildes.official. Groups will never be created by a single user, instead, they will be created based on group interest [citation needed]. For example, if a major portion of ~games consists of DnD posts and they are drowning out all the other topics, a ~games.dnd subgroup would be created - either by petition, algorithm, or both[citation needed] - to contain the posts, and those who don't like DnD can unsubscribe from ~games.dnd. There is currently no way to filter out a subgroup from the main group.

      3. Tildes is very privacy oriented. See: Haunted by data


      Tildes History/Commonly answered questions

      I recommend you check out this past introduction post by @Amarok before anything else, it's a bit outdated but contains many interesting discussions and notable events that have happened on tildes. @Bauke also tracks noteworthy events each month on his website https://til.bauke.xyz/. Also see the FAQ in the docs. Other than that, the best way for you to get an idea of how tildes changed over time is to go to ~tildes.official and look at all the past daily discussions.

      Below are some scattered links that I found interesting, informative, or important:


      If anyone thinks of a link that should be included here, post a comment with the link and I'll edit it in.

      Markdown source for this post: https://pastebin.com/Kbbh7pYU (outdated, and probably will not be updated unless someone explicitly asks for it)

      To the rest: have fun!

      57 votes