How do I format my forum post? [HowTo]

The TTN forum is using Discourse, which supports several ways to format your post:

  • Markdown
  • BBCode
  • HTML
  • Any combination of the above

Quite often you’ll need an empty line above specific formatting to make it work. You’ll also have to type blank lines to create proper paragraphs; just pressing Return once and then typing a new block of text right below a previous block only creates a so-called line break, which might be harder to read.

Leaving one blank line between two blocks of texts nicely creates a new paragraph with some whitespace, which looks great on both mobile and in a regular desktop browser.

Toolbar

The toolbar above the editor’s input helps create mostly Markdown posts:

  • To apply formatting to parts of your post, first select the text you want to format and then click one of the toolbar buttons.

  • See the button’s tooltip for some hints. From left to right: quote post you’re replying to, bold, emphasis (italic), hyperlink, blockquote, preformatted text, upload an image or file, bulleted list, numbered list, heading, horizontal rule, emoij, other options (such as hidden details).

Code and logs

There are many options to format your code or logs:

  • “Fenced code blocks”: type 3 backticks above and below your text, optionally followed by a specification of the language for syntax highlighting, like ```cpp for C++, and likewise javascript, json and sql:

    Here is my code:
    
    ```cpp
    #define LMIC_DEBUG_LEVEL 0
    #include <avr/sleep.h>
    #ifdef PROGMEM
    // On AVR, these values are stored in flash and only copied to RAM
    int a = 0;
    ```
    

    …yielding highlighted C++ code:

    Here is my code:

    #define LMIC_DEBUG_LEVEL 0
    #include <avr/sleep.h>
    #ifdef PROGMEM
    // On AVR, these values are stored in flash and only copied to RAM
    int a = 0;
    
  • …or, as highlighting might be wrong, use ```text to suppress any highlighting:

    ```text
    ## some log output
    ## here
    ```
    
  • Or, also without any highlighting: indent the code with 4 spaces (or select your code and use the toolbar </> button to make the editor indent the selected code for you):

    Here is my code:
    
        #define LMIC_DEBUG_LEVEL 0
        #include <avr/sleep.h>
        #ifdef PROGMEM
        // On AVR, these values are stored in flash and only copied to RAM
        int a = 0;
    
  • Or: use BBCode [code] above your code or logs, and [/code] below it.

  • If you have many details, you can collapse them to avoid a very long post:

    [details=Click to see the full logs]
    ```text
    This text will be hidden,
    until clicked
    ```
    [/details]
    

    …which will get you:

    Click to see the full logs
    This text will be hidden,
    until clicked
    

Markdown

See http://commonmark.org/help/ for a nice overview. It’s really easy; just a few of its options:

Just type, **use plenty of whitespace** and [link your sources](https:/thethingsnetwork.org)!

- An unordered list.
- Item B.    

Or:

1. An ordered list
    1. Nested item
    2. Nested item

2. Item 2.
    - Nested unordered list

3. Item 3.

    Nested paragraph.

    > Nested quote.

        Nested code

> A quote
>
>     with nested code

Images have a Discourse-specific option to scale down the preview size: add a percentage such as ,10% after the image size that is already added when uploading an image:

![TTN logo|649x500,10%](upload://svFg8QtnafrQD36BNhWCepOMnzG.png)

…to get a small image that is still clickable for the full version (which should be clickable for the full version, but that is broken in TTN’s installation :frowning: ):

TTN logo

HTML

Only some limited tags are supported; other HTML will be invisible, so use code to see that. Like type `<include ...>` to see <include ...>.

BBCode

[b]strong[/b]
[i]emphasis[/i]
[u]underlined[/u]
[s]strikethrough[/s]
[ul][li]option one[/li][/ul]
[quote="eviltrout"]They said...[/quote]
[quote="eviltrout, post:1, topic:2"]They said...[/quote]
[img]http://eviltrout.com/eviltrout.png[/img]
[url]http://bettercallsaul.com[/url]
[email]eviltrout@mailinator.com[/email]
[code]\nx++\n[/code]
9 Likes
Connecting IMST LiteGateway ? Stuck
The Things Uno does not work unless serial monitor is open
Cannot schedule downlink using curl or MQTT
Cannot schedule downlink using curl or MQTT
Only activation messages from FiPy
Cannot publish/subscribe to my device up/down link topics
How to do proper number calculations in a Payload Format decoder?
Laird RS1xx - probably a question on bit shifting
I can't subscribe to MQTT Payload Fields
Arduino MKR WAN 1300
Join Errors with v3.8.1 update
Send downlink to multiple devices
Skiply Smilio Payload decoder
Big STM32 boards topic
No "Packet queued" and EV_TXCOMPLETE after successful OTAA Join and despite successful uplink
Fixed Frequenzy for End Node
Retrieve data from TTN by using Python SDK
IC880A with RPi3 status not connected
Gateway status connected but enable to receive data from lora end node
32 Bit overflow in Payload Format decoder
HPD13A unable to send data to TTN
How to stop getting a downlink for each uplink in Arduino with RAK811
How to send downlink to HTTP Integration from jQuery?
GW connected but no traffic diplayed on console
Decrypting messages for dummies
Problem in receiving messages
Lmic.h configuration issue and having issue with transmitting data with LoRa shield
How do I decode data from different nodes?
Related with MQ2
ESP32 Wroom Chip with RFM95
TTOG problems with sensors, configuration ok?
Big ESP32 + SX127x topic part 3
Big ESP32 + SX127x topic part 3
[solved] Relaunch a LoRa connection which has unexpectedly interrupted?
LMIC upload issue Arduino IDE
Kerlink IFemtocell Packet loss
TTIG Problems, - no location data, wrong date/time, wrong channel and stability issues
Kerlink IFemtocell Packet loss
Arduino error
RHF76-052 (SEEEDUINO LORAWAN ) with DHT11
Solar Powered Low Cost LoRa Node with Integrated Battery Holder
Unable to connect on TTN, putty says network issue
Big ESP32 + SX127x topic part 3
VCC output failure in deep sleep mode
Python API - How to get data from the uplink_callback method?
Gateway connected and node unconnected
Measuring internal temp of oysters and mussel
[solved] LoRa Feather M0 Node Fails to Join
RFM95 testing
How can i use resend when node failed to send?
How can I make an tracker node?
Payload Decoder SCD30
TTGO T-Beam
IMST iC880A receiving all RF packets with CRC error
ESPNOW and Lora
Raw LoRa communication between RFM95 and RN2483
Otaa connection to things network
Feather 32u4 with TinyLoRa for weeks-long balloon contest
LMIC get duty cycle timer for channel
TTN UNO was working with OTA and ABP now not
HTTP integration
Things Uno - Join not accepted: denied
Problem in transmitting data through the RN2483-Arduino library
OTAA woes TTN Gateway and Lopy
Downlink messages not always received on device
Getting high current in low power mode
The LIBRARY basement part 2
Doing my first attempts to connect - failed
Big ESP32 / SX127x topic part 1
Got Adafruit Feather 32u4 LoRa Radio to work and here is how
Join not accepted: denied with Sodaq Explorer
Lora Gateway Help
The LIBRARY basement part 8
Anyone tried Laird RM1XX modules ? part 2
DRAGINO problems and solutions topic part 2
Can LMIC 1.6 be set up to use a single channel and SF?
Sleep the card lora32u4
Error (lora-packet verify) (Dragino Hat + T-Beam)
DRAGINO problems and solutions topic part 1
Lights on/Off TTN Node Code
Payload[Not provided] in application data
Payload[Not provided] in application data
Payload Decoder
Gateway status not connected, no data visible
Big ESP32 + SX127x topic part 2
Device not activated Lora feather 32u4 RFM9X
Ttn - json -python (paho-mqtt)
TTGO T-Beam
Whisper Node and RFM95 DIOs
Can't get the Device EUI out of TTN Node
Sandbox LoRaGo PORT gateway on TTN
DRAGINO problems and solutions topic part 1
Long range radio Pager project
Node Fails after sending ~200 Messages
Dual-Chan Gateway with Raspberry PI3 + Dragino Hat v1.4 and Downstream messages
[solved] LoRa32u4 II joins only sometimes
[solved] Raspi3+Ic88a gateway not connected on TTN
RHF76-052 and decrypting payloads
The LIBRARY basement part 5
IFTTT payload conversion to show door status?
Over-the-air-activation OTAA with LMIC
Package forwarding
Altitude of node/device incorrect
P2P RN2903/RN2483 Arduino
Single Channel Packet Forwarder part 3 [Deprecated]
Has anyone experience with Sensing Labs devices?
433 MHz band support and alternatives
BSFrance Lora32u4 stuck in sleep mode
Has anyone tried sending GPS coords to TTN?
Is there any "increase antenna gain" on arduino LMIC sketch?
Payload receive with Node-Red
MQTT Configuration in Node-Red
ADR doesn't work (915 MHz Band - ABP)
ADR doesn't work (915 MHz Band - ABP)
Library Error Message
Arduino code to send voltage, current and power to the things network with uplink
Decrypting messages for dummies

How do I create my own post where I can ask my own question?

first spend some time on this forum, and use search ! , big chance you’ll find a topic were you question fits in perfectly.

This is a very useful page, where I landed while reading another topic. Markdown is familiar from the early days of Wiki. Unfortunately

HTML

Only some limited tags are supported …

Would it be good to start a sandbox topic where newcomers could train their skills without receiving remarks from veterans? The contents could then be emptied every now and then by somebody with moderator rights.

There is already online training available, it is offered to all users when they join, however most will choose to ignore it.

If you head over to this unlisted topic you can find the instructions to (re)start training.

Another option is to send yourself a private message.
In that you can experiment with formatting of messages/posts.

(Note that private messages to yourself are not visible in the ‘Inbox’ but under ‘Sent’).

More sources:

1 Like