Skip to content

Commit

Permalink
add contributor list to each document
Browse files Browse the repository at this point in the history
  • Loading branch information
fiennyangeln committed Sep 25, 2018
1 parent 9b6ec5b commit c0cc79f
Show file tree
Hide file tree
Showing 3 changed files with 53 additions and 6 deletions.
35 changes: 31 additions & 4 deletions v2/lib/load/docs/metadata.js
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
const fs = require('fs-extra');
const path = require('path');
const {getSubFolder, idx, parse} = require('../utils');
const execSync = require("child_process").execSync;

function getLanguage(filepath, refDir, env) {
const translationEnabled = idx(env, ['translation', 'enabled']);
Expand Down Expand Up @@ -60,6 +61,32 @@ module.exports = async function processMetadata(
metadata.title = metadata.id;
}

/* set metadata author */
const authorRegex = /(\d+) author (.+)$/g;
const results = execSync(
`git blame --line-porcelain ${filepath} \
| grep -I "^author " | sort | uniq -c | sort -nr; \
`
).toString().split('\n');
let authorData;
const authors = [];
let totalLineCount = 0;
results.forEach(result => {
if ((authorData = authorRegex.exec(result)) !== null) {
const lineCount = parseInt(authorData[1]);
const name = authorData[2];
authors.push({
lineCount,
name,
});
totalLineCount += lineCount;
}
authorRegex.lastIndex = 0;
});

metadata.authors = authors;
metadata.totalLineCount = totalLineCount;

/* language */
const language = getLanguage(filepath, refDir, env);
metadata.language = language;
Expand All @@ -77,7 +104,7 @@ module.exports = async function processMetadata(
const versionPart =
(version && version !== latestVersion && `${version}/`) || '';

/*
/*
Convert temporarily metadata.id to the form of dirname/id without version/lang prefix
ex: file `versioned_docs/version-1.0.0/en/foo/bar.md` with id `version-1.0.0-bar` => `foo/bar`
*/
Expand Down Expand Up @@ -105,16 +132,16 @@ module.exports = async function processMetadata(
}
}

/*
/*
The docs absolute file source
e.g: `/end/docs/hello.md` or `/end/website/versioned_docs/version-1.0.0/hello.md`
e.g: `/end/docs/hello.md` or `/end/website/versioned_docs/version-1.0.0/hello.md`
*/
metadata.source = path.join(refDir, source);

/* Build the permalink */
const {baseUrl, docsUrl} = siteConfig;

/*
/*
if user has own custom permalink defined in frontmatter
e.g: :baseUrl:docsUrl/:langPart/:versionPart/endiliey/:id
*/
Expand Down
18 changes: 17 additions & 1 deletion v2/lib/theme/Docs/index.js
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,23 @@ export default class Docs extends React.Component {
</Link>
)}
</div>
<div className={styles.mainContainer}>{this.props.children}</div>
<div className={styles.mainContainer}>
{this.props.children}
{metadata &&
metadata.authors &&
metadata.totalLineCount && (
<div className={styles.authorList}>
{metadata.authors
.map(({name, lineCount}) => {
const contribution =
((lineCount / metadata.totalLineCount) * 100).toFixed(2) +
'%';
return `${name} (${contribution})`;
})
.join(', ')}
</div>
)}
</div>
</Layout>
);
}
Expand Down
6 changes: 5 additions & 1 deletion v2/lib/theme/Docs/styles.css
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,8 @@
margin-left: auto;
margin-right: auto;
justify-content: center;
}
}
.authorList {
min-width: 100%;
text-align: center;
}

0 comments on commit c0cc79f

Please sign in to comment.