#gitbook

The new look for Aptivi documentation is now live! 🎉

#GitBook #Website #TechNews #TechUpdates #Aptivi #Documentation #csharp #programming #dotnet

Rollout of the new docs look is done!

The GitBook documentation for our projects will be easier to navigate!

#GitBook #Website #Docs #TechNews #TechUpdates #Nitrocid #Terminaux #dotnet #csharp #programming

The documentation will be easier to navigate

You can now see how will our GitBook documentation look like!

#GitBook #Website #TechNews #TechUpdates #Documentation #Docs #Aptivi #Branding #WebDesign

Here’s your sneak peek of the improved docs design!

Chỗ in Sticker giá rẻ uy tín lấy nhanh tại HCM - In Sticker giá rẻ

Dịch vụ in tem nhãn giá rẻ đảm bảo uy tín chất lượng HCM - In tem nhãn giá rẻ

Cơ sở in túi giấy giá rẻ đảm bảo chất lượng tại HCM - In túi giấy giá rẻ

A comunidade de código aberto produz uma grande quantidade de software para diferentes usos. Produção de filmes, carros inteligentes, internet das coisas. Estes são alguns exemplos. Veja a seguir onze ferramentas de código aberto para ajudar  escritores a serem mais criativos.

Por que ferramentas de código aberto para escritores?

Antes de começarmos, gostaria de explicar brevemente por que o…

View On WordPress

Sixmo Three: Reading for the Active

Project Overview:
With the mere amount of information I was learning from the books I read, I had to have a place to jot it down. Though, I only wanted the important aspects of what I read, without the literary fluff. 

• Easy to access book of all the books I read in 2016 (26 total)
  
• Easily organized information by title and author.
• Only the important information and a few anecdotes to clarify confusion.

Challenge:
Finding the right solution to host the content, cheaply and efficiently, was the number one requirement. I wanted this book to be available for a long time but a good solution might be unaffordable. 

Results:
Reading for the Active is a compilation of assorted nonfiction books I read, blinked or listened to on audible throughout 2016. Fortunately, I found Gitbook, a hosted book solution that allowed me to write content uninhibited. 

My favorite book was Straight to Hell by John LeFevre.

Access it here.

Reading for the Active is released under Creative Commons Attribution.

GitBook, genera documentación online desde tu escritorio Ubuntu

En el siguiente artículo vamos a echar un vistazo a GitBook. Esta es una aplicación GUI multiplataforma, que tiene como principal función llevar el flujo de trabajo de GitBook a nuestro escritorio en Ubuntu. Echándole un vistazo a su interfaz se ve que está bien pensada para editar texto y trabajar con la vista previa en vivo del proyecto.

Cientos de miles de usuarios utilizan GitBook para escri…

View On WordPress

This is a guide that anyone could use to learn about the practice of front-end development. It broadly outlines and discusses the practice of front-end engineering: how to learn it and what tools are used when practicing it in 2017.

It is specifically written with the intention of being a professional resource for potential and currently practicing front-end developers to equip themselves with learning materials and development tools. Secondarily, it can be used by managers, CTOs, instructors, and head hunters to gain insights into the practice of front-end development.

The content of the handbook favors web technologies (HTML, CSS, DOM, and JavaScript) and those solutions that are directly built on top of these open technologies. The materials referenced and discussed in the book are either best in class or the current offering to a problem.

The book should not be considered a comprehensive outline of all resources available to a front-end developer. The value of the book is tied up in a terse, focused, and timely curation of just enough categorical information so as not to overwhelm anyone on any one particular subject matter.

The intention is to release an update to the content yearly.

The handbook is divided into three parts.

Part I. The Front-End Practice

Part one broadly describes the practice of front-end engineering.

Part II: Learning Front-End Development

Part two identifies self-directed and direct resources for learning to become a front-end developer.

Part III: Front-End Development Tools

Part three briefly explains and identifies tools of the trade.

New Post has been published on http://vivihome.net/2016/12/28/documenter-vos-projets-autrement-avec-git-et-asciidoc/

Documenter vos projets autrement avec git et asciidoc

Un collègue m’a fourni une vidéo intéressante sur une manidère différente de gérer une documentation projet : https://youtu.be/1rKgVF5CEEY

Il est vrai que cela fait un moment qu’on tourne autour du pot. Les wikis c’est bien mais le bon logiciel est toujours délicat à trouver. Sans détailler la réflexion ici (peut être une autre fois) il y a toujours une contrainte qui fait que ce n’est jamais parfait…

Je suis donc en train de me pencher sur une mouvance qui me semble intéressante : gérer sa documention as a code. En simplifiant cela veut dire que votre documentation est gérée dans un dépot git, avec un outil de collaboration sympa comme gitlab et  des fichiers sous forme plain text avec une syntaxe simple et lisible comme markdown ou asciidoc (j’ai tendance a préférer le second actuellement).

Cela vous permet d’avoir une documentation ou chacun peut collaborer simplement (coucou pull request). De plus, il se trouve que github et gitlab intègrent les syntaxes asciidoc et markdown en natif, vous pouvez donc déjà naviger dans votre documentation directement sur leur site web.

Le fin du fin sera de générer un site statique joli (avec un moteur de recherche) et si possible une version pdf. C’est la que l’excellent gitbook entre en action.

Enfin, pour mettre la cerise sur le gateau, vous pouvez rebuilder votre site documentaire de manière automatisée avec un job gitlab ci bien senti.

Au passage, pour le job gitlab je me suis construit une image docker gitbook qui m’aide bien.

Cette manière de faire semble s’étendre car même chez owasp an a choisi de construire le nouveau developer guide de cette manière sur github.

Que du bon donc pour l’instant ! A creuser à l’usage.

Ongoing work on a living styleguide for ITRE, including plugins and wordpress themes. I’m building it to automatically assemble documentation inside the github repository for each piece and then pull all of the documents together into a single Gitbook. Mostly I’m using Gulp to build the documentation on compile and includes to pull the documents into Gitbook.

A few months ago I stumbled across Gitbook, a tool that allows you to publish content as Markdown/HTML and then access it in a range of formats appropriate to web, print and mobile. I’ve written about it in a post on inclusivity, but it really deserves it’s own post and some wider recognition.

Here’s a video overview of the Gitbook web interface when you set up a new project.

What draws you in is the thoughtfulness that has gone into the design and the simplicity. You can set up your account with standard social media accounts; Facebook, Twitter, Google+ to verify authorship but if you also do any code development you can link the account to GitHub creating extra opportunities for publishing documentation. You can import Github, a Word document or HTML making it simple to work with existing material.

In the same way as Github, you can allow your publications to be forked/remixed by others and when you commit/save a change it has associated metadata with author, time date etc. You also have version control, so individuals/groups could work on different branches/versions, making it a pretty exciting tool for collaborative writing work.

If you’re familiar with CSS styles, you can also customise separate styles for each format, so you can have your .pdf looking different to your web version, which might be useful for readability purposes.

There’s an editing app for Mac, Windows and Linux, meaning you don’t have to use a code editor when you’re offline.

I’ve started a couple of projects in Gitbook; one about Digital Literacies in HE, as I think there might be room for a collaborative publication in the area and another is my portfolio for Certified Membership of the Association for Learning Technology which is gradually developing.

As if all the features and apps weren’t enough, you can even have enterprise accounts, which would mean all of your institutional documentation can live as code, facilitating better governance, interoperability, transparency, accessibility… literally every buzzword that you need to tick off for HE.

This book, by Jonathan Stray, is about using data in journalism. But it’s not a particularly practical book. Instead it’s for the curious, for those who wonder about the deep ideas that hold everything together. — Tow Center for Digital Journalism

딥러닝 공부를 시작하면서 GitBook에 내용을 정리하고 있습니다.

각자가 겪은 문제점이나 노하우를 공유하면 좋을 것 같습니다.

참여하고 싶은 분들은 저에게 연락주세요.

Update (16/03/01) - 링크 수정

滿有趣的經驗分享。
自動化產生 PDF 電子書，主要依賴技術 GitLab, GitLab-CI, Gitbook 。

He publicado un nuevo articulo en http://www.manuelfernandoweb.com/gitbook-la-mejor-forma-de-crear-libros-digitales/

GitBook, la mejor forma de crear libros digitales

http://www.manuelfernandoweb.com/gitbook-la-mejor-forma-de-crear-libros-digitales/

GitBook es un moderno conjunto de herramientas de edición que permite la escritura de forma colaborativa y fácil de libros, documentos, publicaciones, manuales, trabajos de investigación y demás recursos en Internet. GitBook es una plataforma joven que inicio su operación en el año 2014 con la visión de crear una solución moderna y simple permitiendo que tanto usuarios del hogar como organizaciones empresariales puedan crear sus artículos de forma digital empleando el sistema de control de versiones mas popular llamado GIT, desarrollando los contenidos mediante el uso de la sintaxis en Markdown o AsciiDoc.

La filosofía de GitBook es la de ser lo mas simple posible hasta el punto de la elegancia, la eliminación de las distracciones, problemas y preocupaciones que pueden presentar los autores, para que puedan expresar sus ideas libremente. GitBook  permite escribir, publicar y administrar sus libros en línea como un servicio.

GitBook.com esta desarrollada bajo código abierto y su código fuente esta disponible en GitHub.

Para registrarse en la plataforma, se pueden crear las cuentas de usuario usando la cuenta de GitHub o las cuentas sociales de Twitter, Facebook o Google Plus, también dispone del formulario como método tradicional de registro. Las organizaciones empresariales tienen también la posibilidad de instalar una versión en sus propios servidores.

Los libros o publicaciones digitales que se comparten pueden ser publicas o privadas según el paquete que se tenga, a demás se tiene la posibilidad de personalizar la URL.

La posibilidad de crear publicaciones privadas no se encuentra disponible para las cuentas gratuitas, sólo en las diferentes opciones de pago existentes.

Tanto los usuarios como las organizaciones empresariales tiene la posibilidad de ver las estadísticas de lecturas, acceso sobre las publicaciones; conocer el numero exacto de vistas del articulo y las descargas realizadas a través del sistema de GitBook.

Actualmente ya son mas de 80.000 autores que utilizan GitBook para publicar libros, manuales e investigaciones conformando mas de las 24.000 publicaciones.