{% extends "layout.html" %}
{% block title %}Help :: {{ config.SITE_NAME }}{% endblock %}
{% block body %}

{% macro linkable_header(heading, label) %}
	<h3 id="{{ label }}">{{ heading }}<a class="header-anchor" href="#{{ label }}"><i class="fa fa-link" aria-hidden="true"></i></a></h3>
{% endmacro %}

<h1>Using the Site</h1>

{{ linkable_header("Torrent Colors", "torrent-colors") }}
<div>
	<span style="color:green; font-weight: bold;">Green</span> (trusted) entries are:
	<ul>
		<li>Torrents that have been verified by the archive team or trusted users.</li>
	</ul>
	<span style="color:red; font-weight: bold;">Red</span> (repack) entries are torrents that match any of the following:
	<ul>
		<li>Repackage or recompress of original media.</li>
		<li>Unofficial edit, reencode or remaster of original media.</li>
		<li>Reupload of original media with missing and/or unrelated additional files.</li>
	</ul>
	<span style="color:orange; font-weight: bold;">Orange</span> (collection) entries are:
	<ul>
		<li>Torrents that represent a larger collection or bundle, such as a series of related files, a collection of works by a single author, or a curated selection of files on a specific topic.</li>
		<li>Torrents that provide supplementary materials or resources related to other files in the archive, such as documentation, tutorials, or additional data.</li>
	</ul>
	<span style="color:grey; font-weight: bold;">Grey</span> entries are:
	<ul>
		<li>Hidden torrents.</li>
	</ul>
</div>

{{ linkable_header("Using the Search Engine", "using-search") }}
<div>
	Search results can be filtered by category, edited, trusted, and users.
	The results can be further sorted by size, date, seeders, leechers, completed count, and comment count.
</div>
<div>
	You can combine search terms with the <kbd>|</kbd> operator, such as
	<kbd>foo|bar</kbd>, to match any of the words instead all of them.
</div>
<div>
	To exclude results matching a certain word, prefix them with <kbd>-</kbd>,
	e.g. <kbd>foo -bar</kbd>, which will return torrents with <em>foo</em> in the
	name, but not those which have <em>bar</em> in the name as well.
</div>
<div>
	If you want to search for a several-word expression (substring) in its entirety, you can
	surround searches with <kbd>"</kbd> (double quotes), such as
	<kbd>"foo bar"</kbd>, which would match torrents named <em>foo bar</em> but not
	those named <em>bar foo</em>. You may also use the aforementioned <kbd>|</kbd> to group
	phrases together: <kbd>"foo bar"|"foo baz"</kbd>. You can negate the entire
	group with <kbd>-</kbd> (e.g. <kbd>-"foo bar"|"foo baz"</kbd>), but not single items.
</div>
<div>
	You can also use <kbd>(</kbd> and <kbd>)</kbd> to signify precedence, but quoted strings do
	not honor this. Using <kbd>(hello world) "foo bar"</kbd> is fine, but quoted strings inside
	the parentheses will lead to unexpected results.
</div>

{{ linkable_header("Reporting Torrents", "reporting") }}
<div>
	If you find a torrent that breaks the rules, click the
	<button type="button" class="btn btn-xs btn-danger">Report</button> button to the right
	of the torrent's information page. Then, enter a reason for your report in the
	dialog that opens, and hit the <button type="button" class="btn btn-xs btn-danger">
	Report</button> button to confirm.
</div>

{{ linkable_header("Styling Descriptions and Comments", "styling") }}
<div>
	You can style your comments and your torrent's description using
	<a href="https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet">Markdown</a>.
	This includes adding images or linking to external websites.
</div>
<div>
	To link to an external site, use <kbd>[label](https://example.com)</kbd>
	where the text in the <kbd>[]</kbd> square brackets is the shown text of your
	link, and the URL in the <kbd>()</kbd> parentheses is the URL your link will
	point to.
</div>
<div>
	Embedding an image is similar. Use <kbd>![alt text](https://example.com/image.jpg)</kbd>
	to have an image embedded in your comment or description. Note the <kbd>!</kbd>
	exclamation mark at the beginning, denoting that this link is an image.
</div>

{{ linkable_header("Changing Your User's Avatar", "avatar") }}
<div>
	<s>The site uses the <a href="https://www.gravatar.com">Gravatar</a> service for user avatars.
	Check out <a href="https://www.gravatar.com/support/">Gravatar's help section</a> for more detailed instructions.</s>
	Gravatar is disabled until further notice.
</div>

{{ linkable_header("Deleting Your Torrent", "delete") }}
<div>
	If you wish to delete one of your torrents, navigate to the torrent's page,
	click the Edit (<i class="fa fa-fw fa-pencil"></i>) icon on the top left,
	scroll down and hit the <button type="button" class="btn btn-xs btn-danger">Delete</button>
	button.
</div>

{{ linkable_header("Getting Trusted Status", "trusted") }}
<div>
	At the moment we have no established process for granting trusted status to users.
	Please contact the team if you'd like to apply as a trusted user.
</div>

<div>
	<h2>Copyright infringement</h2>
	<p>If you are a copyright holder and believe that your work is being hosted on this platform
		without your permission, please contact us at pbagnpg@flagubevn.zbr (ROT13 encoded). We take copyright infringement seriously and will
		promptly remove any infringing content upon receipt of a valid takedown notice. Please provide us with
		sufficient information to identify the copyrighted work, such as the title, description, and URL of the infringing
		content, as well as proof of your ownership or rights to the work. We will respond to all valid takedown notices and work
		with you to resolve the issue promptly.</p>
</div>
<div>
	<h2>Credits</h2>
	<p>Synthoria Archive is based on <a href="https://github.com/sb745/NyaaV3" target="_blank">NyaaV3</a> and licensed under GPLv3. <a href="https://github.com/ProjectSynthoria/SynthoriaArchive" target="_blank">Source code available here</a>.</p>
</div>
{% endblock %}