aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: ef80eea676f18af156388cacee1af1b595639443 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
# Libre Social
### Descripción

Fuentes de Letra [Fonts] para Redes sociales Libres y otros servicios descentralizados que apoyan el uso de Software Libre.

[![pipeline status](https://gitlab.com/heckyel-ng/libresocial/badges/master/pipeline.svg)](https://gitlab.com/heckyel-ng/libresocial/commits/master)

## Utilización

Copie los directorios __css__ y __fonts__ con sus archivos a su proyecto, y agregue una línea al _head_ de su archivo html.

Ejemplo:

```html
<link href="css/libresocial.css" rel="stylesheet"/>
```

Si usted es un experto puede reordenar sus directorios para mejor comodidad.

## Log de Cambios
- v1.1.2 - Agrega PeerTube y PixelFed
- v1.1.1 - Agrega Liberapay y Matrix
- v1.1.0 - publicación inicial

## Iconos disponibles

+ Diaspora
+ Friendica
+ GitLab
+ GNUSocial
+ Hubzilla
+ Liberapay
+ Mastodon
+ Matrix
+ MediaGoblin
+ Notabug
+ PeerTube
+ PixelFed
+ Pump
+ Tox
+ XMPP

![libresocial.png](https://img.fenixzone.net/i/7fyO6HD.png?raw=true)


## Hacking en Libre Social

- Dependencias
  - FontForge (Se necesita de una versión >= 20140101)
  - Python >= 2.6 or 3

- Instrucciones

  - Fuente:
    Los íconos se localizan en 2 directorios __scr__ y __lab__.

    Explicando lo anterior:

    __scr__: aquí se encuentran los archivos de imagen vectorial con sus __cuadrículas__ para ayudar a la edición futura de los mismos; así mismo encontrará un archivo llamado __template.svg__ el cual es una plantilla para crear futuras imágenes vectoriales que luego serán íconos.

    __lab__: aquí se encuentran los archivos de imagen vectorial listos para su compilación.

  - Edición de __metadata.json__

    Si usted agrega una nueva imagen vectorial, debe editar el archivo __metadata.json__:

    Ejemplo:

    ```html
    "glyphs": {
      "0xe800": "diaspora.svg",
      "0xe801": "friendica.svg",
      "0xe802": "gitlab.svg",
      "0xe803": "gnusocial.svg",
      "0xe804": "hubzilla.svg",
      "0xe805": "liberapay.svg",
      "0xe806": "mastodon.svg",
      "0xe807": "matrix.svg",
      "0xe808": "mediagoblin.svg",
      "0xe809": "notabug.svg",
      "0xe810": "peertube.svg",
      "0xe811": "pixelfed.svg",
      "0xe812": "pump.svg",
      "0xe813": "tox.svg",
      "0xe814": "xmpp.svg",
      "0xe815": "nueva.svg"
    },
    ```
    La imagen vectorial **nueva** lleva por nombre _nueva.svg_, y su número de __glyphs__ respectivo es __0xe815__.
    También opcionalmente puede cambiar el __nombre de la fuente__, __copyright__, etc.

- Compilación:

    - Para realizar la compilación debemos estar en el directorio __lab__ y luego abrir la terminal en ese directorio.
    - Si usted agrega una nueva imagen vectorial, es necesario editar el archivo __metadata.json__

    Ejemplo:

    ```html
    ./svg2ttf.py metadata.json
    ```

    - La salida de este comando, nos dará como resultado los siguientes archivos:
      - libresocial.ttf
      - libresocial.odf
      - libresocial.woff
      - libresocial.svg

    - Añadimos las nuevas fuentes (libresocial.ttf, libresocial.woff y libresocial.svg) al directorio __fonts__

    - Luego..., en el caso de haber agregado una nueva imagen vectorial, modifique el archivo _libresocial.css_ localizado en el directorio __css__:

    Ejemplo:

    Agregamos la imagen vectorial llamada __nueva__.svg a nuestra lista de íconos generada en pasos anteriores.

    ```html
    .icon-nueva:before { content: '\e815'; } /* '[]' */
    ```

    Por último usted agregaría el nombre del ícono _(icon-nueva)_ al archivo _demo.html_ para testear su nuevo ícono.

    Ejemplo:

    ```html
    <a class="nueva" href="#"><i class="icon-nueva"></i></a>
    ```

    Listo. Hasta aquí ya tendría su ícono agregado a su fuente tipográfica.

## Contributor

- [heckyel](https://heckyel.ga)

## Licencia
- La fuente Libre Social esta bajo la Licencia [AGPLv3](LICENSE)