major changes

- landing page
- overall color
- go to top button
- new macros
- analytics
- stable variable
- redirect link
- 404 page(will be edited later time)
This commit is contained in:
Ömercan Kömür 2021-08-31 14:08:01 +03:00
parent b1ec8f2950
commit 137c315e63
7 changed files with 463 additions and 134 deletions

View file

@ -1,70 +1,5 @@
# Welcome to the Libretro/RetroArch Documentation!
---
template: home.html
title: Home
---
![www.retroarch.com](image/branding/retroarch_banner.png)
RetroArch is the official reference frontend for libretro "cores": applications that include emulators, game engines, and media players. Settings are also unified across cores with advanced features like shaders, netplay, rewinding, and more!
![www.libretro.com](image/branding/libretro_banner.png)
Libretro is a simple backend API for emulators, game engines, and media players to be run through a unified GUI.
## Which platforms is RetroArch available for?
RetroArch runs and is supported on GNU/Linux, BSD, Windows, Mac OSX (PPC/Intel), Haiku, PlayStation Classic, PlayStation 2, PlayStation 3, Playstation Vita, Playstation Portable, Xbox 360, Xbox One, Raspberry Pi, Nintendo GameCube, Nintendo Wii, Nintendo Wii U, Nintendo 3DS & 2DS Family, Nintendo Switch, Steam Link, Android, iOS, Open Pandora, Blackberry and even on web browsers by using the Emscripten compiler.
## What is the license for this?
libretro is released under the MIT license. RetroArch is released under the GNU GPLv3. The cores are usually released with the same license as the originating projects.
## What emulators, games, and other cores are currently supported?
You can see a list sorted by hardware maker under *For Users > Core Library: Emulation*
## Official Links
=== "Main"
- [Website](https://www.retroarch.com/)
- [Twitter](https://twitter.com/libretro)
- [Facebook](https://www.facebook.com/libretro)
- [Forum](https://forums.libretro.com/)
- [Discord](https://discord.gg/27Xxm2h)
- [YouTube](https://www.youtube.com/Libretro)
- [Lakka's Website](https://lakka.tv/)
- [Github Repository](https://github.com/libretro/RetroArch)
- [Lakka's Twitter](https://twitter.com/lakkatv)
=== "Help"
- [F.A.Q](https://www.retroarch.com/?page=faq)
- [Libretro Documentation](https://docs.libretro.com/)
- [Lakka Doc](http://www.lakka.tv/doc/Home/)
- [Facebook Group](https://www.facebook.com/groups/retroarch/)
- [Steam Group](https://steamcommunity.com/groups/libretro)
=== "Support"
- [Teespring](https://teespring.com/stores/retroarch)
- [Patreon](https://www.patreon.com/libretro)
- [YouTube Membership](https://www.youtube.com/channel/UCjAimkVp-G_o6HK5MXujk9A/join)
=== "Video"
- [LibRetro](https://www.youtube.com/Libretro)
- [RetroArch Gameplays](https://www.youtube.com/RetroArchOfficial)
- [Dailymotion](https://dailymotion.com/retroarch)
- [Facebook Watch](https://www.facebook.com/watch/libretro/)
- [Facebook Gaming](https://www.facebook.com/gaming/libretro/)
- [Lakka's YouTube](https://www.youtube.com/channel/UCsFAXPsgzbU-6KRKqumtbXA)
=== "Storefronts"
- [Steam](https://store.steampowered.com/app/1118310/RetroArch/)
- [Itch.io](https://retroarchofficial.itch.io/retroarch)
- [Steam Developer Page](https://store.steampowered.com/developer/libretro)

375
docs/overrides/home.html Normal file
View file

@ -0,0 +1,375 @@
<!-- Custom HTML site displayed as the Home chapter -->
{% extends "main.html" %}
{% block tabs %}
{{ super() }}
<style>
.md-main {
flex-grow: 0
}
.md-main__inner {
display: flex;
height: 100%;
}
.tx-container {
padding-top: .0rem;
background: linear-gradient(#333333, #5ea2c9);
}
.tx-hero {
margin: 32px 2.8rem;
color: var(--md-primary-bg-color);
justify-content: center;
}
.tx-hero h1 {
margin-bottom: 1rem;
color: currentColor;
font-weight: 700
}
.tx-hero__content {
padding-bottom: 1rem;
margin: 0 auto;
}
.tx-hero__image{
max-width: auto;
height: auto;
order:1;
padding-right: 2.5rem;
}
.tx-hero .md-button {
margin-top: .5rem;
margin-right: .5rem;
color: var(--md-primary-bg-color)
}
.tx-hero .md-button--primary {
background-color: var(--md-primary-bg-color);
color: hsla(280deg, 37%, 48%, 1);
border-color: var(--md-primary-bg-color)
}
.tx-hero .md-button:focus,
.tx-hero .md-button:hover {
background-color: var(--md-accent-fg-color);
color: var(--md-default-bg-color);
border-color: var(--md-accent-fg-color)
}
.feature-item h2 svg {
height: 30px;
float: left;
margin-right: 10px;
transform: translateY(10%);
}
.top-hr {
margin-top: 42px;
}
.feature-item {
font-family: 'Lato', sans-serif;
font-weight: 300;
box-sizing: border-box;
padding: 0 15px;
word-break: break-word
}
.feature-item h2 {
color: #333;
font-weight: 300;
font-size: 25px;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
line-height: normal;
margin-top: 20px;
margin-bottom: 10px;
font-family: inherit;
}
.feature-item p {
font-size: 16px;
line-height: 1.8em;
text-rendering: optimizeLegibility;
-webkit-font-smoothing: antialiased;
color: #111;
margin: 0 0 10px;
display: block;
}
.feature2-item {
font-family: 'Lato', sans-serif;
font-weight: 300;
box-sizing: border-box;
padding: 0 15px;
word-break: break-word
}
.feature2-item h2 {
color: #333;
font-weight: 300;
font-size: 25px;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
line-height: normal;
margin-top: 20px;
margin-bottom: 10px;
font-family: inherit;
text-align: center;
}
.feature2-item p {
font-size: 18px;
line-height: 1.8em;
text-rendering: optimizeLegibility;
-webkit-font-smoothing: antialiased;
color: #111;
margin: 0 0 10px;
display: block;
border: 2px solid powderblue;
padding: 15px;
text-align: center;
}
@media screen and (max-width:30em) {
.tx-hero h1 {
font-size: 1.4rem
}
}
@media screen and (min-width:60em) {
.md-sidebar--secondary {
display: none
}
.tx-hero {
display: flex;
align-items: center;
justify-content: center;
}
.tx-hero__content {
max-width: 22rem;
margin-top: 3.5rem;
margin-bottom: 3.5rem;
margin-left: 1.0rem;
margin-right: 4.0rem;
align-items: center;
}
}
@media screen and (min-width:76.25em) {
.md-sidebar--primary {
display: none
}
.top-hr {
width: 100%;
display: flex;
max-width: 61rem;
margin-right: auto;
margin-left: auto;
padding: 0 .2rem;
}
.bottom-hr {
margin-top: 10px;
width: 100%;
display: flex;
max-width: 61rem;
margin-right: auto;
margin-left: auto;
padding: 0 .2rem;
}
.feature-item {
flex: 1;
min-width: 0;
}
.feature-item:hover {
background-color: #526cfe47;
border-radius: 3px;
}
.flex-container {
flex-wrap: wrap;
}
}
.hr {
border-bottom: 1px solid #eee;
width: 100%;
margin: 20px 0;
}
.text-center {
text-align: center;
padding-right: 15px;
padding-left: 15px;
margin-right: auto;
margin-left: auto;
margin-top: 15px;
font-family: 'Lato', sans-serif;
font-size: 23px;
font-weight: 300;
padding-bottom: 10px;
}
.logos {
display: flex;
align-items: center;
justify-content: center;
flex-flow: row wrap;
margin: 0 auto;
}
.logos img {
flex: 1 1 auto;
padding: 25px;
max-height: 130px;
vertical-align: middle;
}
.hr-logos {
margin-top: 0;
margin-bottom: 30px;
}
.md-footer-meta__inner {
display: flex;
flex-wrap: wrap;
justify-content: space-between;
margin-top: 1.0rem;
}
.md-footer-social {
padding-top: 20px;
}
</style>
<!-- Main site Entry button descriptions -->
<section class="tx-container">
<div class="md-grid md-typeset">
<div class="tx-hero">
<div class="tx-hero__image">
<img src="img/bg.png" draggable="false">
</div>
<div class="tx-hero__content">
<h1> RetroArch </h1>
<p>RetroArch is a frontend for emulators, game engines and media players.</p>
<a href="{{ page.next_page.url | url }}" title="{{ page.next_page.title | striptags }}" class="md-button md-button--primary">
Get started
</a>
<a href="https://www.retroarch.com/index.php?page=platforms" class="md-button">
Download
</a>
<a href="https://docs.libretro.com/development/libretro-overview/" class="md-button">
Developer
</a>
</div>
</div>
</div>
</section>
<!-- Main site box descriptions -->
<div class="top-hr">
<div class="feature-item">
<h2>
Cross platform
</h2>
<p>RetroArch can run on the usual platforms like Windows, Mac OS X and Linux. RetroArch also runs on Apple and Android for tablets and phones, as well as on game consoles like PS3, PSP, PS Vita, Wii, Wii U and more! </p>
<a href="https://www.retroarch.com/index.php?page=platforms" class="md-button">
See the list!
</a>
</div>
<div class="feature-item">
<h2>
Latency
</h2>
<p>RetroArch is capable of next-frame responsive time. This means that there should be no nearly no perceivable difference in terms of input latency from real hardware, FPGA/clone or original hardware. On top of all that, there are various settings you can configure to optimize the results even more.</p>
<a href="https://www.retroarch.com/index.php?page=latency" class="md-button">
Learn more!
</a>
</div>
<div class="feature-item">
<h2>Controller</h2>
<p>Common game controllers are automatically configured when plugged in, just like a real console. Ideal for multiplayer games when a friend brings their own controller! You can also configure controllers manually to assign special actions to button combos.</p>
<a href="https://www.retroarch.com/index.php?page=controller-autoconfig" class="md-button">
Learn more!
</a>
</div>
<div class="feature-item">
<h2>Shaders</h2>
<p>Shaders are efficient graphical filters that can greatly improve the rendering of old games. They can also be used to replicate the look and feel of old CRT monitors. You can even stack them to create your own effect. The possibilities are endless.</p>
<a href="https://www.retroarch.com/index.php?page=shaders" class="md-button">
Learn more!
</a>
</div>
<div class="feature-item">
<h2>Achievements</h2>
<p>Unlock achievements on your favorite classic games! Unlock trophies and badges like on a modern game consoles!</p>
<a href="https://www.retroarch.com/index.php?page=achievements" class="md-button">
Learn more!
</a>
</div>
<div class="feature-item">
<h2>Netplay</h2>
<p>Host or join a network gaming session. Rediscover the joy of multiplayer games using RetroArch built-in netplay lobby. You can also use the spectator mode to watch others play.</p>
<a href="https://www.retroarch.com/index.php?page=netplay" class="md-button">
Learn more!
</a>
</div>
</div>
<div class="top-hr">
<div class="hr">
</div>
</div>
<div class="feature2-item">
<p>It enables you to run classic games on a wide range of computers and consoles through its slick graphical interface. Settings are also unified so configuration is done once and for all. In addition to this, you are able to run original game discs (CDs) from RetroArch. RetroArch has advanced features like shaders, netplay, rewinding, next-frame response times, runahead, machine translation, blind accessibility features, and more!
RetroArch is the official reference frontend for libretro "cores": applications that include emulators, game engines, and media players. Settings are also unified across cores with advanced features like shaders, netplay, rewinding, and more!
Libretro is a simple backend API for emulators, game engines, and media players to be run through a unified GUI.</p>
<a href="https://www.retroarch.com/" class="md-button">
Find out more!
</a>
</div>
<div class="feature2-item">
<h2>Which platforms is RetroArch available for?</h2>
<p>RetroArch runs and is supported on GNU/Linux, BSD, Windows, Mac OSX (PPC/Intel), Haiku, PlayStation Classic, PlayStation 2, PlayStation 3, Playstation Vita, Playstation Portable, Xbox 360, Xbox One, Raspberry Pi, Nintendo GameCube, Nintendo Wii, Nintendo Wii U, Nintendo 3DS & 2DS Family, Nintendo Switch, Steam Link, Android, iOS, Open Pandora, Blackberry and even on web browsers by using the Emscripten compiler.</a>
</div>
<div class="feature2-item">
<h2>What is the license for this?</h2>
<p>Libretro is released under the MIT license. RetroArch is released under the GNU GPLv3. The cores are usually released with the same license as the originating projects.</a>
</div>
<div class="top-hr">
<div class="hr">
</div>
</div>
<!-- Custom narrow footer -->
<div class="md-footer-meta__inner md-grid">
<div class="md-footer-social">
<a class="md-footer-social__link" href="https://github.com/libretro" rel="noopener" target="_blank" title="github.com">
<svg viewBox="0 0 480 512" xmlns="http://www.w3.org/2000/svg"><path d="M186.1 328.7c0 20.9-10.9 55.1-36.7 55.1s-36.7-34.2-36.7-55.1 10.9-55.1 36.7-55.1 36.7 34.2 36.7 55.1zM480 278.2c0 31.9-3.2 65.7-17.5 95-37.9 76.6-142.1 74.8-216.7 74.8-75.8 0-186.2 2.7-225.6-74.8-14.6-29-20.2-63.1-20.2-95 0-41.9 13.9-81.5 41.5-113.6-5.2-15.8-7.7-32.4-7.7-48.8 0-21.5 4.9-32.3 14.6-51.8 45.3 0 74.3 9 108.8 36 29-6.9 58.8-10 88.7-10 27 0 54.2 2.9 80.4 9.2 34-26.7 63-35.2 107.8-35.2 9.8 19.5 14.6 30.3 14.6 51.8 0 16.4-2.6 32.7-7.7 48.2 27.5 32.4 39 72.3 39 114.2zm-64.3 50.5c0-43.9-26.7-82.6-73.5-82.6-18.9 0-37 3.4-56 6-14.9 2.3-29.8 3.2-45.1 3.2-15.2 0-30.1-.9-45.1-3.2-18.7-2.6-37-6-56-6-46.8 0-73.5 38.7-73.5 82.6 0 87.8 80.4 101.3 150.4 101.3h48.2c70.3 0 150.6-13.4 150.6-101.3zm-82.6-55.1c-25.8 0-36.7 34.2-36.7 55.1s10.9 55.1 36.7 55.1 36.7-34.2 36.7-55.1-10.9-55.1-36.7-55.1z"></path></svg>
</a>
<a class="md-footer-social__link" href="https://twitter.com/libretro" rel="noopener" target="_blank" title="twitter.com">
<svg viewBox="0 0 512 512" xmlns="http://www.w3.org/2000/svg"><path d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path></svg>
</a>
<a class="md-footer-social__link" href="mailto:libretro@gmail.com" rel="noopener" target="_blank" title="">
<svg viewBox="0 0 512 512" xmlns="http://www.w3.org/2000/svg"><path d="M502.3 190.8c3.9-3.1 9.7-.2 9.7 4.7V400c0 26.5-21.5 48-48 48H48c-26.5 0-48-21.5-48-48V195.6c0-5 5.7-7.8 9.7-4.7 22.4 17.4 52.1 39.5 154.1 113.6 21.1 15.4 56.7 47.8 92.2 47.6 35.7.3 72-32.8 92.3-47.6 102-74.1 131.6-96.3 154-113.7zM256 320c23.2.4 56.6-29.2 73.4-41.4 132.7-96.3 142.8-104.7 173.4-128.7 5.8-4.5 9.2-11.5 9.2-18.9v-19c0-26.5-21.5-48-48-48H48C21.5 64 0 85.5 0 112v19c0 7.4 3.4 14.3 9.2 18.9 30.6 23.9 40.7 32.4 173.4 128.7 16.8 12.2 50.2 41.8 73.4 41.4z"></path></svg>
</a>
</div>
</div>
{% endblock %}
{% block content %}{% endblock %}
{% block footer %}{% endblock %}

BIN
docs/overrides/img/bg.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 405 KiB

59
docs/overrides/main.html Normal file
View file

@ -0,0 +1,59 @@
<!-- Elements added to main will be displayed on all pages -->
{% extends "base.html" %}
<!-- Google Tag Manager -->
{% block libs %}
<script>
var gtmId = 'GTM-KXPH36V';
if (typeof window !== 'undefined' && window.location.href.includes('127.0.0.1')) {
gtmId = 'GTM-XXX'
}
(function(w,d,s,l,i){
w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer', gtmId);
</script>
<script async src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
<script>
(adsbygoogle = window.adsbygoogle || []).push({
google_ad_client: "ca-pub-9447404270680650",
enable_page_level_ads: true
});
</script>
{% endblock %}
<!-- Announcement bar -->
{% block announce %}
<style>.md-announce a,.md-announce a:focus,.md-announce a:hover{color:currentColor}.md-announce strong{white-space:nowrap}.md-announce .twitter{margin-left:.2em;color:#00acee}</style>
<a href="https://retroarch.ga/r"><strong>New in 1.9.8! Read the blog post now!</strong>
</a>
{% endblock %}
<!-- More minimal footer -->
{% block footer %}
<footer class="md-footer">
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<!-- Copyright and theme information -->
<div class="md-footer-copyright">
{% if config.copyright %}
<div class="md-footer-copyright__highlight">
{{ config.copyright }}
</div>
{% endif %}
powered by
<a href="https://www.mkdocs.org" title="MkDocs">MkDocs</a>
and
<a href="https://squidfunk.github.io/mkdocs-material/"
title="Material for MkDocs">
Material for MkDocs</a>
</div>
{% block social %}
{% include "partials/social.html" %}
{% endblock %}
</div>
</div>
</footer>
{% endblock %}

View file

@ -0,0 +1,10 @@
:root {
--md-primary-fg-color: #333333;
--md-primary-fg-color--light: #ECB7B7;
--md-primary-fg-color--dark: #90030C;
--md-accent-fg-color: #2e2e2e;
--md-accent-fg-color--transparent: #2e2e2e;
--md-accent-bg-color: #121212;
--md-nav-item--active: #050505;
}

View file

@ -370,6 +370,9 @@ nav:
extra:
version: '0.1.0'
adsense: "ca-pub-9447404270680650"
analytics:
provider: google
property: UA-170150040-2
font:
text: 'Roboto'
code: 'Roboto Mono'
@ -390,17 +393,19 @@ extra:
link: https://youtube.com/libretro
theme:
name: 'material'
custom_dir: overrides
name: material
custom_dir: docs/overrides/
# 404 page
static_templates:
- 404.html
# Don't include MkDocs' JavaScript
include_search_page: false
search_index_only: true
# Default values, taken from mkdocs_theme.yml
language: en
features:
- tabs
#- instant
palette:
primary: indigo
accent: indigo
- navigation.tabs
- navigation.top
font:
text: Roboto
code: Roboto Mono
@ -415,6 +420,8 @@ extra:
unit:
stable: 1.9.8
extra_css:
- stylesheets/extra.css
markdown_extensions:
- admonition
@ -460,4 +467,4 @@ markdown_extensions:
- pymdownx.tabbed
- pymdownx.tasklist:
custom_checkbox: true
- pymdownx.tilde
- pymdownx.tilde

View file

@ -1,57 +0,0 @@
{#-
This file was automatically generated - do not edit
-#}
{% extends "base.html" %}
{% block libs %}
<!-- Google Tag Manager -->
<script>
var gtmId = 'GTM-KXPH36V';
if (typeof window !== 'undefined' && window.location.href.includes('127.0.0.1')) {
gtmId = 'GTM-XXX'
}
(function(w,d,s,l,i){
w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer', gtmId);
</script>
<!-- End Google Tag Manager -->
{% endblock %}
{% block extrahead %}
{% set title = config.site_name %}
{% if page and page.title and not page.is_homepage %}
{% set title = config.site_name ~ " - " ~ page.title | striptags %}
{% endif %}
{% set image = config.site_url ~ 'image/branding/bg.png' %}
<meta property="og:type" content="website">
<meta property="og:title" content="{{ title }}">
<meta property="og:description" content="{{ config.site_description }}">
<meta property="og:url" content="{{ page.canonical_url }}">
<meta property="og:image" content="{{ image }}">
<meta property="og:image:type" content="image/png">
<meta property="og:image:width" content="703">
<meta property="og:image:height" content="513">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:site" content="@libretro">
<meta name="twitter:creator" content="@libretro">
<meta name="twitter:title" content="{{ title }}">
<meta name="twitter:description" content="{{ config.site_description }}">
<meta name="twitter:image" content="{{ image }}">
{% endblock %}
{% block announce %}
<style>.md-announce a,.md-announce a:focus,.md-announce a:hover{color:currentColor}.md-announce strong{white-space:nowrap}.md-announce .twitter{margin-left:.2em;color:#00acee}</style>
<a href="https://www.libretro.com/index.php/retroarch-1-9-8-released/" target="_blank">
New version <strong><u>1.9.8</u></strong> is out <strong>download now!</strong>
</a>
<script async src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
<script>
(adsbygoogle = window.adsbygoogle || []).push({
google_ad_client: "ca-pub-9447404270680650",
enable_page_level_ads: true
});
</script>
{% endblock %}