tyto-litterateur/website_doc/article/metas_liens.html

137 lines
7.2 KiB
HTML

<!-- Écrire/créer des liens - Tyto - Littérateur (page generated by Tyto - Littérateur) -->
<!DocType html>
<html lang="fr">
<head>
<!--# include virtual="/template/metas.html"-->
<!-- Metas/Links from domain and article -->
<meta name="generator" content="Tyto - Littérateur">
<!-- metas generated from domain -->
<meta name="url" content="https://tyto.echolib.re/">
<meta name="language" content="fr">
<meta name="reply-to" content="echolib+tyto@a-lec.org">
<meta name="copyright" content="gfdl-1.3">
<!-- metas generated from article -->
<meta name="title" content="Écrire/créer des liens">
<meta name="author" content="echolib">
<meta name="description" content="Comment écrire des liens pour Tyto - Littérateur">
<meta name="keywords" content="Tyto,littérateur,logiciel libre,documentation,format .tyto,écrire,liens">
<!-- metas links to template files -->
<link rel="canonical" href="https://tyto.echolib.re/article/metas_liens.html">
<link rel="stylesheet" href="../template/styles.css">
<link rel="shortcut icon" type="image/png" href="../template/favicon.png">
<link rel="alternate" type="application/rss+xml" href="../rss.xml" title="RSS 2.0 Tyto - Littérateur">
<!-- Open Graph data -->
<meta property="og:site_name" content="Tyto - Littérateur">
<meta property="og:title" content="Écrire/créer des liens">
<meta property="og:type" content="article">
<meta property="og:url" content="https://tyto.echolib.re/article/metas_liens.html">
<meta property="og:description" content="Comment écrire des liens pour Tyto - Littérateur">
<meta property="og:image" content="https://tyto.echolib.re/template/VH_Tyto_logo.png">
<!-- Publication date and title -->
<meta itemprop="datePublished" content="2024-01-15 18:28:34" id="date">
<title>Écrire/créer des liens (echolib) | Tyto - Littérateur</title>
</head>
<body>
<div id="site_container">
<!--# include virtual="/template/header.html"-->
<!--# include virtual="/template/navbar.html"-->
<main id="article_sidebar"> <!-- Contains <article> and <aside> -->
<article id="article">
<time datetime="2024-01-15 18:28:34">
<header id="article_header">
<h1 role="heading" aria-level="1" id="article_title">
<a role="link" id="article_title_link" href="https://tyto.echolib.re/article/metas_liens.html" title="Écrire/créer des liens -- echolib, 08/01/2024">Écrire/créer des liens</a>
</h1>
<div id="article_refs">
echolib, 08/01/2024 [<a id="post_code" class="tyto" href="./metas_liens.tyto" title="Code source : Écrire/créer des liens">Code source</a>]
</div>
</header>
<h2 role="heading" aria-level="2" class="toc_title">Table des matières</h2>
<nav role="navigation" class="toc" aria-labelledby="navigation-0">
<ul role="list" class="toc_items">
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_1">Métadonnées d'entête</a></li>
<ul>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_2">Lien "link:"</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_3">Lien "image:", "file:"</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_4">Les URIs spécifiques</a></li>
<li role="listitem" class="toc_item"><a class="toc_item_link tyto" href="#toc_5">Configurer les marqueurs de liens</a></li>
</ul>
</ul>
</nav>
<h2 role="heading" aria-level="2" id="toc_1" class="tyto">Métadonnées d'entête</h2>
<p class="tyto">
Pour créer un lien, il faut d'abord le référencer dans l'entête de l'article,
au dessus du séparateur <code class="tyto">-----</code>. Chaque marqueurs peut-être utilisé
plusieurs fois et se configure sur 3 lignes. Mais chaque identité du marqueur
doit être unique (tous marqueurs confondus). Il existe 2 types de marqueurs
de lien :
<ul role="list" class="tyto">
<li role="listitem" class="tyto">vers une URL / un URI ; marqueur <code class="tyto">link:</code> uniquement</li>
<li role="listitem" class="tyto">vers un fichier interne (PDF, image...) ; autres marqueurs</li>
</ul>
</p>
<h3 role="heading" aria-level="3" id="toc_2" class="tyto">Lien "link:"</h3>
<p class="tyto">
L'URL (ou l'URI) du marqueur <code class="tyto">link:</code> n'est pas vérifiée. Vous pouvez
pointer vers un document interne (comme une autre page du site avec
<code class="tyto">../doc/index.html</code>), mais n'oubliez pas de vérifier que le lien, dans
la page HTML, pointe bien vers le document.
</p>
<h3 role="heading" aria-level="3" id="toc_3" class="tyto">Lien "image:", "file:"</h3>
<p class="tyto">
Les marqueurs <code class="tyto">image:</code> et <code class="tyto">file:</code> étant destinés à créer des liens
vers des ressources internes, ils n'acceptent que les URIs. <cite class="tyto">Tyto</cite>
vérifie la présence des fichiers pointés dans le dossier de travail
</p>
<h3 role="heading" aria-level="3" id="toc_4" class="tyto">Les URIs spécifiques</h3>
<p class="tyto">
Vous pouvez en lire plus sur <a role="link" class="tyto" href="./metas_uris.html" title="Comment cibler un fichier avec les URIs spécifiques des marqueurs pour Tyto - Littérateur">les URIs spécifiques</a>
</p>
<h3 role="heading" aria-level="3" id="toc_5" class="tyto">Configurer les marqueurs de liens</h3>
<pre class="bcode_pre">
<ol class="bcode_items">
<li role="listitem" class="bcode_item"><code class="bcode_code"># De manière générale:</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># marqueur: identité</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># URL / URI</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># texte descriptif</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Lien vers une URL ou fichier (interne)</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">link: ma page web</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> https://... ou ./index.html</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Texte alternatif</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Lien vers un fichier interne</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">file: mon fichier</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> fichier.pdf</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Texte alternatif</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"></code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"># Lien vers une image interne</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code">image: mon image</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> @paysages/montagne.png</code></li>
<li role="listitem" class="bcode_item"><code class="bcode_code"> Texte alternatif</code></li>
</ol></pre>
</time>
</article>
<!--# include virtual="/template/sidebar.html"-->
</main>
<!--# include virtual="/template/footer.html"-->
</div> <!-- #site_container -->
</body>
</html>