{"schema":"libjg2-1", "vpath":"/git/", "avatar":"/git/avatar/", "alang":"", "gen_ut":1743401251, "reponame":"gitohashi", "desc":"Git web frontend with clientside rendering", "owner": { "name": "Andy Green", "email": "andy@warmcat.com", "md5": "c50933ca2aa61e0fe2c43d46bb6b59cb" },"url":"https://warmcat.com/repo/gitohashi", "f":3, "items": [ {"schema":"libjg2-1", "cid":"48cd4867b5781de2c6300f90270bd79c", "oid":{ "oid": "9961e6fef5f0f2458efc1c2a40d63f7cc50ebfce", "alias": [ "refs/heads/main","refs/heads/master"]},"blobname": "doc/README-build.md", "blob": "# Building gitohashi\n\n## Dependency packages\n\n\n\n - libgit2\n \n https://libgit2.org/\n\n - libwebsockets (already in distros but requires master or v3.1 +)\n \n https://libwebsockets.org/git/libwebsockets\n \nThese are both easy-to-build cmake projects like gitohashi.\n\n## Build\n\n### Step 1: install build packages\n\nDistro|Dependency Package name\n---|---\nFedora | cmake, libgit2, libgit2-devel, libarchive, libarchive-devel\nUbubtu 14.04 | cmake, libgit2-0, libgit2-dev, libarchive13, libarchive-dev\nUbuntu 16.04 | cmake, libgit2-24, libgit2-dev, libarchive13, libarchive-dev\n\n#### Note on libgit2 versions\n\nlibjsongit2 support libgit2 going back to v0.19 found in Ubuntu 14.04 and up\nto current master.\n\nBlame support requires libgit2 version \u003e\u003d0.21, but libjsongit2 adapts to\nversions older than that by gracefully disabling blame.\n\n0.28+ (and master libgit2) support `.mailmap` integration with blame, again if\nit's not available libjsongit2 blame still works without it.\n\nIf you want to build a later, local libgit2 to get these features, it is also a\ncmake project that's easy to build the same way as libjsongit2 itself.\n\nYou can direct libjsongit2 to build using your local libgit2 instead of the\npackaged version like this:\n\n```\n$ cmake .. -DJG2_GIT2_INC_PATH\u003d/usr/local/include \u005c\n -DJG2_GIT2_LIB_PATH\u003d/usr/local/lib/libgit2.so\n```\n\n### Step 2: clone, build, install\n\nOne dependent project and gitohashi need to be built, but both of them can be\nbuilt will cmake using default options simply. Libwebsockets is available\npackaged in most distros, but we need the latest version to support gitohashi.\n\nOrder|Project|Clone command\n---|---|---\n1|libwebsockets| `git clone https://libwebsockets.org/repo/libwebsockets`\n2|gitohashi| `git clone https://warmcat.com/repo/gitohashi`\n\nenter the cloned dir for each in turn and build like this:\n\n```\n$ mkdir build\n$ cd build\n$ cmake .. (for libwebsockets, `cmake .. -DLWS_FOR_GITOHASHI\u003d1`)\n$ make \u0026\u0026 sudo make install\n```\n\nNOTE1: You can configure the daemon or other project to be built with symbols using\n```\n$ cmake .. -DCMAKE_BUILD_TYPE\u003dDEBUG\n```\n\nNOTE2: If you are directly serving, HTTP/2 is advantageous performance-wise on\npages where there are a lot of avatars or other fetches going on from the same\nserver... you can enable this on libwebsockets simply with\n`cmake .. -DLWS_WITH_HTTP2\u003d1` instead of the `cmake ..` step.\n\nNOTE3: On BSD / OSX the OpenSSL is in a strange place... you need to inform\nthe gitohashi build. You can just do\n\n```\n$ export CFLAGS\u003d\u0022-I/usr/local/opt/openssl/include\u0022 \n```\n\nbefore the build.\n","s":{"c":1743401251,"u": 432}} ],"g": 1729,"chitpc": 0,"ehitpc": 0,"indexed":0 , "ab": 1, "si": 0, "db":0, "di":0, "sat":0, "lfc": "0000"}