docs

Réglages

Tout ce qui vit derrière ⌘, — quatre onglets : Général pour le comportement, Apparence pour l'allure de PullMark, Clavier pour le plan des touches, et Expérimental pour les fonctionnalités encore en rodage. La fenêtre se rouvre sur le dernier onglet utilisé.

Général

Vous lisez ceci là où PullMark (0.28.1+) est installé ? Ouvrez l'onglet Général.

Lecture

RéglageOptions · défautEffet
Restaurer les fichiers et pull requests de la dernière session activé/désactivé — activé Rouvre ce qui était dans la barre latérale au dernier arrêt de PullMark — fichiers, dossiers, PR, dépôts parcourus, et l'entrée d'aperçu (toujours en aperçu).
Afficher les fichiers cachésactivé/désactivé — désactivé Les dotfiles et dossiers cachés dans Emplacements — les docs de .github/ et compagnie. Se bascule aussi avec ⇧⌘. (le combo du Finder lui-même) ou Présentation → Afficher les fichiers cachés ; chaque emplacement ouvert re-scanne à la bascule.
Liens Markdown GitHub Demander au premier clic · Ouvrir dans PullMark · Ouvrir dans le navigateur — Demander au premier clic Ce que fait un clic sur un lien vers un fichier Markdown sur GitHub. Maintenez ⌘ en cliquant pour l'autre comportement. La case « Mémoriser mon choix » du dialogue au premier clic règle ceci pour vous.
Clic sur un fichier dans Emplacements Aperçu d'abord · Ouvrir complètement — Aperçu d'abord Aperçu d'abord montre un fichier d'un seul clic sans le garder — une entrée en italique (dans Fichiers ouverts, ou sous son dépôt GitHub) que l'aperçu suivant remplace ; double-cliquez ou commencez à éditer pour le garder. Ouvrir complètement garde chaque fichier cliqué. Vaut pour les dossiers locaux comme pour les dépôts GitHub parcourus. Voir Aperçus.

Révision

RéglageOptions · défautEffet
Disposition par défaut des diffsEn ligne · Côte à côte — En ligne Comment s'ouvrent les diffs rendus de PR. Inversable par fichier avec ⌥⌘L.
Afficher les demandes de révision dans la barre latéraleactivé/désactivé — activé Le sous-groupe Demandes de révision : les PR ouvertes où votre révision est demandée. Masqué dans tous les cas quand vous n'êtes pas connecté.
Uniquement les demandes qui modifient du Markdownactivé/désactivé — activé Masque les demandes de révision sans fichier Markdown — PullMark n'a rien à montrer pour elles.
Afficher la discussion de révision dans la vue d'ensemble de la PRactivé/désactivé — activé Les fils de révision en ligne, imbriqués sous leur révision dans la conversation de la vue d'ensemble — chaque fil, y compris pour les fichiers que PullMark ne rend pas, avec le passage commenté à côté. Désactivé, seuls verdicts et commentaires s'affichent. Sorti d'Expérimental en 0.34.

GitHub

RéglageEffet
Connexion Si PullMark peut parler à GitHub, en tant que qui, et par quelle source d'identifiants (« Connecté en tant que vous · GitHub CLI »). Vérifier à nouveau relit les identifiants — après gh auth login, la connexion s'établit sans relancer — et Configurer… ouvre un guide qui détecte ce qui manque à ce Mac. Voir Accès GitHub pour toute l'histoire des identifiants.

Mises à jour

RéglageEffet
Afficher les nouveautés après une mise à jour Activé (le défaut), les notes de version se présentent après une mise à jour ; désactivé, une discrète bannière « Mis à jour vers PullMark X » prend le relais avec les notes à un clic — une mise à jour s'annonce toujours d'une façon ou d'une autre.
Mises à jour Rechercher les mises à jour… à la demande ; PullMark vérifie aussi au lancement et périodiquement. Quand une mise à jour est déjà connue, la ligne propose Nouveautés, Mettre à jour et un bouton de re-vérification sur place. Nouveautés montre les notes de chaque version entre la vôtre et la nouvelle, et Aide → Notes de version garde l'historique complet à tout moment.

Système

RéglageEffet
App Markdown par défaut Montre quelle app ouvre actuellement les fichiers .md ; Définir PullMark par défaut revendique l'association en un clic. Si une mise à jour ultérieure la fait sauter côté macOS, PullMark s'en aperçoit et propose de la reprendre.
Ligne de commande Installe la commande pullmark dans /usr/local/bin pour les installations par DMG (les utilisateurs Homebrew l'ont déjà). Affiche une coche quand un pullmark est déjà sur votre PATH.
Aperçus Quick Look Rendu (le défaut) ou Source brute — ce que montre la barre Espace dans le Finder pour les fichiers Markdown.

Apparence

Vous lisez ceci là où PullMark (0.28.1+) est installé ? Ouvrez l'onglet Apparence.

L'interrupteur Clair · Sombre · Système siège en haut — toute l'app suit, chrome et pages rendues comprises (chaque thème apporte ses propres visages clair et sombre). En dessous, les options visuelles :

Chaque choix ici est une carte avec un aperçu en direct, rendu par le vrai pipeline — ce que vous voyez est ce que les documents obtiennent.

Thème

ThèmeAllure
GitHub (défaut)Le look classique, exactement comme sur github.com.
EditorialDes titres à empattements façon livre, sur papier chaud.
TerminalDu monospace avec un accent vert phosphore.

Thèmes personnalisés : déposez des fichiers .css dans le dossier Themes (bouton dans cet onglet) et ils apparaissent en cartes. Ils s'appliquent par-dessus le look GitHub, suivent l'apparence Clair/Sombre et restylent aussi les diffs. Les aperçus Quick Look suivent votre thème (les thèmes personnalisés y retombent sur leur base GitHub).

Largeur du contenu

ChoixSignification
Standard (défaut)Une justification classique, façon livre.
WideDes lignes plus longues, plus de texte à l'écran — la longueur de ligne reste plafonnée.
Full WidthLe texte occupe toute la fenêtre — pratique en plein écran.

S'applique partout, en direct, et se compose avec les thèmes, le blame, les diffs et le zoom. Se change aussi en pleine lecture via Présentation → Largeur du contenu.

Numéros de ligne

ChoixSignification
Masqués (défaut)Une marge nette ; des numéros à la demande dans la vue Source.
AffichésLa ligne source de départ de chaque bloc dans la marge des documents rendus et des diffs — survolez un numéro pour la plage complète du bloc. La numérotation est par bloc, pas par ligne visuelle (le texte rendu se replie librement). La vue source brute montre toujours ses propres numéros de ligne.

Clavier

Vous lisez ceci là où PullMark (0.28.1+) est installé ? Ouvrez l'onglet Clavier.

Le raccourci de chaque action de menu se réassigne — voir Raccourcis clavier pour le plan complet et le fonctionnement de l'enregistrement, des conflits et de « Rétablir les valeurs par défaut ».

Expérimental

Vous lisez ceci là où PullMark (0.28.1+) est installé ? Ouvrez l'onglet Expérimental.

Les fonctionnalités livrées avant que leur conception soit figée, chacune étiquetée bêta ou alpha — le contrat des niveaux explique ce que chacun promet. Les fonctionnalités alpha restent cachées tant que vous n'activez pas Afficher les fonctionnalités alpha (un dialogue explique d'abord les termes de l'alpha), et chaque fonctionnalité a son propre interrupteur. Les notes de marge vivent ici — en bêta depuis 0.35 et activées par défaut, avec leur interrupteur, le réglage d'auteur et un bouton Copier pour l'extrait d'instructions destiné à l'agent ; la première utilisation présente la fonctionnalité et propose de la désactiver.

Où les choses sont stockées

Toutes les préférences vivent dans le domaine de defaults app.pullmark.PullMark. Sessions, positions de lecture et brouillons ne sont que des métadonnées — PullMark ne copie jamais vos documents nulle part, et le contenu récupéré depuis GitHub reste en mémoire.