home
login
Landing page of sorcia.
summary tree log refs contributors

path:

sorcia-website / index.html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <link rel="icon" href="/public/img/favicon.ico">
    <title>sorcia - Self-hosted software development platform with Git VCS</title>
    <link href="/public/css/style.min.css" rel="stylesheet">
</head>
<body>
    <header class="header">
        <div class="header__left">
            <a href="/" class="header__logo"></a>
        </div>
        <div class="header__right">
            <a href="https://git.nirm.al/r/sorcia" class="button button--primary">Installation</a>
        </div>
        <!-- <div class="header__right">
            <a href="/dl">downloads</a>
            <a href="/#faq">faq</a>
            <a href="/features">features & screenshots</a>
            <a href="https://git.nirm.al/r/sorcia" class="button button--primary">Installation</a>
        </div> -->
    </header>
    <main class="container">
        <div class="container__banner">
            <div class="container__banner__title">Sorcia is a self-hosted software development platform with Git VCS. Written in Go.</div>
            <div class="container__banner__license">License: <a href="https://git.nirm.al/r/sorcia/tree/master/LICENSE">MIT License</a>.</div>
            <!-- <a href="https://git.nirm.al" class="container__banner__product-image">
                <img src="/uploads/default/S1.png" width="100%" />
            </a> -->
            <div class="container__banner__info">
                <strong>NOTE:</strong> This project is in alpha and under active development, so keep a backup of your repository. That said, sorcia repository is hosted on sorcia itself.
                <a href="https://git.nirm.al/r/sorcia">You can install by following the README secion</a>.
            </div>
        </div>
        <div class="container__faq" id="faq">
            <div class="container__faq__title">faq</div>
            <div class="container__faq__item">
                <div class="container__faq__q">Why Sorcia?</div>
                <div class="container__faq__a">Initially I've started building this project for myself as I've grown kinda frustrated with the noisy interface that I've been noticing on Github or other similar softwares. I started my career as a UI designer and then moved on to web programming, so I thought I could build and design something that would only have the necessary features which I need in order to host and develop my projects. I'm sharing this publicly because who knows - someone might find this software useful.</div>
            </div>
            <div class="container__faq__item">
                <div class="container__faq__q">How is Sorcia different from other software development platforms?</div>
                <div class="container__faq__a">Sorcia is not a full-fledged software development platform. In other words, it doesn't have features like issues, pull-requests or mailing lists, CI/CD etc,. Instead, it focuses only on the minimal Git hosting service and it's associated user access control at it's best.</div>
            </div>
            <div class="container__faq__item">
                <div class="container__faq__q">How the repositories are handled?</div>
                <div class="container__faq__a">Once you have created an account after the installation, you could be able to create a repository where the path will not come under a username. Instead it will be under <pre><code>eg: yoursite.com/r/your-repository</code></pre>. And, the repositories path on your server by default would be like <pre><code>eg: /home/git/data/repositories/your-repository.git</code></pre>. So, the repository names are unique for all the users on your sorcia instance and the owner of the repository will be shown on the summary page. Only the owner of the repository can delete the respective repository on the web interface and the server/sys admin can delete it using the CLI utility <pre><code>sudo ./sorcia usermod</code></pre> which sorcia provides.</div>
            </div>
            <div class="container__faq__item">
                <div class="container__faq__q">How can I add new users into my Sorcia platform? Is there any email invite?</div>
                <div class="container__faq__a">Sorcia doesn't have any SMTP settings. Once the initial account has been created, the create new account form will disappear from the login page and only the login form will be shown. You as a first-user signed up admin can add new users by going to <pre><code>meta > users > add new user</code></pre>, where you will have to mention the username and password by yourself. So, once the user you had to invite has logged in with the credentials that you as an admin had created, you can request the user to change the password by going to their <pre><code>meta > general > your profile</code></pre>.</div>
            </div>
            <div class="container__faq__item">
                <div class="container__faq__q">How can I add a new user into my repository and what permissions are there?</div>
                <div class="container__faq__a">Users have to be existed in your sorcia instance in order to add it to your repository. The owner of the repository can add a new user into your repository by navigating to <pre><code>eg: yoursite.com/r/your-repository/meta</code></pre>. You can specify the username and select "Read" or "Read/Write" permissions for private repositories. And for public repositories, all the invited users will have "Read/Write" permissions.</div>
            </div>
            <div class="container__faq__item">
                <div class="container__faq__q">Mention the user roles in Sorcia?</div>
                <div class="container__faq__a">There is only one admin who had created an account for the first time. Rest of them are normal users. Admin can provide create repository access or not to any users.</div>
            </div>
            <div class="container__faq__item">
                <div class="container__faq__q">If an admin or normal user's login credentials are compromised, is there any resolution provided by Sorcia?</div>
                <div class="container__faq__a">As Sorcia doesn't provide any SMTP settings, only the password can be changed via the web interface. In order to change the username or delete any user - the server/sys administrator has to SSH into the server where sorcia is installed then go to the project root directory <pre><code>/home/git/sorcia</code></pre> with the root user or user with root privileges and use the command-line utility <pre><code>sudo ./sorcia usermod</code></pre>. It will prompt for the necessary detail that is needed, from which the server/sys admin can change all users' <strong>(except the admin of sorcia instance)</strong> username, password or delete the user account itself which will delete all the repositories that the user had created.</div>
            </div>
            <div class="container__faq__item">
                <div class="container__faq__q">Does it have source code highlight?</div>
                <div class="container__faq__a">Yes, Sorcia is using highlight.js and highlightjs-line-numbers.js in order to show the source code highlighted with line numbers - <a href="https://git.nirm.al/r/sorcia/tree/master/sorcia.go">https://git.nirm.al/r/sorcia/tree/master/sorcia.go</a></div>
            </div>
            <div class="container__faq__item">
                <div class="container__faq__q">Can I select a single or multiple source code lines and share the URL with others?</div>
                <div class="container__faq__a">Yes, you can do that - <a href="https://git.nirm.al/r/sorcia/tree/master/sorcia.go#L12-L15">https://git.nirm.al/r/sorcia/tree/master/sorcia.go#L12-L15</a></div>
            </div>
            <div class="container__faq__item">
                <div class="container__faq__q">Does it have multiple themes, like dark mode?!</div>
                <div class="container__faq__a">Yes, there are three different themes at the moment. Default, Classic and Dark themes. You can see this in the features page where you can see the screenshot.</div>
            </div>
            <div class="container__faq__item">
                <div class="container__faq__q">What technologies are used to build Sorcia?</div>
                <div class="container__faq__a">Backend is written in Go and SQLite3. Frontend has a very minimal vanilla javascript which is used only on few pages for source code highlight, line selection and showing different branch commit detail. And it leverages npm with gulp in order to build the SCSS into minified CSS.</div>
            </div>
            <div class="container__faq__item">
                <div class="container__faq__q">How to keep myself updated with the new releases or ask any questions related to Sorcia? And How can I contribute?</div>
                <div class="container__faq__a">
                    <p>Ask your questions on <a href="https://groups.google.com/d/forum/sorcia">sorcia@googlegroups.com</a></p>
                    <p>Subscribe to release announcements on <a href="https://groups.google.com/d/forum/sorcia-announce">sorcia-announce@googlegroups.com</a></p>
                    <p>Send patches to <a href="https://groups.google.com/d/forum/sorcia-devel">sorcia-devel@googlegroups.com</a></p>
                </div>
            </div>
        </div>
    </main>
    <footer class="footer">
        Built by <a href="https://nirm.al">someone</a> who cares.
    </footer>
</body>
</html>