Tengo problemas para entender cómo implementar el fragmento de docsearch en mis páginas de github (estoy usando bootstrap 3 ).
De la documentación del paquete :
Una vez que haya publicado su sitio web de pkgdown, envíe la URL del sitio de pkgdown a Docsearch. HECHO
Ponga el valor de los parámetros apiKey e indexName en su sitio _pkgdown.yml. HECHO
Dada mi falta de conocimiento, ahora estoy teniendo dificultades para entender esto.
El Docsearch\Algolia me envió un correo electrónico:
CSS
Copie este fragmento al final de la etiqueta de
headHTML
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docsearch/css@alpha"/></pre></li>JavaScript
Copie este fragmento al final de la etiqueta del
bodyHTML
<script src="https://cdn.jsdelivr.net/npm/@docsearch/js@alpha"></script> <script type="text/javascript"> docsearch({ appId: xxxxxx, apiKey: xxxxxx, indexName: xxxxxx, container: '### REPLACE ME WITH A CONTAINER (eg div) ###' debug: false // Set debug to true if you want to inspect the modal }); </script>PREGUNTA: ¿Debo copiar estos fragmentos en cada página html generada por pkgdown o hay una forma automática de hacerlo?
De acuerdo con la documentación , la mejor manera de incluir HTML personalizado como este es agregarlo a su archivo _pkgdown.yml bajo estas opciones:
template: includes: in_header: <!-- inserted at the end of the head --> after_body: <!-- inserted at the end of the body -->Entonces, en tu caso, deberías hacer algo como esto:
template: include: in_header: | <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docsearch/css@alpha"/></pre></li> after_body: | <script src="https://cdn.jsdelivr.net/npm/@docsearch/js@alpha"></script> <script type="text/javascript"> docsearch({ appId: xxxxxx, apiKey: xxxxxx, indexName: xxxxxx, container: '### REPLACE ME WITH A CONTAINER (eg div) ###' debug: false // Set debug to true if you want to inspect the modal }); </script>Tenga en cuenta que esta función se agregó hace aproximadamente 4 meses, por lo que existe la posibilidad de que no funcione con Bootstrap 3 o versiones anteriores de pkgdown. Si esto no funciona, la forma antigua de hacerlo era:
pkgdown/templatesin-header.html y after-body.html en esa carpetain-header.html y su JavaScript en after-body.htmlEspero que uno de estos te funcione.