L'outil informatique Obsidian

Obsidian est un PKM (Personal Knowledge Management) une application logicielle de prise de notes personnelles qui utilise le format MarkDown. 

Obsidian a été créé par Shida Li et Erica Xu pendant la mise en quarantaine liée au covid. Obsidian est construit sur framework Electron qui s'exécute sur Windows Linux et MacOS ainsi que sur les mobiles Android et iOS.

Après une rapide découverte des fonctionnalités, en effet c'est cool tous ces liens possibles entre pages internes, externes et les dates, c'est facile ludique et la vue graphique est top.

Tableau de bord - Obsidian

C'est cool mais une fois passé ce premier effet whaou, mon objectif est d'arriver au plus vite à synchroniser mon travail dans Obsidian avec l'application de mon Desktop et de mon Mobile phone et là ... c'est le drame ou plutôt c'est cher !

Synchroniser vos notes Obsidian

J'essaye quand même, on me dit que je peux sauver/synchroniser dans GitHub, j'installe en premier l'extension Git Publisher qui fonctionne mais attention :

Warning
Do not use this plugin to sync or save your Obsidian Vault!
Avoid opening the converted files from your repository in Obsidian!

Cette extension ne peut pas servir de sauvegarde elle ne sert qu'à publier les pages mark-down sur votre git-hub donc finalement cela n'a que très peu d’intérêt.

J'installe alors l'extension Obsidian Git, avec je peux sauver dans GitHub, je configure l'extension, depuis mon Desktop ça fonctionne mais j'essaye en suite depuis mon Mobile phone et :

Obsidian création d'un clone Github - Failed !

Authentification failed, en fait cela ne m'étonne pas étant donné le modèle économique d'Obsidian si la synchro depuis un site GitHub avait fonctionné, j'aurais pu me passer d'un abonnement à 8$ / mois chez Obsidian.

Je suppose que la connexion de l'application Obsidian sur Mobile phone par l'extension Obsidian Git ne fonctionne pas, en plus depuis peu GitHub oblige à une double authentification avec coffre fort etc etc ... ceci explique peut être cela.

C'est dommage car l'extension Obsidian Git vis à vis de Git et très complète vous avez toutes les fonctionnalités, les commandes de git mais attention :

https://github.com/denolehov/obsidian-git#performance-on-mobile

Des restrictions sur Mobile phone sont également à prévoir.

Warning
Sometimes, the branch may not be merged due to merge conflicts. This can occur if you push too frequently.

Conclusion

Des restrictions, des choses pourtant simples, impossibles à faire, Obsidian devra rester sur votre Desktop ou sur votre Mobile phone, sinon c'est cher pour ce que c'est ! 

Le service de synchro dans le cloud est à 8$ / mois actuellement.

L'application Obsidian sur mobile phone ne permet pas d'ouvrir des fichiers qu'en local du téléphone mobile et pas dans le cloud !

De plus toutes les fonctionnalités existent déjà dans d'autres logiciels.

Solution pour synchro Obsidian entre desktop et mobile

J'ai installé GitHub sur mon Mobile phone, je peux aller browser les pages mark-down mais ce n'est pas vraiment satisfaisant pas fun fun cette histoire.

Autre solution : installer sur votre téléphone une application de synchronisation entre un répertoire local et un répertoire de votre cloud demandez à chatgpt :

Solid Explorer (Android) Google Drive, Dropbox, OneDrive, et plus encore.
FileExplorer (iOS) : Google Drive, Dropbox, OneDrive, etc.
FolderSync (Android) : Google Drive, Dropbox, OneDrive, et bien d'autres.
Resilio Sync (Android et iOS)
Sync.com (Android et iOS)
...

Alors vous savez quoi et bien j'ai installé Solid Explorer croyant avoir enfin la solution à mon problème tout simple de synchronisation et bien vous savez quoi ? C'est payant !

Et en plus vous n'imaginez pas la complexité de connexion de Solid Explorer au Cloud OneDrive de Microsoft ...

Alors donc je tente une synchro entre mon Cloud et un répertoire local de mon mobile Android et vous savez quoi :

Synchronisation fichiers Cloud Android avec Solid Explorer

Tout ça pour tomber sur vieux bug des familles d'appel de fonction sur un objet null au bout de 1 minute et 13 secondes !

C'est quoi Jekyll's avec Github ?

Vous cherchez à faire de la documentation avec Github, cela parait pratique et gratuit et l'on vous laisse avec GitHub Page & Jekyll

https://github.com/mabyre/docs

Jekyll est une catastrophe assez utilisé.

https://mabyre.github.io/error/

Jekyll est une erreur de la nature. Voici un site avec Jekyll c'est d'une pauvreté sans nom :

https://mabyre.github.io/

Autre exemple de site avec Jekyll et GitHub Page :

https://fluentribbon.github.io/

Notez la pauvreté du Site... 

Le site dans le GitHub avec Jekyll ont une url de genre :

<github name>.github.io

GitHub - Comment décorer votre page d'accueil ?

GitHub est l'environnement de développement des codes sources le plus important dans le monde. Il est probable que si vous êtes sur cette page vous avez déjà un compte GitHub et sinon c'est que vous n'êtes pas développeur. 

GitHub et GitLab se tirent la bourre depuis le début, je pense que GitHub est bien plus utilisé par les grandes communautés de développeurs, il permet notamment de publier les logiciels Open Sources.

Les fonctionnalités de GitHub évoluent sans cesse à tel point qu'il est difficile de suivre.

Je viens de découvrir comment personnaliser ma page d'accueil de mon compte GitHub en regardant ce que d'autres avaient fait, alors je vous livre le trick.

Sur votre profile GitHub, dans la liste de vos Repositories il vous suffit de choisir New pour créer un nouveau repository auquel vous donnez votre nom github :

Personnaliser votre page d'accueil dans GitHub

Il vous suffit alors de créer un fameux fichier README.md dans ce repository pour qu'il apparaisse en lieu et place de votre page d'accueil.

Follow me on Github!

That's all Folks!

GitHub vs GitLab

Finalement GitLab fait comme GitHub alors lequel offre les meilleures fonctionnalités ? Pour moi GitHub était la seule plateforme où publier un projet Open Source mais il ne pouvait pas être privé alors que GitLab c'était plutôt pour ceux qui souhaitaient installer leur propre plateforme. Qu'en est-il aujourd'hui ? 

Voici un article qui essaye de tuer la question... mais c'est vu par GitLab :

GitLab - GitLab vs GitHub : GitLab : 54,5/73 GitHub : 21/73

GitLab - GitLab vs GitHub

Franchement, c'est pas abuser ! Non ? Ils se réservent leur version payante pendant quelques années, ils attendent que tout le monde passe sur GitHub gratuit et pouf ; ils déploient leur GitLab platforme en ligne... gratuit. Ça c'est pas bien ! Mais vous me direz, ils leur faut bien une stratégie marketing pour concurrencer leur principal concurrent GitHub.

En plus, ils conservent une version entreprise et dans ce comparatif, ils ne disent pas quelle version ils comparent. C'est beau la publicité comparative ! 

Et même je crois dans cet article qu'ils sont en retard sur les fonctionnalités de GitHub car il me semble bien que les fonctionnalités de management agile des projets ont évoluées récemment dans GitHub.

Faut-il aller plus loin ... pour répondre à cette question GitLab ou GitHub, lequel de ces outils gestionnaires de code source faut-il choisir ? Le réponse peut être ici :

Digital Guide IONOS - GitLab vs GitHub

Il semble qu'ici nous avons une étude complète :

Digital Guide IONOS - GitLab vs GitHub : Comparatif des deux systèmes de contrôle de version
Une étude très complète de cette question posée GitHub vs GitLab. 

GitHub a l'avantage d'une énorme base d'utilisateurs et donc un quasi monopole racheté par Microsoft en 2018. Et oui, c'est ce que je disais GitHub à commencer à offrir son service en ligne bien avant. On se souvient des migrations de code source du CodePlex vers GitHub dont le Compilateur C# Roslyn.

Donc IONOS nous dit que GitHub est la plateforme la plus stable et la plus performante. Mais l'interface Utilisateur de GitLab semble plus clair et s'adapte aux terminaux mobiles tandis que l'interface de GitHub est fixe.

Mais je me demande bien quel être saugrenu pourrait avoir l'envie de faire du développement sur son mobile ? GitLab offre un EDI ... là encore quelle idée saugrenu. Vous imaginez le développeur qui fait des modifications de code source en ligne ... Et les TESTS c'est après ?!

Bémol pour GitLab, les Issues ne peuvent pas être suivies dans plusieurs Repositories.

IONOS nous dit aussi GitHub : Repositories privés payant - C'est devenu faux. C'est récent chez GitHub pas de souci pour rendre votre Repositori Privé.

Je vous laisse avec les Tutos IONOS sur GitHub et sur GitLab.

Et si vous cherchez  un autre type de gestionnaire de codes sources :

WIKIPEDIA - Comparison of source-code-hosting facilities
Attention là ça fait mal au cheveux et les donnée que j'y ai trouvé sont un peu anciennes mais il n'y a pas que GitHub et GitLab dans la vie d'un développeur, il y a aussi Azure DevOps ;-)

La recherche des Internautes GitHub vs GitLab

Pour tenter de départager cette question, un petit Google Trends :

Trends de recherche entre les termes GitHub et GitLab

Il ne faut en tirer aucune conclusion concernant l'utilisation de la solution ni les fonctionnalités associées. C'est simplement le reflet de l'intérêt de ceux qui recherche une information sur GiHub ou GitLab.

Conclusion sur GitHub vs GitLab

Bref ... beaucoup de choses à dire, à mon avis les deux solutions se valent de très prêt avec au début une grosse avance pour GitHub que GitLab essaye de combler. Ils sont sans cesse en train de modifier leurs offres, ce qui est très bien pour nous, ils se concurrencent et comme cela on évite un ultime monopôle pour GitHub et nous avons la joie de voir une autre implémentation au dessus de Git (Linus Torvalds).

Mon conseil, si vous avez un projet d'envergure international open source avec une communauté de développeurs dans le monde entier privilégiez GitHub. Si vous avez un projet interne ou d'entreprise prenez GitLab. 

Mais pourquoi ne pas utiliser les deux ... 

Mise à jour en décembre 2020 - On évoque une solution alternative au grands GaFams c'est Gitea: Git with a cup of tea.

Gitea est un service Git auto-hébergé indolore. Il est similaire à GitHub, Bitbucket et GitLab. Gitea est un fork de Gogs. Consultez le billet de blog Gitea Announcement pour en savoir plus sur la justification d'un fork.

Gitea: Git with a cup of tea

Il y a un peu de Go là dedans ! Donc méfions nous des grands GaFams ils sont un peu partout...

Visual Studio Code et le Contrôle de Version GitHub

C'est bien Visual Studio Code c'est un bel outil très différent de Visual Studio, il s'installe très rapidement et permet de développer dans à peu prêt n'importe quel langage. Ce qui est bien avec Visual Studio Code c'est qu'un projet ce n'est pas un fichier .csproj et une solution .sln propriétaire, c'est un répertoire racine un peu comme dans Eclipse.

Pour ouvrir un projet, il suffit d'ouvrir le répertoire racine des sources dans Visual Studio Code et il se débrouille tout seul. Alors comme j'ai un vieux projet en Langage C à traiter et qu'à l'époque j'étais avec Eclipse vous imaginez qu'utiliser VS Code pour remanier quelque peu les codes source de ce projet ce serait magnifique.

Et maintenant, je me créé un Repository Git pour y commiter mes sources alors quel support j'ai pour Git Hub dans Visual Studio Code ?



Le nouvel éditeur de codes source - Visual Studio Code

Au passage, on note une petite pique contre GitHub car Microsoft préconise plutôt Team Azure comme Repository plutôt que GitHub mais après tout c'est de bonne guerre.

Private Host Git provider - Azure DevOps

Visual Studio Code - Version Control

Donc avec Visual Studio Code, j'ai ouvert le répertoire de mes sources en langage C, j'ai cliqué sur l'icône "Source Contrôle" (ou Built-in Git"), j'ai cliqué sur le + pour ajouter tous mes sources. je n'ai plus qu'une question :

Visual Studio Code - How to configure a remotes repository to publish ?

Et là c'est curieusement StackOverFlow qui me répond :

stackoverflow - Visual Studio Code - Connect to remote GIT repository and PUSH local files to new remote Repository

Mais (bip) que c'est compliqué en ligne commande ...  Alors qu'il y a plein de commandes à cet endroit là de Visual Studio Code  :



Visual Studio Code intègre Git en ligne de commande

C'est pas fun ! Pas fun du tout ! En fait stackoverflow ne répond pas à ma question qui est pourtant simple :

Visual Studio Code - How to configure a remotes repository to publish

Car quand je clique dans Visual Studio Code sur la commande "push to" il me répond :

Your Repository has no remotes configured to publish to.

J'ai beau cliqué sur la rondelle ...

Your Repository has no remotes configured to publish to - Manage Extension

J'arrive sur Git VS Code - Git SCM Integration ...



Visual Studio Code - Git Intégration

C'est là que j'ai une fulgurance ... ne faudrait t-il pas installer une extension pour GitHub ?

Je tape GitHub dans "EXTENSIONS: MARKETPLACE" :

GitHub KnisPeter

J'installe l'extension GitHub pour Visual Studio Code là je pense que je tiens le bon bout.

No fun at all!

Non en fait pas du tout, je ne suis pas sur la bonne piste, j'utilise toutes les commandes correctement depuis VS Code qui est positionné sur le répertoire que je souhaite Commiter dans GitHub. Mais rien n'y fait.

Your repository has no remotes configured to push to

Solution :

Et puis je me rappelle que j'avais déjà réussi à gérer mes codes source depuis Visual Studio, je regarde un peu dedans le me dis qu'avec Visual Studio, je suis connecté avec un utilisateur alors que VS Code ne me le propose pas.

CQFD ! J'ouvre la console Git et je tape la commande suivante :

>git config --list



>git config --list

Je regarde le user.name et le user.email et je me dis que ce sont ceux de mon compte Azure Cloud alors que je cherche à me connecter à GitHub !

Voilà, il ne me reste plus qu'à lire la page suivante :

git-scm - 1.6 Démarrage rapide - Paramétrage à la première utilisation de Git

A la rubrique "Votre identité" pour connaitre les commandes pour changer d'identité dans Git.

> git config --global user.name "John Doe"
> git config --global user.email johndoe@example.com

Pas très fun!


ZDNet - Outil de reverse engineering sous licence libre Ghidra

Vous connaissez Ghidra ? La National Security Agency a publié Ghidra, un outil de reverse engineering sous licence libre utilisé depuis plus de 10 ans en interne. ZDNet - Ghidra

L'existence de Ghidra a été initialement rendue publique via Wikileaks en mars 2017 mais il a fallut attendre la déclassification du logiciel deux ans plus tard. Les formats binaires pris en charge sont très nombreux on retrouve dans la liste un nombre impressionnant de micro-processeurs.


Outil de reverse engineering de la NSA

Il existe une alternative nommée IDA Pro mais elle vaut des milliers de dollars par an. IDA Pro est un désassembleur et débogueur pour Windows Linux ou Mac OS. C'est le standard en matière d'analyse de code hostile.

NSA sous GitHub - Ghidra 

Cet outil est maintenant un logiciel Open Source sous Github :

https://github.com/NationalSecurityAgency/ghidra

Ghidra est en Java, il faut avoir installé le Java Development Kit 11. Mais a priori l'installation de cet outil n'est pas plus compliqué que de dézipper l'archive.

Au cas cela disparaisse moi je prends des notes et je l'ai téléhargé ... LoL ...

Visual Studio - Team Explorer & GitHub - Ce qui manquait pour bien démarrer

Nous avons vu dans l'article suivant que pour bien démarrer il faut synchroniser le projet pour la première fois dans git hub. Comment le faire avec Visual Studio dans Team Explorer avec GitHub ?

Vous avec créé un projet avec Visual Studio vous souhaitez le mettre en gestion de configuration dans GitHub comment faire simplement dans l'article précédent nous avions installé Git et TortoiseGit pour ce faire ici nous allons utilisé les fonctionnalités Tema Explorer de Visual Studio.

D'abord dans GitHub on créé un Repositorie :



GitHub création d'un nouveau Repositorie

GitHub vous fournit alors l'URL de ce repo quelque chose en .git que vous allez pouvoir utiliser avec Team Explorer de Visual Studio.

Vous avez créé votre Repo local en entrant le chemin de votre projet sur votre disque dur Team Explorer vous permet alors de Synchroniser votre Repo local :


Synchronisez votre Repo Local dans Github

Team Explorer vous propose d'entrer l'URL de votre Repo dans Github :


Publier le dépôt Git

Pour synchroniser votre Repo Local avec Github. Il détecte alors qu'il n'y a rien dans le Repo de Github. Vous pouvez alors publier directement dans GitHub :


URL de votre Repo dans Gihub

Team Explorer vous permet d'entrer l'URL de votre Repo Github. Vous pouvez ensuite cliquer sur "Publier" pour uploader votre projet dans GitHub.

Quand vous retournez dans l'Explorateur de solution vous voyez les "petits cadenas" signes que votre projet est maintenant en gestion de configuration.


Projet Visual Studio en gestion de configuration dans GitHub

CQFD !


GitLab comment exporter son Wiki ?

Vous utilisez GitLab et vous avez écris des pages Wiki mais comment faire pour les exporter et pour réutiliser vos pages dans un autre GitLab ou ailleurs dans un GitHub ?

Venez, c'est par ici, suivez moi.

GitLab - Les pages wiki de mon projet

Nous voyons le bouton "Clone repository", cliquons dessus :

GitLab - Les pages wiki Clone repository

Maintenant, on nous demande d'installer un outil "Gollum" ce n'est pas très joli (gollum il est lait ;)

Oui mais un Gem c'est quoi ? Gem

Et Gollum ? Gollum

Encore un de ces outils Linuxien ... Installer Gollum Wiki sur Ubuntu

Qu'elle Daube ! Sans parler de gollum/gollum

Syntaxe et explications sur les fichiers Gollum

On est bien avancé ! Et si on clonait tout simplement ... voici la commande Clone your wiki :

>git clone https://username@gitlab.societe.fr/MonProjet/Documentation.wiki.git

Clone de mon Wiki avec Git - Oui je sais ma console est verte

On se retrouve alors avec un sous répertoire "Documentation.wiki" dans lequel on retrouve, pour chaque page wiki, un fichier .md bien connu des utilisateurs de Git c'est un fichier MarkDown.

GitLab - Mon Wiki cloné dans le répertoire "Mon projet.wiki"

Et vous le comprenez en voyant le répertoire ".git" que ce répertoire est maintenant un repo git à part entière. Il vous suffit d'installer un éditeur de fichiers .md pour travailler sur votre wiki en local et de faire un git commit par la suite ... Pour retrouver vos pages modifiées dans GitLab, c'est super bien fait ! Non ?

Nous venons d'apprendre à développer la documentation de votre projet sous forme de Wiki dans Github.

CQFD !