Forum général.cherche-logiciel Génération / Gestion de documentations techniques

Posté par  (site web personnel) .
Étiquettes :
3
15
juin
2012

Hello !

Je suis amené dans mon travail à rédiger énormément de documentation technique.

Ce travail de documentation est parfois très répétitif, surtout au sujet de la mise en page qui doit être faite de façon homogène entre les différents documents.

Je me demandais donc s'il vous connaissiez un soft (si possible libre sous Linux), qui permettrait de rédiger les docs dans un format interne à partir duquel le soft serait capable de générer les docs sous différents formats (HTML, PDF, (…)

Forum Programmation.python Débutant cherche documentation

Posté par  (site web personnel) . Licence CC By‑SA.
Étiquettes :
2
4
août
2022

Bon(jour|soir),

J'ai commencé il y a peu (une semaine), une autoformation sur Python (avec l'aide Pluralsight).

Je pense avoir compris les bases, mais je bute principalement sur la recherche de documentations.

Premièrement, je n'arrive pas à trouver un équivalent des man pour les modules python. Ça me semble quand même plus simple de ne pas sortir de mon terminal.

Genre ce qui m’intéresse, c'est de trouver la documentation de sys.path.insert(). Or dans la doc Python pour ce module (…)

Forum Programmation.autre Tous les fichiers texte dans un même buffer vim/neovim

Posté par  (site web personnel, Mastodon) . Licence CC By‑SA.
Étiquettes :
2
23
nov.
2023

Salut,

J'écris beaucoup de documents à base de fichiers markdown assemblés par un Makefile qui génère ensuite un pdf (principalement avec pandoc).

Pour découper le document, j'ai pas mal de fichiers par chapitres, annexes, …
Pour modifier ou chercher dans le document il faut donc que j'ouvre chaque fichier indépendamment et je me retrouve avec un tas d'onglets et de buffers séparés qui ne facilite pas la recherche et l'édition pour la correction.

Je me demandais s'il n'existe pas une (…)

Wiki [PHP] Tester si le serveur cache (redis) fonctionne

Licence CC By‑SA.
Étiquettes :
0
16
avr.
2019

Voici un exemple de code testant si le serveur cache redis est bien fonctionnel.
Vous pouvez voir un exemple type de son fonctionnement dans ce script de HealthCheck pour nextcloud.

Tester la disponibilité (connexion) d'un unique serveur

<?php
$CONFIG['redis']['host'] = "127.0.0.1";
$CONFIG['redis']['port'] = 6379;

echo checkCacheRedis($CONFIG);

function checkCacheRedis($CONFIG){
                    /* on definit le port par défaut si l'utilisateur ne l'a pas défini
(…)

Forum Programmation.autre rédaction documentation technique avec LYX

Posté par  . Licence CC By‑SA.
Étiquettes :
0
18
mar.
2015

Bonjour,

Je développe essentiellement en PHP/HTML/Javascript/SQL, je me suis lancé dans l'écriture de documentation technique de mes développements au moyen de LyX.

J'aime beaucoup ce genre d'outil qui permet de se concentrer sur le contenu (sans s'occuper de la mise en forme, ni avoir à apprendre un nouveau langage ;-) et après quelques recherches sur le nain ternet, j'aimerai recueillir vos conseils éclairés :

  • confirmez-vous que ce choix est un des plus adaptés pour cette tache ?

  • actuellement j'utilise la classe de (…)

Wiki [Tuto/HowTo] Automatiser simplement les mises à jours de configurations sur cluster via script bash

Licence CC By‑SA.
Étiquettes :
0
15
nov.
2018

Introduction

Nous allons voir ici comment automatiser simplement la mise à jours de configurations depuis un stockage distant (webdav, sshfs, etc). Pour ce job, nous allons utiliser un script bash dédié.

Ce dernier vous permet de ranger vos fichiers de configurations sur votre cloud (montage distant) puis de les ré-injecter via une tâche planifiée (cron).

Le script est capable d'auto-éditer les fichiers de configuration (une fois enregistrés localement) afin d'indiquer l'hostname de la machine ainsi (…)

Journal \o/ Manuel de blender pas annulé !

Posté par  (site web personnel) .
Étiquettes :
0
8
mar.
2004
Voila le mail que je viens de recevoir :

Dear customer,

Almost two weeks ago we delivered all material to the book printer,
and they've now confirmed the final schedule. So here are some interesting
dates:

March 12: book printing finished
March 15-17: cdroms inserted in book
March 18: books delivered at my place
March 19: book signing with personal messages!
March 20/21: packing books, and make ready for shipment (almost 1400
books!)
March 22: Spring Express Mail picks books (…)

Forum Astuces.divers Ajout d'annexes markdown à un document libreoffice

Posté par  (site web personnel, Mastodon) . Licence CC By‑SA.
Étiquettes :
0
16
juin
2022

Salut,

Savez vous s'il existe un moyen d'ajouter/lier des annexes markdown à un document libreoffice (writer).

Mon problème est le suivant, je suis en train d'écrire un document avec libreoffice.writer pour un logiciel/matériel (c'est du FPGA donc plutôt du Gateware). Mais la description des différents registres est déjà documenté avec le code (VHDL) dans des fichier README.md (au format markdown donc).

Mon rêve serait de pouvoir décrire le logiciel de manière global en Libreoffice et d'intégrer cette description des (…)

Journal Arghhh le manuel blender ne sortira pas !!

Posté par  (site web personnel) .
Étiquettes :
0
10
fév.
2004
Voici l'horrible mail que je viens de recevoir d'amazon (après 4 mois de précommande)...


A votre attention, de la part d'amazon.fr.

Nous avons le regret de vous informer que la parution de
l'article suivant a ete annulee :

Ton Roosendaal, Stefano Selleri "The Official Blender 2.3 Guide:
Free 3d Creation Suite for Modeling, Animation, and Rendering"

Bien que nous pensions pouvoir vous envoyer ces articles, nous avons
depuis appris qu'il ne serait pas edite. Nous en sommes sincerement
desoles.

Cet (…)

Nouvelle documentation de Gentoo

Posté par  (site web personnel) . Modéré par Nÿco.
Étiquettes :
0
23
jan.
2004
Gentoo
Le Gentoo handbook est disponible depuis quelques temps en anglais et en français. Cette nouvelle documentation remplace les nombreux Howto sur l'installation de cette distribution et est une excellente introduction pour celle-ci.

En plus de la partie sur l'installation du système qui vous guide à travers les nombreux choix qui la composent (par un système d'étapes et de liens qui vous mènent directement à la partie de la page qui vous intéresse), une seconde partie apporte plus d'information sur l'utilisation de la distribution avec une section sur la variable USE et plusieurs sur portage, son comportement et sa configuration. Elle se termine par une explication sur le système de scripts d'initialisation utilisé par Gentoo et un survol des variables d'environnements.

À savoir que les howto sur les thèmes non traités dans le handbook et les anciens guides d'installation sont toujours disponibles depuis la page documentation du site.