The roxwize link mechanism

Okay. Listen. It's a mad world out there. I can't even fathom the amount of ww3 domain parking content farm websites there are out there. But they exist. And I don't trust them. You shouldn't either. But if there's anything more trustworthy than scummy advertising it's me. You can trust me, right? So what if I... took those guys' ideas... and made it, like, actually good? You can trust me. Honest. In fact, I'll even let you add your own links to it. For free! If you're still not convinced, the door is that way.

Basically, it's hypertext BannerLink Ads. You can embed it on your website as an <iframe> and tailor the links themselves to a specific category.

Linked below are the instructions for embedding TRLM and adding your website to it. If something doesn't make sense to you or confuses you, please notify me via e-mail or Neocities and I'll try to address the issue.

Embed | Add your website

To add TRLM to your website

Short version (TL;DR)

<iframe src="https://roxwize.xyz/ext/trlm" scrolling="no" width="500" height="150" frameborder="0"></iframe>

Long version

If you're feeling generous you can display other people's websites on yours. By default, up to eight links are displayed at once. Here is the link to the frame for you to embed:

https://roxwize.xyz/ext/trlm/?category=[CATEGORY NAME]&max=[MAX LINKS]&title=[TITLE]&internalstyle=[DEFAULT STYLING (1 or 0)]&nostyle=[ENABLE LINK STYLES (1 or 0)]

You can also store a local copy of /trlm/ on your website, if you're into that. It should work on different websites.

In [square brackets] are the parameters for TRLM. All of them are optional. Here is an example displaying technology-related websites that uses plain, default styling with a maximum of 16 links.

https://roxwize.xyz/ext/trlm/?category=Technology&max=16&internalstyle=1

I might streamline the process of building the URL into a simple form eventually. Check back for when I get to that.

Parameter table

"Default behavior" describes what is done if the parameter is left out of the URL.

Parameter	Description	Default behavior	Example
`category`	Comma-separated list that describes which categories of links to display; see Categories.	Displays links from all categories	`Technology,GeneralAndPersonal`
`max`	Specifies the maximum number of links to display	Displays up to eight
`title`	Specifies custom text for the header above the links	Sets header text to `More cool sites`; you can use `title=` to hide it completely
`internalstyle`	Use default styling (set to 0 if you are embedding inside a frame and you want to use your website's styling)	Does not use any default CSS
`nostyle`	Disables custom styles for links	Does not do that
`extcss`	Details an external CSS file to be embedded into the frame		`extcss=https://roxwize.xyz/static/css/main.css`
`incss`	Modify the css of the page inside of the url		`incss=*{color:red;font-weight;bold}`

Remember that parameters need to be URL encoded, so body{background:black;color:white} becomes body%7Bbackground%3Ablack%3Bcolor%3Awhite%7D. You can convert between the two using this utility.

To add your website to TRLM

The simplest way to get your link added is to e-mail me with the details of your link. I don't mind how you format it, but I need to know at minimum where it links to, what text the link will display, and what category it'll be in. It can be in multiple categories. If you need a template, refer to Email template.

If a category you want your website to be in doesn't exist then include it regardless and I'll consider adding it.

Also your link can contain HTML. This means that if you want to replace your link with a button/image, or if you want to add bold or italics, you're free to do so.

If you want to add custom CSS to your link, include that as well in the email (doesn't need to look fancy or be properly formatted); don't treat it as an inline style. ! refers to your link element.

  ! {
    text-decoration: none;
    font-weight: bold;
    color: #896498;
  }
  !:hover {
    font-weight: normal;
  }

If you like trailblazing then you can use Git.

Using Git

Adding a link manually requires you to know your way around Git.

In the repository for this website where TRLM's code is stored, the place where all links are stored can be found at trlm.xml. Every link is contained inside <category>s. First of all, open that file, and click the pencil button at the top right.

The pencil icon on GitHub

It's going to ask you to fork the repository. Go ahead and click the green button to do so.

Once you're done, go back to trlm.xml. Find a category that fits your website and add your website in it at the bottom by using this template:

<link href="[WEBSITE URL]">[LINK TEXT]</link>
<!-- You can use &r; and &l; in your links to append right and left angled brackets respectively -->

That is a link in its simplest form. After you've added it, you can open a pull request to add it to the website, or you can add more stuff to it. If you just want to put it in the thing then scroll down.

Placing your link in multiple categories

Links can be in multiple different categories at once. This doesn't increase their chance of appearing, but it does allow them to be selected if only one category or the other is chosen.

Give your link a unique id (the name of your site will do) and, in another category you want to put your link in, add another <link> element with the ref attribute set to the id you just stated. Self-close it and leave it as-is after that.

<category name="Technology">
  <link href="https://roxwize.xyz/" id="roxwize">Roxwize</link>
</category>
<category name="GeneralAndPersonal">
  <!-- Include roxwize.xyz in GeneralAndPersonal aswell -->
  <link ref="roxwize" />
</category>

Giving your link custom styling

There is no need to be boring. If you know CSS and wish to add styling to your link, do not be hesitant.

The style attribute of your link dictates what styling it'll have. This is not an inline style. In the attribute, you refer to your element with !.

<!-- You can give it a title too -->
<link
  href="https://roxwize.xyz/"
  title="My cool website"
  style="! { color:black;transition:0.2s; } !:hover { color:red; }"
>
  Roxwize
</link>

Adding it to the source

If you want your link to actually display on the website itself then you'll need to commit it to the source. This means opening a pull request. I assume if you've chosen this route then you know how to do pull requests.

Go to the fork that you created and find the button that says Contribute.

The Contribute button clicked to expand a menu with a green "Open pull request" button

Click Open pull request to open a pull request to the main repository and, if you feel so obliged, describe what you added. Finalize creating the pull request and your link will probably be added soon.

Email template

Link label:
URL to point to:
Categories:
Alt text (optional):
Styling (optional):